Sublime Text构建系统默认不继承终端export的PATH，GUI启动只读系统级环境变量；需用import os; print(os.environ.get('PATH'))验证，并优先在cmd数组中写死编译器绝对路径。
Sublime Text 构建系统默认不继承你在终端里 export PATH= 设置的环境变量，也不是“配置写错了”，而是它压根没读到——GUI 启动时只加载系统级 PATH，~/.zshrc、~/.bash_profile 或 Windows 的用户变量临时修改全无效。
为什么 which g++ 成功但 Sublime 报 command not found
这是最典型的症状：终端能跑，Sublime 按 Ctrl+B 就崩。根本原因不是构建系统 JSON 写得不对，而是 Sublime 启动时的环境变量快照里根本没有你加的编译器路径。
- macOS/Linux：图形界面启动（Spotlight/Dock）的 Sublime 不会执行 shell 配置文件，
which g++在终端有效 ≠ Sublime 能看到 - Windows：双击图标启动时只读「系统变量」里的
Path，「用户变量」里加的路径可能被忽略（尤其多账户或权限受限时） - 验证方式：在 Sublime 里按
Ctrl+`打开 Python 控制台，运行import os; print(os.environ.get('PATH'))，对比终端输出，差在哪一目了然
cmd 数组里该用绝对路径还是命令名
优先用绝对路径，尤其当构建系统要跨机器、给他人共享，或你用了非标准安装（如 Homebrew GCC、SDKMAN 管理的 Java）时。
- Linux/macOS：运行
which g++或which scala，拿到类似/opt/homebrew/bin/g++-14的结果，直接填进"cmd"数组：["/opt/homebrew/bin/g++-14", "${file}", "-o", "${file_base_name}"] - Windows：用正斜杠，别写反斜杠：
["C:/msys64/mingw64/bin/g++.exe", "${file}"]，写成"C:\msys64\..."会被 JSON 解析器截断 - 如果坚持用命令名（如
"g++"），必须确保该命令在系统级 PATH 中——Windows 去「系统属性 → 高级 → 环境变量」改「系统变量」的Path；macOS/Linux 改/etc/paths或确保 GUI 启动前已通过launchctl setenv PATH ...注入（较麻烦）
shell_cmd 和带 "shell": true 的 cmd 怎么选
二者本质都是走 shell，但行为差异明显，错配会导致 && 失效、空格路径崩溃、甚至静默失败。
-
shell_cmd是字符串，天然支持&&、|、变量展开，但需手动处理空格："shell_cmd": "g++ '${file}' -o '${file_base_name}' && ./${file_base_name}"（单引号包裹${file}防空格） -
cmd数组 +"shell": true更安全：数组本身规避了 shell 解析歧义，"shell": true显式启用 shell 解释，让&&生效；Windows 下它强制走 CMD，避免 PowerShell 用;分隔导致编译后不运行 - 别混用：写了
"shell_cmd"就别再加"shell": true；写了"cmd"数组又漏掉"shell": true，&&就只是字面量，不会触发后续命令
如何让构建系统读到你的虚拟环境或自定义 PYTHONPATH
构建系统不 source 你的 shell 配置，所以 venv 激活状态、export PYTHONPATH=... 全部失效。不能靠“先激活再开 Sublime”这种操作。
- Python 场景：把虚拟环境里的解释器路径硬编码进
cmd，例如["/path/to/myproject/.venv/bin/python", "-u", "$file"]；Anaconda 插件也得在 Settings – User 里明确填"python_interpreter" - 通用环境变量：用
"env"字段注入，比如需要LD_LIBRARY_PATH或JAVA_HOME："env": {"JAVA_HOME": "/usr/lib/jvm/java-17-openjdk-amd64"}，注意值必须是字符串，不能引用 shell 变量 - 不要试图在
shell_cmd里写source venv/bin/activate && python ...——source是 shell 内置命令，子 shell 退出后环境即丢，实际无效
真正卡住人的从来不是 JSON 语法，而是环境变量的加载时机和作用域——GUI 启动、shell 初始化、子进程继承，这三层隔离必须一层层捅破，否则改十次构建系统都白搭。
