Sublime Text本身不带编译器，配置本质是创建调用本地g++/python等工具的构建任务；必须先在终端验证g++ --version等命令可用，再配置cmd数组形式的.sublime-build文件，存于Packages/User/目录，匹配正确selector和file_regex。
Sublime Text 本身不带编译器，所谓“配置编译器”其实是配置一个能调用你本地已安装编译器（如 g++、python、clang++）的构建任务。如果终端里都跑不起来 g++ --version 或 python3 --version，那 Sublime 的任何配置都白搭。
确认编译器在命令行可用，再动 Sublime
这是最容易被跳过的一步，但 90% 的“配置不生效”问题根源在此。
- Windows：打开 CMD，运行
where g++或where python；若无输出，说明没装或没加进 PATH - macOS：终端执行
which clang++或which python3；Xcode 命令行工具未装时会提示安装 - Linux：运行
which gcc或which python3；Ubuntu 用户常漏装build-essential - Sublime 不继承你的 shell 环境变量，所以别信“我在 zsh 里能跑，Sublime 就该能跑”——它只认你写死的路径或系统级 PATH
写对 cmd 字段，别被 shell_cmd 带偏
cmd 是数组形式，更安全、跨平台兼容性更好；shell_cmd 是字符串，依赖 shell 解析，容易因空格、引号、&& 失败。
- 推荐用
"cmd": ["g++", "${file}", "-o", "${file_base_name}", "-std=c++17"]，变量直接插在数组里，不用拼接字符串 - Windows 下慎用
shell_cmd里的&&：CMD 不稳定，PowerShell 更不认；真要链式执行，改用"cmd": ["cmd", "/c", "g++ ... && .\a.exe"] -
${file}是全路径，含空格时会被截断；"${file}"加引号只在shell_cmd中有效，在cmd数组里无效——得靠系统自动处理或确保路径无空格 - Python 用户注意：
-u必须紧跟解释器后，["python3", "-u", "$file"]✅，["python3", "$file", "-u"]❌
selector 和语法 scope 不匹配，构建系统就等于不存在
Sublime 不是按文件后缀自动选构建系统，而是看右下角显示的 syntax（比如 “Python”），再匹配 selector 字段值。
- 当前文件是 Python，但右下角显示 “Plain Text”，那
"selector": "source.python"就不会触发 - 查真实 scope：按
Ctrl+Shift+P→ 输入Developer: Show Scope Name，看输出是不是source.python或source.c++ - 想让一个构建系统适配多个语言？删掉
selector最偷懒，但会污染菜单；更合理的是用"selector": "source.python | source.c++" - 自定义构建系统必须存放在
Packages/User/目录下，丢在桌面或项目根目录里，Sublime 根本看不到
中文乱码、input() 卡住、运行完窗口闪退——不是配置错，是机制限制
Sublime 的输出面板不是终端，它不支持交互式输入，也不控制底层编码。
- Python 脚本含
input()：输出面板卡住是正常现象，必须切到系统终端运行 - 中文
print变：Windows 默认 GBK，Python 脚本用 UTF-8；加"env": {"PYTHONIOENCODING": "utf-8"}才真正生效 - 运行完就退出，看不到结果：Windows 用户可在
cmd数组末尾加"pause"，但仅限"cmd": ["cmd", "/c", "python -u "$file" && pause"]这种 shell 模式 - 错误定位点不跳转：检查
file_regex是否匹配编译器实际输出，GCC 是main.cpp:5:10:，Clang 是main.cpp:5:10:但后面格式略有不同，正则得微调
最常被忽略的其实是工作目录和多文件项目——单文件 g++ main.cpp 能跑，不代表 g++ a.cpp b.cpp -o app 也能靠一个 .sublime-build 解决。一旦涉及头文件、Makefile 或 CMake，就该承认 Sublime 的构建系统只是轻量胶水，不是 IDE 替代品。
