Sublime Text 配置编译环境的核心是正确设置构建系统文件（.sublime-build），关键在于解决环境变量继承、shell_cmd/cmd 选择、file_regex 精确匹配及 working_dir 路径设定四大问题。
Sublime Text 本身不带任何编译器，所谓“配置编译环境”，本质是告诉它：用哪个命令、在哪儿执行、怎么解析错误。跳过验证环节直接写 .sublime-build，90% 的失败都源于此。
先确认编译器是否真能被 Sublime 调用
终端里 g++ --version 成功 ≠ Sublime 里能调用 g++。GUI 启动的 Sublime 不继承 shell 的 PATH，尤其 macOS/Linux 下从 Dock 或 Spotlight 打开时，which g++ 在 Sublime 进程内可能为空。
- macOS/Linux：必须用终端运行
open -a "Sublime Text"启动，才能继承当前 shell 环境 - Windows：改完系统环境变量
Path后，要彻底退出所有 Sublime 进程（任务管理器 → 结束subl.exe或Sublime Text.exe），再重开 - 验证方式：新建一个
.cpp文件，按Ctrl+Shift+P→ 输入Build With...→ 如果列表里没出现你期望的构建系统，说明插件或路径根本没加载
shell_cmd 和 cmd 数组怎么选
shell_cmd 是字符串，走 shell 解析；cmd 是数组，Sublime 原生执行。两者行为差异直接影响路径空格、&&、变量展开是否生效。
- Windows 用户优先用
shell_cmd：避免cmd数组中路径含空格时报错，且&&可直接串联编译和运行 - macOS/Linux 用户两种都可，但若用
cmd数组，必须显式加"shell": true，否则$file等变量不展开 - 别混用：网上抄的模板里同时写
shell_cmd和cmd，Sublime 只认前者，后者被忽略
file_regex 写不对，双击错误就跳错行
Sublime 靠 file_regex 从编译输出里提取文件名和行号。GCC 默认报错格式是 main.cpp:5:12: error:，正则必须严格匹配，否则双击白点。
- 推荐写法：
"file_regex": "^(..[^:]*):([0-9]+):([0-9]+):? (.*)$"—— 第一组捕获文件路径（支持含空格），第二组是行号，第三组列号（可选），第四组是错误信息 - Scala 错误格式不同：
MyApp.scala:7: error:，对应正则应为"file_regex": "^([^:]+):([0-9]+):(?:[0-9]+):" - Swift 错误带等级前缀：
main.swift:4:5: error:，正则需兼容error/warning/note："file_regex": "^([^:]*):([0-9]+):([0-9]+): (?:error|warning|note): (.*)$"
working_dir 不设，import 就找不到模块
几乎所有语言的构建系统都依赖相对路径查找依赖，比如 C++ 的 #include "utils.h"、Scala 的 import utils._、D 的 import std.stdio。如果 working_dir 没设成 "$file_path"，编译器会在 Sublime 启动目录（通常是用户主目录）下找文件，必然失败。
- 必须写：
"working_dir": "$file_path"或"${file_path}"（两者等效） - 别漏掉：网上很多模板只写
shell_cmd和file_regex，但没设working_dir，导致看似编译通过，实际链接或导入失败 - 特殊场景：若项目有统一
src/目录结构，可设为"$file_path/src"，但需确保所有import路径与之对齐
真正卡住人的从来不是语法或 JSON 格式，而是编译器进程的环境隔离、错误流的重定向、以及正则对真实输出的脆弱匹配——这些细节不手动验证，配十遍也白搭。
