Sublime 启动后 os.environ['PATH'] 无编译器路径，因其 GUI 启动不加载 shell 配置（macOS/Linux 不读 ~/.zshrc，Windows 双击继承旧环境变量）；验证需在控制台执行 import os; print(os.environ.get('PATH'))，修复须重载 launchd 环境、改 ~/.profile 或彻底重启 Sublime 进程。
Sublime 启动后 os.environ['PATH'] 里没有编译器路径？
不是 PATH 没设对，是 Sublime 根本没加载 shell 配置。macOS/Linux GUI 应用（Dock/Spotlight 启动）不读 ~/.zshrc 或 ~/.bash_profile；Windows 双击启动时继承的是登录会话的旧环境变量，改完系统 PATH 不重启 Sublime 进程就无效。
验证方法：在 Sublime 里按 Ctrl+` 打开控制台，执行 import os; print(os.environ.get('PATH'))，看输出是否含 g++ 或 python 所在目录。
- macOS：必须用
launchctl注册环境变量，或改~/Library/LaunchAgents/environment.plist并 reload - Linux：只保证
~/.profile生效，别往~/.bashrc里写 PATH - Windows：改完系统环境变量后，**必须彻底退出所有 Sublime 进程**（包括托盘），再双击启动
- 临时验证：用终端启动
subl .，它会继承当前 shell 的 PATH —— 但这只是调试手段，不代表 GUI 启动也正常
构建系统里该不该写死 cmd 中的解释器绝对路径？
应该，而且这是最稳的方案。尤其当你有多个 Python、Go 或 MinGW 版本，或者用了虚拟环境时，依赖 PATH 容易错配。Sublime 构建系统本身不继承 shell 环境变量，env 字段才是唯一可控入口。
例如 Python 构建配置：
{
"cmd": ["C:\Users\Alice\venv\Scripts\python.exe", "-u", "$file"],
"path": "C:\Users\Alice\venv\Scripts",
"env": {"PYTHONIOENCODING": "utf8"},
"selector": "source.python"
}
-
cmd必须用绝对路径，Windows 下反斜杠要双写（C:\...\python.exe） -
path字段建议和cmd中解释器所在目录一致，避免调用子命令（如pip）失败 - 不要在
env里写PYTHONPATH除非你真需要它——多数情况不需要，且容易和项目结构冲突 - Go 用户注意：
GO111MODULE=on要显式加进env，否则模块可能被忽略
中文路径下运行报 File not found 怎么办？
这不是编码问题，是 Sublime 启动阶段路径解析失败。默认情况下它把中文 URI 当作损坏字符丢弃，尤其 Windows 下双击打开时最常见。
关键配置只有两个，必须同时生效：
- 在
Preferences → Settings右侧用户设置中添加："enable_unicode_paths": true - 同步关闭：
"hot_exit": false—— 否则上次会话缓存的损坏路径会在重启后自动重开，直接报错
改完后手动删掉 %APPDATA%Sublime Text 4LocalSession.sublime_session（Windows）或对应路径下的 session 文件，否则旧缓存继续干扰。
命令行调用时，用正斜杠 + 引号最可靠：subl "D:/我的项目/main.py"，比 subl "D:我的项目main.py" 更少出错。
SublimeLinter 报 cppcheck not found 却能在终端跑通？
说明 linter 插件没走你的 shell PATH，而是用 Sublime 自己的环境启动进程。即使你终端里 which cppcheck 有输出，Sublime 构建系统也不会自动继承。
解决方式不是改系统 PATH，而是精准控制 linter 行为：
- 在 SublimeLinter 设置里，找到
cppcheck++的executable字段，填绝对路径，比如"C:\Program Files\Cppcheck\cppcheck.exe" - 如果用了自定义
env（如指定CC或CPPFLAGS），必须在 linter 配置的env字段里重复声明，不能指望全局环境 - Linux/macOS 上若 cppcheck 在
/usr/local/bin，但 Sublime 没加载，可在 linter 配置中补"path": "/usr/local/bin" - 别信“重启 Sublime 就好”——很多用户卡在这一步，其实得清掉插件缓存或重装 SublimeLinter
真正容易被忽略的是：SublimeLinter 的配置是 per-linter 的，不是全局生效。你改了 cppcheck++ 的 executable，但忘了同步改 cppcheck-c，C 文件照样报错。
