sublime text 无法直接接入 wsl，因其运行于 windows 用户态，需手动桥接路径与可执行文件；直接使用 bash "$file" 会失败，因 windows 无原生 bash 且 shell_cmd 不解析解释器；推荐用 git bash 替代，路径兼容性好、无需 chmod +x、支持空格和中文路径。
Sublime Text 不能直接“接入” WSL 环境，它始终运行在 Windows 用户态，无法自动挂载或识别 /home/username 这类路径；想让它执行 Linux 脚本、调用 gcc 或读取 WSL 文件系统里的内容，必须手动桥接——核心是让 Sublime 的构建系统或终端插件明确指向 WSL 可执行文件，并正确转换路径。
为什么直接写 bash "$file" 一定失败
Windows 原生没有 bash 命令，cmd 和 powershell 不解析 #!/bin/bash，也不支持 Bash 特有语法（如 [[ ]]、source、数组）。Sublime 的 shell_cmd 是字符串拼接后直接交给系统执行，不查 PATHEXT、不找解释器、不转义反斜杠。写 "shell_cmd": "bash \"$file\"" 会立刻报 bash: command not found 或静默无输出。
用 wsl 命令调用脚本的坑与绕过方式
WSL 路径映射规则严格：$file 是 Windows 路径（如 C:\work\test.sh），而 WSL 内部看到的是 /mnt/c/work/test.sh。手动拼 wsl -e bash -c "cd /mnt/c/... && ./test.sh" 极易出错——空格、中文路径、特殊字符都会导致命令截断或找不到文件。
- 最稳做法：把项目放在 WSL 文件系统内（如
/home/user/project），用 VS Code Remote-WSL 编辑，Sublime 只作 Windows 端轻量查看（不执行） - 若坚持用 Sublime 执行：构建系统里硬编码 WSL 路径，例如
"shell_cmd": "wsl -e bash -c \"cd /mnt/c/Users/Name/project && bash test.sh\""，但test.sh必须是固定名，不能用$file_name - 别指望
chmod +x自动生效——Windows 文件系统无执行位，WSL 下对 NTFS 挂载点的权限控制受限，脚本得显式用bash script.sh调用
推荐方案：Git Bash 替代 WSL 执行 Shell 脚本
Git Bash 启动快、路径兼容性好、自带 bash.exe，且能自动处理 Windows 路径转换。它不依赖 WSL，安装时勾选 “Add to PATH” 即可被 Sublime 直接调用。
- 确认安装路径：常见为
C:/Program Files/Git/bin/bash.exe或C:/Users/XXX/AppData/Local/Programs/Git/bin/bash.exe - 新建构建系统（
Tools → Build System → New Build System…），粘贴：
{
"shell_cmd": "C:/Program Files/Git/bin/bash.exe --cd=\"$file_path\" -c \"bash '$file_name'\"",
"selector": "source.shell",
"working_dir": "$file_path",
"encoding": "utf-8"
}
-
selector必须设为source.shell，否则 Ctrl+B 不触发 - 右下角语言模式要手动设为
Shell-Unix-Generic（Sublime 自带），别信文件头#!/bin/bash - 该配置不依赖
chmod +x，也不怕路径含空格——--cd切目录，-c执行命令，两层隔离更可靠
编辑 WSL 文件时的路径和权限现实
Sublime 打开 \wsl$\Ubuntu\home\user\project\script.sh 这类 UNC 路径，本质仍是 Windows 访问 WSL 的虚拟文件系统（9P 协议），性能差、权限混乱、git status 显示异常是常态。尤其当文件被 WSL 进程（如 npm run dev）锁定时，Sublime 可能无法保存。
- 不要把项目放
\wsl$下再用 Sublime 编辑——这是最常被忽略却最影响体验的一点 - 如果非要跨系统编辑，确保 WSL 中禁用
core.autocrlf并统一换行符为 LF，否则 Git 提交时大量 false diff - 编辑器侧建议用 VS Code + Remote-WSL，Sublime 更适合纯文本快速修改或日志查看
