Windows 桌面收到一个 .sh 脚本很多人第一反应是开终端、敲cd /mnt/c/...、再bash xxx.sh。脚本少还好一天要来回跑十几个临时脚本时光是路径转换就够烦。我之前也试过给 .sh 配置文件关联双击交给 WSL 执行但 Windows 的文件关联机制对.sh这种文本文件非常不友好一不小心就被记事本抢走。后来我换了思路既然 Windows 的图形界面天然支持“拖放”那我为什么不做一个专门接收拖放的桥接工具把 .sh 脚本拖上去自动转成 WSL 路径自动用 bash 执行连参数都能一起拖过去。这个工具本身不复杂甚至一个 bat 文件就能搞定但里面的思路和坑位非常典型值得完整拆一遍。今天这篇文章就从头到尾记录这套做法适合在 Windows 10/11 上使用 WSL、又经常要跑 shell 脚本的人参考。1. 核心场景与设计思路Windows、WSL 和 sh 脚本之间缺一座桥1.1 “拖拽运行”的底层交互是什么Windows 的拖放交互本质上是 Shell 把一个文件列表作为命令行参数传递给接收拖放的目标程序。比如你把一个文件拖到某个.exe图标上系统就会把这个文件的完整路径作为参数传给它。.cmd和.bat这类批处理天然支持这个行为所以用批处理做拖放接收器几乎是零成本。很多人误解“拖到图标上”只能整文件拖其实 Windows 支持同时拖多个文件。你把三个文件一起拖到同一个批处理图标上批处理里拿到的就是三个带引号的绝对路径参数。这一点特别适合我们后续的方案。我在设计这个桥接工具时刻意没有考虑做一个完整的 GUI 程序因为对大多数场景来说一个能接收拖放、能调 WSL 执行脚本的批处理已经够用。真正要解决的是路径转换、多文件参数、异常回显这三件事。1.2 为什么不直接双击 .sh把.sh文件直接放到 WSL 里执行Windows 默认做不到。双击.sh系统会按纯文本文件处理可能用记事本打开也可能弹出一个让你选择打开方式的对话框。这是因为 Windows 的可执行文件关联机制只认.exe、.bat、.cmd、.ps1这一类东西.sh只是一个文本扩展名。就算你手动把.sh关联到wsl.exe双击后大概率也会遇到两个新问题一是 WSL 收到的参数是 Windows 格式的路径bash 不一定认得二是 Windows 记事本或 IDE 保存过的脚本往往带 CRLF 换行符bash 直接执行会报$\r: command not found。这两个问题单独拿出来都不难解决但混在一起就会劝退很多人。所以我们要做的不是“改关联”而是搭一座桥在 Windows 这边接收拖放把路径转成 WSL 能认的格式再选择合适的解释器去执行。1.3 桥接工具的三个硬性要求第一版工具我只要求做到三件事接收一个或多个文件的拖放从拖入的文件里找到.sh脚本自动完成 Windows 路径到 WSL 路径的转换然后执行。这三个要求看着简单实际实现时每一步都有细节。比如路径里有空格、文件名里有中文、WSL 默认发行版不对、脚本需要带参数运行。所以方案不是一步到位的我会把几个版本的演进过程都写出来你可以根据自己的需求挑一个用。2. 最省事的桥一个 bat 文件扛起所有拖放运行2.1 直接能用的代码新建一个文本文件命名为run-in-wsl.bat注意扩展名必须是.bat然后右键编辑把下面这份代码粘进去保存echo off setlocal enabledelayedexpansion set WSL_UTF81 if %~1 ( echo 把 .sh 文件拖到本图标上即可运行。 echo 也可以同时拖脚本.sh 参数1 参数2 pause exit /b ) set script for %%f in (%*) do ( if not defined script ( if /I %%~xf.sh set script%%~f ) ) if not defined script ( echo 没有检测到 .sh 脚本。 pause exit /b ) set args for %%f in (%*) do ( if /I not %%~ff!script! set args!args! %%~f ) for /f delims %%p in (wsl wslpath -a !script!) do set script_wsl%%p set args_wsl for %%f in (!args!) do ( for /f delims %%p in (wsl wslpath -a %%~f 2^nul) do set args_wsl!args_wsl! %%p ) echo echo 脚本(Windows): !script! echo 脚本(WSL) : !script_wsl! if defined args_wsl echo 参数(WSL) : !args_wsl! echo wsl bash !script_wsl! !args_wsl! set ec!errorlevel! echo. echo 退出码: !ec! pause exit /b !ec!把run-in-wsl.bat放到一个固定目录比如C:\Tools\。之后你从资源管理器里拖一个.sh文件到这个 bat 文件图标上释放WSL 就会自动把它跑起来。2.2 每一段在干什么脚本开头先检测是否有拖入文件如果没有就给出提示避免误双击时窗口一闪而过。然后第一遍for循环遍历所有拖入的文件找出第一个扩展名为.sh的文件作为目标脚本。这个顺序很重要它保证了你同时拖入脚本和参数文件时脚本一定能被识别。第二遍for循环把除脚本外的其他文件都收集到args变量里作为后续传给脚本的参数。接下来两个for /f是关键它们调用wsl wslpath -a把 Windows 路径转成 WSL 路径比如C:\Users\tom\test.sh会变成/mnt/c/Users/tom/test.sh。转换完成后用wsl bash script_wsl args_wsl执行。执行的时候我没有用./script.sh而是用bash script.sh。这样有一个隐含好处即使脚本文件落在 Windows 文件系统上没有执行权限也能正常运行。这个我们在后面第 5 节详细讲。2.3 使用时的三个注意点第一个注意点是编码。bat文件里有中文提示如果保存成 UTF-8 没有 BOM在部分 Windows 系统上会乱码。我的建议是注释和提示尽量用英文避免编码问题干扰判断。如果你一定要用中文就保存成 ANSI也就是 GBK编码。第二个注意点是 WSL 默认发行版。如果机器上装了多个发行版wsl bash会用默认发行版执行。想指定发行版可以在执行命令前加一个变量比如set WSL_DISTROUbuntu-24.04 wsl -d %WSL_DISTRO% bash !script_wsl! !args_wsl!第三个注意点是拖入的路径本身。只要资源管理器能正常拖拽路径里有空格通常没有问题因为路径会被引号包裹。真正要小心的是如果脚本文件本身依赖相对路径比如脚本里写了./config.ini执行时的工作目录并不一定是脚本所在目录最好在脚本开头加一句cd $(dirname $0)或者我可以在这套桥接工具里把工作目录固定到脚本目录。3. 把“文件”拖给脚本当参数而不是只拖脚本本身3.1 脚本参数怎么区分很多人用 WSL 跑脚本不只是想执行脚本本身更想把 Windows 里的文件拖进去当参数。比如我有一个resize.sh想传入一张图片路径输出压缩后的图片。最自然的操作就是选中脚本和图片一起拖到桥接工具上让脚本拿到图片路径作为参数。代码里通过两次循环做了策略区分第一个.sh文件是目标脚本其余所有文件都作为参数。这样拖入resize.sh a.jpg b.jpg实际执行的是bash /mnt/c/.../resize.sh /mnt/c/.../a.jpg /mnt/c/.../b.jpg。这样设计的好处是符合大多数人的操作习惯脚本是命令其他文件是输入。如果你有多个.sh需要按顺序执行更合适的做法是写一个调度脚本而不是一次性拖多个脚本进去。3.2 实战演示现在我模拟一个实际操作。在桌面准备两个文件test.sh内容只有一行echo hello $1input.txt。把这两个文件一起拖到run-in-wsl.bat上释放批处理窗口会显示类似下面的信息 脚本(Windows): C:\Users\tom\Desktop\test.sh 脚本(WSL) : /mnt/c/Users/tom/Desktop/test.sh 参数(WSL) : /mnt/c/Users/tom/Desktop/input.txt hello /mnt/c/Users/tom/Desktop/input.txt 退出码: 0这个输出意味着路径转换成功参数也正确传入了脚本。整个过程中你不需要手动敲任何一个路径。3.3 边界情况这里要提醒一个容易踩的坑拖放多个文件时Windows 传给批处理的参数有长度限制大约是 8191 字节左右。如果文件路径特别长或者文件数量特别多后面的参数可能被截断。日常使用影响不大但如果你要批量处理上百个文件建议还是写一个真正的 GUI 拖放工具或者改用文件夹路径作为参数。还有一个细节是路径里带或^这类特殊字符时批处理的for解析偶尔会出问题。我实测下来只要路径整体被引号包住大多数情况没问题但特殊字符过多时还是会翻车。如果你经常处理文件名带各种符号的文件可以直接跳到第 4 节的 PowerShell 方案。4. 进阶用法PowerShell 写一个图形拖放区4.1 拖放区代码批处理方案最大的问题是执行时黑窗口一闪而过视觉效果不佳也不方便查看历史输出。如果你希望有一个固定的“拖放区域”把文件拖进一个窗口里运行可以用 PowerShell 加 WinForms 写一个几十行的迷你工具。新建一个文件DropZone.ps1把下面代码粘贴进去Add-Type -AssemblyName System.Windows.Forms Add-Type -AssemblyName System.Drawing $form New-Object System.Windows.Forms.Form $form.Text WSL Sh 拖放运行 $form.Size New-Object System.Drawing.Size(640, 420) $form.StartPosition CenterScreen $form.AllowDrop $true $box New-Object System.Windows.Forms.TextBox $box.Multiline $true $box.ScrollBars Vertical $box.Dock Fill $box.Font New-Object System.Drawing.Font(Consolas, 10) $form.Controls.Add($box) $form.Add_DragEnter({ param($sender, $e) if ($e.Data.GetDataPresent([System.Windows.Forms.DataFormats]::FileDrop)) { $e.Effect [System.Windows.Forms.DragDropEffects]::Copy } }) $form.Add_DragDrop({ param($sender, $e) $files $e.Data.GetData([System.Windows.Forms.DataFormats]::FileDrop) foreach ($f in $files) { $box.AppendText(收到: $frn) } $script $files | Where-Object { $_.EndsWith(.sh) } | Select-Object -First 1 if ($null -eq $script) { $box.AppendText(没有 .sh 脚本。rn) return } $scriptWsl ( wsl wslpath -a $script 2$null | Out-String).Trim() $box.AppendText(执行: $scriptWslrn) $output wsl bash $scriptWsl 21 | Out-String $box.AppendText($output) $box.AppendText(退出码: $LASTEXITCODErn) }) [System.Windows.Forms.Application]::Run($form)再写一个start-dropzone.bat作为启动入口echo off powershell -NoProfile -ExecutionPolicy Bypass -File %~dp0DropZone.ps1把这两个文件放在同一个目录里以后双击start-dropzone.bat就会弹出一个小窗口这个窗口就是“拖放区”。4.2 启动与交互窗口启动后把任意文件直接拖进窗口里释放它会在文本框里显示收到的文件列表、转换后的 WSL 路径以及脚本执行的标准输出。输出会一直留在窗口里方便你回溯。因为 PowerShell 脚本接收的是对象数组而不是批处理的字符串参数所以它对特殊字符、中文路径、多文件的兼容性比批处理好很多。实测拖入几十个文件也不会轻易出现参数截断的问题。如果你追求更极致的体验可以把这个start-dropzone.bat的快捷方式固定到任务栏拖文件到任务栏图标上不一定能触发 drop target还要配合额外的启动参数所以日常还是打开窗口再拖更可靠。我这里单独提一句免得你花时间折腾任务栏固定后却发现拖放无效。4.3 什么时候值得升级成它我的判断标准很简单如果你只是偶尔跑一两个临时脚本方案一的 bat 完全够用如果你每天都在处理脚本和文件、需要反复看日志那就值得花五分钟把 DropZone 建起来。它还能顺带解决一个批处理不好解决的需求——拖入多个不同类型的文件自己决定哪个是脚本、哪些是参数逻辑都在 PowerShell 里写灵活度完全不在一个量级。5. 绕不开的环境原理路径、换行符、执行权限5.1 wslpath路径互转的正确姿势很多新手在 Windows 里调用 WSL 时会直接传C:\Users\tom\test.sh这样的路径给bash结果自然是找不到文件或者报奇怪的解析错误。Windows 路径和 Linux 路径是两套体系wsl.exe虽然能接收 Windows 路径作为启动参数但一旦进入 bash 解析环节路径就必须是 Unix 风格。wslpath是 WSL 自带的路径转换工具。常用三种用法wslpath -a C:\path\to\file把 Windows 绝对路径转成 WSL 绝对路径wslpath -u转成 Unix 风格路径wslpath -w转成 Windows 风格路径。在 Windows 的 cmd 或 bat 里调用时要写成wsl wslpath -a C:\...。它输出的结果可以直接拼接进wsl bash参数里。注意一个小细节如果路径里有空格转换结果本身不会带引号所以在拼接参数时一定要手动给转换结果加引号否则进入 bash 后路径会被空格拦腰切断。5.2 CRLF 换行符最常见的翻车现场Windows 下的文本文件默认使用\r\n作为行结束符Linux 下则是\n。如果脚本在 Windows 里用记事本编辑过保存后常常是 CRLF 格式直接拖进 WSL 执行bash 会把行尾的\r当成命令的一部分报$\r: command not found或者出现莫名其妙的语法错误。解决方式写在前面如果真的遇到这个问题先手动转换一次再执行wsl bash -c sed -i s/\r$// /mnt/c/Users/tom/test.shsed -i会直接修改原文件把行尾的 CR 去掉。执行一次后文件就变成 LF 格式后续怎么拖都没问题。如果你不想改动原始脚本也可以在执行时用sed生成临时文件再运行但临时文件会留在 Windows 目录里容易造成混淆所以我不太推荐。5.3 执行权限与 /mnt 挂载Windows 文件在 WSL 里的挂载目录是/mnt/c、/mnt/d等。默认情况下这些挂载点不启用 metadata 选项Windows 文件在 WSL 里是不可执行的也就是没有x权限。如果你在 WSL 里执行./test.sh大概率会得到Permission denied。我们的桥接工具从设计上绕开了这个问题始终用bash script.sh而不是./script.sh。因为bash只需要有读取权限就能解释执行脚本不需要脚本本身带执行位。这也是为什么整个方案里不需要你手动chmod x。但如果你的脚本内部还会调用其他脚本并且默认依赖可执行位那就要注意了建议在脚本里统一用bash other.sh调用子脚本。如果你确实希望/mnt/c下的文件自动继承可执行位可以在 WSL 里编辑/etc/wsl.conf[automount] enabled true options metadata,umask22然后重启 WSL。这样设置后Windows 文件会保留权限元数据但也要注意它带来的安全副作用毕竟自动加执行权限不一定是你想要的行为。5.4 多发行版如何指定WSL 支持同时安装多个 Linux 发行版默认执行wsl bash时用的是默认发行版。如果你装了 Ubuntu、Debian、Kali 多个发行版脚本可能在 Ubuntu 里能跑在 Debian 里缺依赖就会很头大。我在方案一里特意留了这个扩展点使用wsl -d指定发行版例如wsl -d Ubuntu-24.04 bash script.sh。你可以先运行wsl -l -v查看自己的发行版名称然后把它写进 bat 顶部的变量里。这样即使默认发行版变了工具的行为也不会跟着漂移。6. 把工具接到右键菜单和“发送到”提升使用效率6.1 发送到拖放虽然方便但每次都要从资源管理器里找到run-in-wsl.bat这个文件再拖上去路径长的时候也挺麻烦。一个更顺手的接入点是 Windows 的“发送到”菜单。按下Win R输入shell:sendto回车会打开发送到文件夹。把run-in-wsl.bat的快捷方式放进去。之后你选中任意.sh文件右键 → 发送到 → run-in-wsl效果和拖放基本一样而且你可以在任意目录操作不用先找到工具本体。这个方式的本质其实还是“把文件路径作为参数传给 bat”所以方案一的代码不用改一个字只要 bat 能力够强发送到就能直接复用。如果你的参数文件比较多还可以先选中脚本和多个文件再一起发送。6.2 右键菜单注册发送到还是多了一步右键如果你想让“用 WSL 运行”直接出现在.sh文件的右键菜单里可以借助注册表。准备工作做在前面请先备份注册表或者至少对将要修改的键有把握。下面是一个示例把.sh文件关联到一个自定义类型然后在这个类型上添加菜单项reg add HKCU\Software\Classes\.sh /ve /t REG_SZ /d wsl.sh.script /f reg add HKCU\Software\Classes\wsl.sh.script\shell\Run with WSL\command /ve /t REG_SZ /d \C:\Tools\run-in-wsl.bat\ \%1\ /f第一行把.sh扩展名指向虚拟类型wsl.sh.script第二行在这个类型的右键菜单里添加“Run with WSL”命令。执行后右键任意.sh文件就会多出一个菜单项点击直接通过我们的桥接工具运行。但我不建议所有人都这么干。因为改注册表涉及文件关联一旦某个键写错可能导致.sh文件双击行为异常。如果你不熟悉注册表用发送到的方案就够了。6.3 其它入口还有一个思路是配合 Windows Terminal。如果你经常在 WSL 里手动操作可以在 Windows Terminal 的配置文件里加一个 profile固定打开我们的 DropZone或者直接从终端里调用这个桥接工具。这样你在终端里敲一行命令也能达到拖放的效果。说白了入口可以有很多核心始终是一个把 Windows 文件路径收集起来路径转换再用 WSL 执行。入口只是用户体验的最后一环没必要为了入口折腾太多。7. 常见问题排查与避坑记录7.1 问题速查表我把实际使用中遇到的高频问题整理成了一个表方便你对照排查。现象原因解决办法拖到 bat 上没有任何反应窗口一闪而过没有拖到 bat 图标上或者误拖到了.sh文件本身上确认拖放目标是run-in-wsl.bat在 bat 中加pause防止闪退提示wsl不是内部或外部命令系统没有安装 WSL或wsl.exe不在 PATH先运行wsl --install安装 WSL提示bash: /mnt/c/...: No such file or directory路径转换失败或文件名大小写不对确认是使用wslpath -a转换后的结果检查盘符大小写脚本报$\r: command not found脚本换行符是 CRLF用sed -i s/\r$// 脚本转换一次提示Permission denied直接执行了没有执行权限的脚本用bash script.sh而不是./script.sh弹窗报“没有 .sh 脚本”拖入的文件里没有.sh文件确认第一个脚本扩展名或者文件名不以大写.SH混淆执行时用了错误的 Linux 发行版系统有多个 WSL 发行版默认发行版不是想要的在 bat 中增加wsl -d 发行版名 bash ...中文路径输出乱码控制台编码不匹配在 bat 开头设置set WSL_UTF81拖入多个文件顺序不对Windows 传递参数的顺序可能与视觉选择顺序不一致在工具里增加文件列表输出确认实际顺序7.2 调试三板斧如果你遇到问题不太确定原因先按这三步走。第一步直接在 cmd 里手动跑一下脚本看有没有基本错误第二步在 bat 里临时去掉echo off让它回显每一条命令能看到实际执行的完整命令行第三步把wsl bash改成wsl bash -x script.sh让 bash 打印每个执行步骤。做了这三步几乎所有问题都能定位到具体命令或者路径上。我个人最大的经验是先确认路径转换输出是否符合预期再排查执行阶段的问题。因为 Windows 和 WSL 的路径差异太容易出错了路径对了至少成功了一半。7.3 我的工作流建议用了这套拖放方案一段时间后我最后把入口固定在两个地方一个是桌面上的run-in-wsl.bat快捷方式专门应付临时脚本另一个是 DropZone 窗口留给需要反复跑、要看日志的脚本。日常操作已经彻底不用在 Windows 里敲cd /mnt/c/...了。最后分享一个小技巧在 bat 里我加了set WSL_UTF81这个环境变量可以让 WSL 的输出按照 UTF-8 编码展示对中文输出很友好。我第一次遇到中文乱码时排查了很久最后发现只是少设置了这一个变量。很多东西看着不起眼但实际体验差异特别大。这套拖放方案整体不复杂难的是把每个细节都处理到位希望这篇文章能帮你一次性避开我踩过的坑。