构建系统

注意

此页面描述了构建系统的旧行为。虽然它仍然大体上是正确的，但请参考官方文档以获取最新版本。我们正在努力改进这一点。

构建系统的官方文档：关于所有可用选项、变量等的完整文档。

构建系统允许您通过外部程序（如 make、tidy、解释器等）运行您的文件。

从构建系统调用的可执行文件必须位于您的 **PATH** 中。

文件格式

构建系统是 JSON 文件，扩展名为 .sublime-build。

以下是一个构建系统的示例

{
    "cmd": ["python", "-u", "$file"],
    "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
    "selector": "source.python"
}

cmd：必填。此选项包含要执行的实际命令行。

bash

python -u /path/to/current/file.ext

file_regex：一个 Perl 风格的正则表达式，用于从外部程序的输出中捕获错误信息。此信息用于帮助您使用 F4" 导航错误实例。

selector：如果设置了 **工具 | 构建系统 | 自动** 选项，Sublime Text 将通过将 selector 与文件的范围匹配来自动查找活动文件的相应构建系统。

除了选项之外，您还可以使用一些变量在构建系统中，就像我们在上面使用 $file 一样，它扩展为活动缓冲区的文件名。

构建系统必须位于 Packages 文件夹下的某个位置（例如 Packages/User）。许多包包含它们自己的构建系统。

可以通过按下 F7 或从 **工具 → 构建** 运行构建系统。