确认本地编译器命令行可用是前提，Sublime Text本身不带编译器，必须先在终端验证g++ --version等命令有效，再于Packages/User/目录创建.sublime-build文件配置cmd或shell_cmd，否则Build菜单灰显、Ctrl+B无响应。
确认本地编译器命令行可用是前提
Sublime Text 本身不带任何编译器，所谓“配置”只是让它调用你系统里已装好的 g++、javac、python 等命令。如果终端里 g++ --version 报错或没输出，Sublime 的任何配置都无效。
常见错误现象：Build 菜单灰掉、按 Ctrl+B 没反应、输出面板只显示 [Finished in 0.1s] 但无实际编译结果。
- macOS/Linux：终端运行
which g++和g++ --version，两个都得有正常输出 - Windows：CMD 运行
where g++和g++ --version；若where无输出，说明g++所在目录没进系统PATH，光设JAVA_HOME或MinGW安装路径不够 - 改完环境变量后，必须彻底退出 Sublime（任务管理器杀进程 / 右键菜单选“退出”），再重开——否则它读不到新
PATH
手动创建 .sublime-build 文件最可靠
别动 Packages/C++/C++.sublime-build 这类内置包里的文件，它们会被更新覆盖，且调试困难。直接在 Packages/User/ 下新建文件才是标准做法。
操作路径：Preferences → Browse Packages → User，新建文本文件，保存为 C++.sublime-build（名字可自定义，但后缀必须是 .sublime-build）。
-
"shell_cmd"适合写一整条 shell 命令（如g++ -std=c++20 "${file}" -o "${file_path}/${file_base_name}"），Windows 上注意路径含空格时要用双引号包裹 -
"cmd"适合拆成数组形式（如["g++", "-std=c++20", "${file}", "-o", "${file_path}/${file_base_name}"]），跨平台更稳，但不能用&&连接多条命令 - 想支持编译后自动运行，得用
"variants"字段单独定义一个变体，比如"name": "Run"，里面再写带&&的shell_cmd
file_regex 决定能否双击跳转错误行
编译出错时，Sublime 靠 file_regex 解析错误信息，提取文件名和行号，才能让你双击错误行直接跳转。配错就只能看文字，没法快速定位。
典型 C/C++ 错误格式：main.cpp:12:5: error: expected ';' after expression，对应正则应为："^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$"。
- Java 编译错误格式不同，例如
MyClass.java:8: error: cannot find symbol，正则可简化为："^([^:]+):([0-9]+):.*$" - Python 错误以
File "开头，常用："^File \"(.+?)\", line ([0-9]+)" - 正则写错会导致整个构建任务看起来“成功”，但错误行无法跳转——这是最容易被忽略的细节
working_dir 和 encoding 影响中文与相对路径
working_dir 决定编译命令在哪执行，encoding 控制 Sublime 如何读取源码。这两项配错，轻则中文乱码，重则 package 编译失败、文件找不到。
-
"working_dir": "${file_path}"最常用，确保g++或javac在源文件所在目录运行，能正确处理#include "xxx.h"或import xxx - Java 必须加
"-encoding UTF-8"参数，否则含中文的.java文件编译会报error: unmappable character - Windows 上若源码是 GBK 编码（老项目），
encoding设为"cp936"，但推荐统一用 UTF-8 + 对应编译参数
真正容易被忽略的是：Sublime 图形界面启动时（比如双击图标），在 macOS 上往往不继承 shell 的 PATH 和环境变量，用终端执行 open -a "Sublime Text" 或装好 subl 命令后用它启动，才能保证环境一致。
