Sublime Text找不到编译器的根本原因是PATH未被继承；Windows需用where g++验证并添加MinGW路径到系统环境变量，macOS/Linux需用which g++和g++--version确认，且GUI启动的Sublime不读.shell配置，必须从终端启动或重启生效。
Sublime Text 找不到编译器：PATH 不生效的典型表现
按 Ctrl+B 后报错 'g++' is not recognized（Windows）或 command not found: g++（macOS/Linux），不是配置写错了，而是 Sublime 根本没读到你的编译器路径。
Sublime 启动时只加载系统级环境变量，不继承终端里用 export PATH=... 临时改的，也不读 shell 的 .zshrc 或 .bash_profile。图形界面启动的 Sublime（比如双击图标）尤其容易踩这个坑。
- Windows：打开
cmd，运行where g++，有输出才说明已进系统 PATH；没输出就去「系统属性 → 高级 → 环境变量」里把 MinGW 或 MSYS2 的bin目录（如C:\msys64\mingw64\bin）加进「系统变量」的Path - macOS/Linux：终端运行
which g++和g++ --version都要成功；若用brew install gcc，实际命令可能是g++-14，构建系统里就得写死这个名 - 改完 PATH 后，必须彻底退出 Sublime（任务管理器杀掉所有
subl进程），再重开，否则新变量不会加载
构建系统 JSON 中 cmd 和 shell_cmd 怎么选
cmd 是数组形式，适合跨平台、参数明确的场景；shell_cmd 是字符串，支持 &&、| 等 shell 操作符，但依赖 shell 环境。
Windows CMD 和 PowerShell 对 && 解析不一致，Linux/macOS 的 sh 或 zsh 则没问题。所以更稳的做法是：
- 用
cmd数组 +"shell": true（显式启用 shell 解释），例如："cmd": ["g++", "${file}", "-o", "${file_base_name}", "&&", "./${file_base_name}"] - 或直接用
shell_cmd字段，省去数组括号和引号，例如："shell_cmd": "g++ '${file}' -o '${file_base_name}' && ./${file_base_name}" - 注意单引号包裹
${file}，防止文件名含空格时出错 - Windows 上
&&在 CMD 中可用，但 PowerShell 默认用;分隔命令，加"shell": true后会走 CMD，避免混淆
中文乱码和输入交互受限的根本原因
Sublime 底部面板本质是伪终端，不支持真正的 TTY 行为，所以 std::cin 或 input() 可能卡住、乱码或直接跳过。
- 乱码主因是编码不匹配：在构建系统中加
"encoding": "utf-8"和"env": {"PYTHONIOENCODING": "utf-8"}（Python）或{"LANG": "en_US.UTF-8"}（Linux/macOS C++） - Windows 中文乱码还可加
"cmd": ["chcp", "65001", "&&", "g++", ...]强制切换代码页 - 交互式输入基本无解——底部面板不提供 stdin 流控制。真正需要输入的程序，要么加
std::cin.get()暂停，要么用插件（如Terminus）调起外部终端运行 - 不要指望
system("pause")在 Sublime 输出面板里有效，它依赖 Windows 控制台句柄，而 Sublime 没给
selector 和文件类型绑定失效的排查点
写了 C++.sublime-build，但按 Ctrl+B 还是调用 Python 构建系统？问题大概率出在 selector 没匹配上当前文件的语法类型。
- 先确认文件已用正确语法高亮：右下角状态栏应显示
C++，不是Plain Text；若不对，点击右下角 →Open all with current extension as...→ 选C++ -
selector值必须精确对应语法定义里的 scope，C++ 文件常用的是"source.c++"或"source.cpp"，不是"source.c++17"这类不存在的 scope - 多个语言共用一个构建系统时，
selector可写成逗号分隔："source.c, source.cpp, source.objc" - 保存位置必须是
Packages/User/目录（可通过Preferences → Browse Packages…打开），放错位置 Sublime 会静默忽略
最常被忽略的是：构建系统保存后，必须手动在 Tools → Build System 里选中它，而不是依赖自动识别。即使文件名是 C++.sublime-build，默认也不会激活，得点一下才行。
