sublime text 无法直接接入 wsl，因其运行于 windows 用户态，所有构建、终端、路径操作需手动桥接；shell_cmd 写 "bash \"$file\"" 必报错，因 windows 无 bash 命令且不解析 shebang；wsl 路径需用 wslpath -u 转换，chmod +x 在 ntfs 上无效；git bash 是更稳替代方案，支持自动路径转换与直接执行。
Sublime Text 不能“接入” WSL，它始终运行在 Windows 用户态，所有构建、终端、路径操作都得手动桥接——指望自动识别 /home/username 或直接执行 bash "$file" 会失败，这是根本限制。
为什么 shell_cmd 写 "bash \"$file\"" 一定报错
Windows 原生没有 bash 命令，cmd 和 powershell 不解析 #!/bin/bash，也不支持 Bash 特有语法（如 [[ ]]、source、数组）。Sublime 的 shell_cmd 是字符串拼接后直接交给系统执行，不查 PATHEXT、不找解释器、不转义反斜杠。写成 "bash \"$file\"" 会立刻报 bash: command not found 或静默无输出。
-
wsl命令虽可用，但路径映射必须手动转换：C:\work\test.sh在 WSL 中是/mnt/c/work/test.sh，硬拼wsl -e bash -c "cd /mnt/c/ && ./test.sh"极易因空格、中文路径、特殊字符导致截断或找不到文件 -
chmod +x在 Windows 文件系统上无效——NTFS 挂载点不保留执行位，WSL 下对这类文件必须显式调用bash script.sh，不能靠./script.sh - Sublime 的
${file_path}、${file_name}全是 Windows 路径格式，直接喂给wsl会出错，除非用wslpath -u转换，但构建系统不支持命令替换
构建系统里调用 WSL gcc/g++ 的实操要点
若坚持用 WSL 编译 C/C++，构建系统必须明确指向 WSL 可执行文件，并处理好路径和工作目录。
- 不要用
"cmd": ["bash", "-c", "..."]—— Windows 没bash，会失败；改用"cmd": ["wsl", "-e", "bash", "-c", "..."] -
working_dir必须设为 WSL 可识别路径，例如"working_dir": "/mnt/c/Users/Name/project"，不能填${file_path}（那是C:\...） - 编译命令中变量要转义：用
\${file_base_name}而非${file_base_name}，否则 Sublime 会提前展开成 Windows 路径，被 WSL 当作字面量 - 示例有效配置（保存为
WSLgcc.sublime-build）：{ "cmd": ["wsl", "-e", "bash", "-c", "cd /mnt/c/Users/Name/project && gcc \"${file}\" -o \"${file_base_name}\" && ./${file_base_name}"], "shell": true, "working_dir": "/mnt/c/Users/Name/project" }
比 WSL 更稳的替代方案：Git Bash
Git Bash 启动快、路径兼容性好、自带 bash.exe，且能自动处理 Windows 路径转换——它不依赖 WSL，安装时勾选 “Add to PATH” 即可被 Sublime 直接调用。
- 无需手动映射路径：
"shell_cmd": "bash \"$file\""能直接运行C:\work\test.sh，空格和中文路径都 OK - 不需要
chmod +x，脚本默认可执行 - 构建系统更简洁，例如 Shell 脚本执行：
{ "cmd": ["bash", "$file"], "shell": true, "working_dir": "$file_path" } - 如果项目含 Python/Node.js 等，Git Bash 也能调用
python或node（前提是它们在 Windows PATH 中）
真正麻烦的不是“怎么配”，而是混淆了 Sublime 的运行环境边界：它永远在 Windows 上跑，所有跨系统调用都是桥接动作。路径转换、解释器定位、权限模型这三处最容易漏掉细节，尤其当文件放在 C:\ 以外盘符或 OneDrive 同步目录时，/mnt/d/ 映射可能不稳定，这时候不如把代码放 WSL 文件系统内（如 /home/user/project），再用 VS Code Remote-WSL 编辑——Sublime 留作纯文本查看器更省心。
