sublime text构建前任务必须用shell_cmd或cmd组合实现，因原生不支持独立pre-build hook；shell_cmd更稳妥，支持&&等连接符，cmd数组需显式调用cmd/c或bash-c，且须注意输出重定向与file_regex匹配冲突。
构建前任务必须用 shell_cmd 或 cmd 组合实现
Sublime Text 的构建系统本身不支持独立的“pre-build hook”或类似 VS Code 的 preLaunchTask 机制。所谓“构建前任务”，实际是把多个命令串成一条 shell 命令，或用脚本封装后调用。直接在 cmd 数组里写多条命令会失败——JSON 不允许嵌套数组执行顺序，且 Sublime 默认只执行第一条。
-
shell_cmd是更稳妥的选择：它把整条字符串交给系统 shell 解析，支持&&、;、||等连接符，适合清理、生成文件、检查依赖等简单前置动作 - Windows 下若用
cmd数组，需显式调用cmd /c，例如["cmd", "/c", "echo hello && python -m pip check"] - macOS/Linux 下推荐用
shell_cmd配合bash -c，比如"shell_cmd": "cd $file_path && make clean && make all" - 不要依赖
working_dir自动生效于每条子命令——它只影响主命令启动时的路径，shell_cmd内部的cd必须显式写出
常见错误：file_regex 无法匹配前置命令的报错
当你在 shell_cmd 里加了 make clean && python $file，而 make clean 输出了类似 rm: cannot remove 'build/': No such file or directory 的信息，这些行也会被 file_regex 尝试解析，导致跳转错乱甚至构建面板卡住。
- 解决方法是把前置命令的输出重定向掉，例如
"shell_cmd": "make clean > /dev/null 2>&1 && python $file" - 或者用
|| true抑制非关键错误："shell_cmd": "make clean || true && python $file" - 如果前置任务本身有结构化输出（如 JSON 格式的 lint 结果），就别用
file_regex解析它——要么单独写个构建系统专用于 lint，要么改用插件（如 SublimeLinter）处理
复杂前置逻辑建议外置为脚本文件
当构建前要判断 Python 版本、激活虚拟环境、下载模型权重、或根据文件名决定是否编译 C 扩展时，硬塞进 shell_cmd 字符串里会迅速变得不可读、难调试、难复用。
- 写一个
prebuild.sh（Linux/macOS）或prebuild.bat（Windows），放在项目根目录或Packages/User/下 - 在构建系统中调用它：
"cmd": ["./prebuild.sh", "$file"], "working_dir": "$file_path" - 脚本第一行加
#!/bin/bash或@echo off，确保可执行权限（Linux/macOS 上用chmod +x prebuild.sh） - 注意：Sublime 在 Windows 上默认不继承用户 PATH，如果脚本里调用了
python或pip，得写绝对路径或在脚本开头手动 set PATH
项目级构建系统里嵌入前置任务更可靠
全局构建系统（保存在 Packages/User/）容易被多个项目共用，但不同项目对“构建前该做什么”往往差异很大。比如一个项目需要 npm install，另一个要 poetry install，混在一起只会互相干扰。
- 务必先保存项目：菜单 Project → Save Project As…，生成
.sublime-project - 在该文件的
build_systems数组里定义构建项，而不是新建.sublime-build文件 - 这样你可以为同一语言写多个构建变体：
"name": "Python (with venv)"和"name": "Python (skip deps)"，并设"target": "exec"配合自定义cmd - 项目配置优先级高于用户级，切换项目时自动切换行为，避免手误选错构建系统
shell_cmd 中用了 &&，但某一步 stdout 被重定向后 exit code 丢失，整个链就可能静默中断。调试时别只看底部面板有没有输出，要打开 Sublime 控制台（Ctrl+`）看 Python 异常和 subprocess 启动日志。
