sublime构建系统文件必须放在packages/user/目录下才能跨平台生效，其他路径均不被加载；需用platform键（windows/osx/linux）和环境变量实现跨平台适配，避免硬编码路径。
Sublime构建系统文件该放在哪才能跨平台生效
构建系统（.sublime-build 文件）必须放在 Packages/User/ 目录下，否则 Sublime 不会加载。它不支持放在插件目录或全局路径里，也不随 Package Control 自动分发——哪怕你用 Git 或符号链接同步了整个 User/，漏掉这个目录下的 .sublime-build，换电脑后 Ctrl+B 就直接报“no build system”。
常见错误现象：
- 在 Windows 写好
Python3.sublime-build，复制到 macOS 的User/后仍无法选中——其实是文件权限或换行符损坏（CRLF → LF 转换失败） - 构建命令在一台机器能跑，另一台提示
sh: python3: command not found——不是配置问题，是路径写死了/usr/local/bin/python3，而另一台没装或装在别处
怎么写一个真正跨平台的构建系统
靠硬编码绝对不行。Sublime 提供了 platform 键和环境变量展开，这才是跨平台关键。
示例：一个兼容 Win/macOS/Linux 的 Python 构建系统
{
"cmd": ["python3", "-u", "$file"],
"file_regex": "^\s*File "(...*?)", line ([0-9]*)",
"selector": "source.python",
"variants": [
{
"name": "Run in Terminal",
"cmd": ["python3", "-u", "$file"],
"shell": true,
"windows": { "cmd": ["py", "-u", "$file"] },
"osx": { "cmd": ["open", "-a", "Terminal", "--args", "python3", "-u", "$file"] },
"linux": { "cmd": ["gnome-terminal", "--", "python3", "-u", "$file"] }
}
]
}
要点说明：
-
"windows"/"osx"/"linux"块只在对应平台生效，其他平台自动忽略 -
"shell": true在 Windows 上等价于调用 cmd，macOS/Linux 则走默认 shell，避免sh: python3: not found - 不要写死
"/usr/bin/python3"，用"python3"让系统 PATH 解析；Windows 用户若用py启动器，就用"windows": { "cmd": ["py", "-u", "$file"] } -
"$file"是安全变量，"$file_path"或"$project_path"在跨平台时可能含反斜杠（Win）或空格（macOS），需额外转义
同步时最容易被忽略的两个坑
即使你用 Git 或符号链接把 User/ 同步过去了，构建系统仍可能失效——问题不在配置本身，而在依赖和上下文。
-
color_scheme或font_face等字段如果引用了非标准主题或字体，另一台设备没装，Sublime 会静默降级，但构建系统不会报错，只是输出乱码或卡住 - 某些构建系统依赖外部 CLI 工具（如
node,rustc,gcc），它们的路径、版本、甚至 ABI 兼容性在不同平台差异极大——同步配置不能代替安装工具链 - Windows 的
.sublime-build文件名若含空格或中文，macOS/Linux 下可能因文件系统大小写敏感或编码问题无法识别（建议全小写 + 下划线）
要不要把构建系统单独抽出来管理
没必要。它天然属于 User/ 配置范畴，和其他 .sublime-settings 一样，应随 User/ 整体同步。但要注意：
- 别把它放进插件目录（如
Packages/MyBuildTools/），Sublime 默认不扫描子目录下的.sublime-build - 如果用了自定义语法高亮（
.sublime-syntax）配合构建系统，那个语法文件也得一并同步到User/，否则selector匹配失败 - Git 同步时记得加
.gitattributes强制* text=auto eol=lf，避免 Windows 提交 CRLF 导致 macOS/Linux 解析失败
构建系统跨平台的核心不是“让一份配置跑通所有系统”，而是“用平台感知机制隔离差异”。一旦开始写死路径、硬编码终端命令、或忽略 variants 结构，同步就变成了定时炸弹。
