Sublime Text构建系统通过JSON配置文件定义执行命令，需正确设置cmd、working_dir等字段并选择对应构建系统，才能成功运行代码并显示输出。
如果您尝试在Sublime Text中运行代码，但无法看到输出结果或构建过程失败，则可能是由于构建系统配置不当或未正确选择。以下是深入理解Sublime Text构建系统工作原理的详细步骤：
一、理解Build System的基本结构
Sublime Text的构建系统通过JSON格式的配置文件来定义如何执行外部命令。其核心作用是将编辑器与编译器或解释器连接起来，实现一键运行代码。
构建系统文件通常包含以下关键字段：cmd（执行命令）、selector（语法关联）、file_regex（错误解析）和working_dir（工作目录）。
1、打开Sublime Text，点击菜单栏中的Tools → Build System → New Build System...，可创建一个新的构建配置文件。
2、保存该文件时，Sublime会自动将其存放在Packages/User/目录下，文件扩展名为.sublime-build。
3、每个.sublime-build文件对应一个可选的构建环境，用户可通过Tools → Build With...进行切换。
二、配置自定义构建命令
通过手动编写构建系统文件，可以为特定语言或项目定制执行流程，例如运行Python脚本、编译C++程序或执行Shell命令。
1、以Python为例，在新建的构建系统中输入：{ "cmd": ["python", "$file"], "selector": "source.python" }。
2、若系统中使用python3命令，则需改为["python3", "$file"]，确保路径正确。
3、使用变量如$file表示当前打开的文件路径，$file_path表示文件所在目录，$project表示项目根目录。
4、保存后，在对应语言文件中按下Ctrl+B即可执行构建命令。
三、设置工作目录与环境变量
某些项目依赖于特定的工作目录或环境变量才能正常运行，此时需要在构建系统中显式指定。
1、添加working_dir字段，值设为$file_path，使命令在文件所在目录执行。
2、若需设置环境变量，使用env字段，例如："env": {"PATH": "/usr/local/bin:$PATH"}。
3、这在调用本地安装的工具链（如Node.js、Go）时尤为重要，避免出现“command not found”错误。
四、启用语法高亮与错误捕获
构建系统支持正则表达式匹配编译或运行时的错误信息，并在编辑器中标记位置，提升调试效率。
1、在构建配置中添加file_regex字段，例如："file_regex": "^(...*?):([0-9]+):([0-9]+): (.*)"。
2、当命令输出符合此模式的错误行时，Sublime会将其解析为文件名、行号、列号和消息内容。
3、双击状态栏的错误提示，编辑器将自动跳转到对应代码行。
五、管理多个构建目标
一个项目可能需要多种构建方式，比如调试模式、发布模式或测试脚本，Sublime支持在同一文件中定义多个目标。
1、使用variants数组来定义额外的构建选项，例如添加一个名为“Verbose”的变体。
2、配置示例："variants": [{ "name": "Run with Args", "cmd": ["python", "$file", "--verbose"] }]。
3、通过Tools → Build With...可选择不同的variant执行。
