nodejs 不用 electron 实现打开文件资源管理器并选择文件

前言

最近在开发一些小脚本，用 nodejs 实现。其中很多功能需要选择一个/多个文件，或者是选择一个文件夹。

最初的实现是手动输入一个目录（这个只是一个普通的终端文本输入，所以按下 tab 没有路径提示），非常的麻烦，而且很容易输错。

这种情况下网上给出的解决方案都是 electron。但是我一个小脚本用 electron 属实有点夸张了，后来转念一想可以通过 powershell 来实现类似的功能。

通过命令唤醒文件选择器

通过 cmd / prowershell 唤醒文件选择器

对 powershell 不熟悉的我唰的一声打开了 gpt，gpt 不负众望 很快给出了答案

注意这里有区别：cmd 终端中需要调用 powershell.exe
如果当前已经是在 powershell 终端的话，直接运行对应的指令即可

• 在 cmd 中运行：

powershell.exe -Command "& {Add-Type -AssemblyName System.Windows.Forms; $FileDialog = New-Object System.Windows.Forms.OpenFileDialog; $result = $FileDialog.ShowDialog(); if ($result -eq 'OK') { Write-Output $FileDialog.FileName }}"

• 在 powershell 中运行：

& {Add-Type -AssemblyName System.Windows.Forms; $FileDialog = New-Object System.Windows.Forms.OpenFileDialog; $result = $FileDialog.ShowDialog(); if ($result -eq 'OK') { Write-Output $FileDialog.FileName }}

运行效果：选择文件后终端会输出你选择的文件的全路径

在 nodejs 调用 cmd 命令

const { exec, execSync } = require('child_process')

const command = `powershell.exe -Command "& {Add-Type -AssemblyName System.Windows.Forms; $FileDialog = New-Object System.Windows.Forms.OpenFileDialog; $result = $FileDialog.ShowDialog(); if ($result -eq 'OK') { Write-Output $FileDialog.FileName }}"`

// 异步执行
exec(command, (error, file) => {
  console.log(error, file)
})

// 同步执行
const filePath = execSync(command)
console.log('选择的文件', filePath)

到这结束了吗？并没有，我选择的是一个包含中文名称的路径，输入结果如下：

几个小问题：

1. execSync 同步执行的代码返回的是 Buffer 类型
   • 可以用 filePath.toString()获取实际的路径
2. 选择的文件/文件夹包含中文，返回乱码的问题
   • 这个需要设置终端的编码类型，也就是在执行上面的命令执行先执行 chcp 650
3. 遇到执行警告：libpng warning: iCCP: cHRM chunk does not match sRGB
   • 卸载 QQ 拼音 😃 （虽然我也不知道具体是哪里的问题，不过确实是 QQ 拼音引起的）

调整后执行效果如下：

如何实现多选文件 / 选择文件夹？

• 选择目录

# 加载 Windows.Forms 程序集
Add-Type -AssemblyName System.Windows.Forms

# 创建 FolderBrowserDialog 对象
$folderDialog = New-Object System.Windows.Forms.FolderBrowserDialog

# 设置对话框的属性
$folderDialog.Description = "请选择文件夹"
$folderDialog.RootFolder = [System.Environment+SpecialFolder]::MyComputer

# 显示文件夹选择对话框
$result = $folderDialog.ShowDialog()

# 检查用户是否点击了 "确定" 按钮
if ($result -eq [System.Windows.Forms.DialogResult]::OK) {
    # 输出所选文件夹的路径
    Write-Output $folderDialog.SelectedPath
} else {
    # 用户取消选择，这里输出空路径
    Write-Output ""
}

合并成一行代码则是：

• cmd 执行：

powershell.exe -Command "& {Add-Type -AssemblyName System.Windows.Forms; $folderDialog = New-Object System.Windows.Forms.FolderBrowserDialog; $folderDialog.Description = '请选择文件夹'; $folderDialog.RootFolder = [System.Environment+SpecialFolder]::MyComputer; $result = $folderDialog.ShowDialog(); if ($result -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $folderDialog.SelectedPath } else { Write-Output '' }}"

