根本原因是Windows与Linux路径体系不互通且PATH和工作目录未对齐，需从WSL路径映射、Sublime构建系统及文件存放位置三处解决：优先将项目放WSL原生路径（如/home/yourname/project/），启用/etc/wsl.conf中[automount] enabled=true，用wslpath -u转换路径，并配置WSL的PATH以识别subl命令。
Sublime Text 在 WSL 环境下无法正确解析路径，根本原因不是 Sublime 本身的问题，而是 Windows 和 Linux 路径体系不互通 + PATH 和工作目录未对齐导致的。直接改 Sublime 设置没用，得从 WSL 路径映射、Sublime 构建系统、以及文件存放位置三处动手。
WSL 路径翻译失败时，wsl 命令执行报错“no such file or directory”
这是最常见现象：你在 Sublime 里配置了 "cmd": ["wsl", "python", "$file_name"]，但实际运行时报错说找不到文件，哪怕 $file_name 显示的是 /mnt/c/Users/xxx/test.py —— 问题出在 WSL 内部对 /mnt/c/... 路径的访问权限或挂载状态不稳定。
- 优先把项目文件放在 WSL 原生路径下（如
/home/yourname/project/），而不是/mnt/c/...；跨文件系统调用性能差，且容易触发路径翻译异常 - 确认 WSL 已启用自动挂载：检查
/etc/wsl.conf是否含[automount]和enabled = true，否则/mnt/c可能根本不存在 - 不要依赖
$file_path直接传给wsl；它返回的是 Windows 路径（如C:project），而wsl命令收到后不会自动转成/mnt/c/project，必须显式转换 - 稳妥做法是用
"shell_cmd": "wsl bash -c 'cd /home/yourname/project && python "$1"' -- "$file""，把路径控制权交给 WSL 内部
subl 命令在 WSL 终端里打不开 Sublime，提示“command not found”
WSL 默认不继承 Windows 的 PATH，所以即使你装了 Sublime 并注册了 subl，WSL 也找不到它。
- 手动把 Windows 下 Sublime 的安装路径加进 WSL 的
PATH：编辑~/.zshrc或~/.bashrc，添加类似这行：export PATH="/mnt/c/Users/xxx/AppData/Local/Sublime Text/Build 4143/:$PATH" - 路径中的
Build 4143是具体版本号，需替换成你本地 Sublime 安装目录的实际子文件夹名（打开 Windows 文件资源管理器看） - 改完记得
source ~/.zshrc，然后验证：which subl应该输出路径，subl --help不报错才算生效 - 注意：不要用
sudo运行subl，会导致 GUI 权限异常，打开空白窗口或崩溃
构建系统里用 wsl 调 Python/GCC，但中文路径乱码或报错
Windows 文件名编码（GBK/UTF-8 with BOM）和 WSL 默认 UTF-8 不一致，尤其当文件路径含中文时，wsl 收到的参数会解码失败。
- 强制 WSL 使用 UTF-8：在
/etc/wsl.conf中添加[boot]段并写入command = "export LANG=en_US.UTF-8; export LC_ALL=en_US.UTF-8" - 构建系统中避免直接拼接路径变量；改用
shell_cmd+bash -c封装，让 WSL 自己处理字符串："shell_cmd": "wsl bash -c 'cd $(wslpath -u "$file_path") && python "$1"' -- "$file_name"" -
wslpath -u是关键：它能把C:xxx est.py转成/mnt/c/xxx/test.py，比手写/mnt/c/...更可靠 - 如果仍乱码，临时方案是把项目移到纯英文路径下测试，确认是否为编码问题
想让 Sublime 直接打开 WSL 里的文件，但双击只在 Windows 路径下新建空文件
这不是 Sublime 的 bug，而是 Windows 资源管理器和 WSL 路径协议不兼容：你右键 → “Open with Sublime Text”，系统按 Windows 规则解析路径，不会自动跳转到 \wsl$Ubuntuhome...。
- 真正有效的做法是：在 WSL 终端里用
subl /home/yourname/project/file.py，前提是subl已正确配置并可被 WSL 找到 - 别依赖 Windows 文件资源管理器的“打开方式”菜单操作 WSL 文件；
\wsl$...是网络共享路径，Sublime 不原生支持该协议 - 若坚持用图形界面，可创建快捷方式指向
explorer.exe \wsl$Ubuntuhomeyournameproject，再从资源管理器里拖文件进 Sublime 窗口（此时 Sublime 会以 WSL 路径打开） - 注意：
\wsl$...路径在 PowerShell/CMD 中可用，但在某些老旧 Sublime 插件（如 SideBarEnhancements）里可能识别失败
最易被忽略的一点：所有路径转换逻辑都依赖 WSL 实例处于运行状态。如果 WSL 已 shutdown（wsl --shutdown 后），wslpath、wsl 命令会卡住或报错，但 Sublime 构建系统不会主动提示——它只会静默失败。建议日常开发保持 WSL 后台运行，或在构建命令前加 wsl -t Ubuntu && 类似健康检查。