多选文件同理：

# 加载 Windows.Forms 程序集
Add-Type -AssemblyName System.Windows.Forms

# 创建 OpenFileDialog 对象
$fileDialog = New-Object System.Windows.Forms.OpenFileDialog

# 设置对话框的属性
$fileDialog.Multiselect = $true
$fileDialog.Title = "请选择文件"
$fileDialog.Filter = "All Files (*.*)|*.*"

# 显示文件选择对话框
$result = $fileDialog.ShowDialog()

# 检查用户是否点击了 "确定" 按钮
if ($result -eq [System.Windows.Forms.DialogResult]::OK) {
    # 输出所选文件的路径（数组）
    Write-Output $fileDialog.FileNames
} else {
    # 用户取消选择
    Write-Output ""
}

合并为一行命令：

powershell.exe -Command "& {Add-Type -AssemblyName System.Windows.Forms; $fileDialog = New-Object System.Windows.Forms.OpenFileDialog; $fileDialog.Multiselect = $true; $fileDialog.Title = '请选择文件'; $fileDialog.Filter = 'All Files (*.*)|*.*'; $result = $fileDialog.ShowDialog(); if ($result -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $fileDialog.FileNames } else { Write-Output '' }}"

一些细节

• 如果是选择单个文件/选择文件目录。输出的结果会包含一些前后空格和换行，所以需要通过 filePath.trim() 处理一下多余的字符
• 如果是多选的文件，返回的是字符串，每个文件以换行隔开的，也是需要自行处理
• 眼尖的朋友可能发现了在多选的命令中有一段代码：$fileDialog.Filter = "All Files (*.*)|*.*" 可以用于设置可选择的文件类型的。
  对应的是这个功能：
  
  就不再细说了~ 自行摸索

MacOS 如何实现用命令打开选择器

以下的命令完全来自 GPT，并没有经过测试。自行判断代码是否正常运行 (原谅我并没有 mac)

• 选择一个文件

osascript -e 'POSIX path of (choose file with prompt "请选择一个文件")'

• 选择一个目录

osascript -e 'POSIX path of (choose folder with prompt "请选择一个目录")'

• 选择多个文件
  （略）gpt 给出的答案非常的长，而且我没电脑试验，所以就不放代码了，有试验过的可以告诉我补充一下~

最后

至此，我的小脚本使用体验已经拉满，再也不用一个个输入文件路径了。

总结下所有用到的命令：

• Windows

  • 选择单个文件

    powershell.exe -Command "& {Add-Type -AssemblyName System.Windows.Forms; $FileDialog = New-Object System.Windows.Forms.OpenFileDialog; $result = $FileDialog.ShowDialog(); if ($result -eq 'OK') { Write-Output $FileDialog.FileName }}"
  

  • 选择文件目录

  powershell.exe -Command "& {Add-Type -AssemblyName System.Windows.Forms; $folderDialog = New-Object System.Windows.Forms.FolderBrowserDialog; $folderDialog.Description = '请选择文件夹'; $folderDialog.RootFolder = [System.Environment+SpecialFolder]::MyComputer; $result = $folderDialog.ShowDialog(); if ($result -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $folderDialog.SelectedPath } else { Write-Output '' }}"
  

  • 选择多个文件

  powershell.exe -Command "& {Add-Type -AssemblyName System.Windows.Forms; $fileDialog = New-Object System.Windows.Forms.OpenFileDialog; $fileDialog.Multiselect = $true; $fileDialog.Title = '请选择文件'; $fileDialog.Filter = 'All Files (*.*)|*.*'; $result = $fileDialog.ShowDialog(); if ($result -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $fileDialog.FileNames } else { Write-Output '' }}"
  

• MacOS

  • 选择一个文件

  osascript -e 'POSIX path of (choose file with prompt "请选择一个文件")'
  

  • 选择一个目录

  osascript -e 'POSIX path of (choose folder with prompt "请选择一个目录")'
  

  • 选择多个文件
  • 略

完 ~