Sublime Text 的“一键运行”实为配置 Build System，通过 $file_extension 动态调用 python/node/bash/ruby 等命令；需手动保存文件，且 Build 不继承 shell 环境，应显式指定解释器路径。
Sublime Text 里没有“一键运行”这回事，只有 Build System
Sublime Text 本身不执行脚本，它只是调用外部命令（比如 python、node、bash）去跑。所谓“一键运行”，本质是配一个能自动识别当前文件类型、拼出正确命令、并把当前文件路径传进去的 Build System。
你手动按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS）触发的，就是这个 Build System。它不是魔法，是配置出来的。
怎么写一个真正通用的 Python/JS/Shell 脚本 Build
关键不在“万能”，而在“根据后缀自动选命令”。Sublime 支持基于 selector 和 file_regex 的上下文感知，但更简单可靠的做法是：用一个 Build 文件，靠 $file 和 $file_base_name 动态构造命令。
- 新建菜单 → Tools → Build System → New Build System…
- 删掉默认内容，粘贴以下（支持 Python / JavaScript / Bash / Ruby）：
{
"shell_cmd": "case \"${file_extension}\" in\n \"py\") python \"$file\" ;;\n \"js\") node \"$file\" ;;\n \"sh\") bash \"$file\" ;;\n \"rb\") ruby \"$file\" ;;\n *) echo \"Unsupported extension: $file_extension\" && exit 1 ;;\nesac",
"file_regex": "^(...*?):([0-9]*):?([0-9]*)",
"selector": "source.python, source.js, source.shell, source.ruby",
"variants": [
{
"name": "Run in Terminal",
"shell_cmd": "open -a Terminal.app \"$file_path\" 2>/dev/null || gnome-terminal --working-directory=\"$file_path\" -e \"bash -c '$file; exec bash'\" 2>/dev/null || xterm -e \"bash -c '$file; exec bash'\""
}
]
}
- 保存为
SmartRun.sublime-build（名字随意，但后缀必须是.sublime-build） - 之后在右下角状态栏点语言名 → 选对应语法（如
Python），再按Ctrl+B就能跑
为什么你的 Build 总报 “command not found” 或 “No module named xxx”
Build System 默认不读你的 shell 环境（比如 ~/.zshrc 或 venv），它调用的是裸的系统 PATH。所以常见错误不是配置错，而是环境没继承。
-
python找不到？→ 检查终端里which python输出，把完整路径写进shell_cmd，比如/opt/homebrew/bin/python - 用了虚拟环境却 import 失败？→ 不要指望 Build 自动激活 venv；改用
"shell_cmd": "/path/to/venv/bin/python \"$file\"" - macOS 上
node找不到？→ Homebrew 安装的 node 通常不在系统 PATH，用which node替换 - Windows 用户注意：
$file是正斜杠路径，但 cmd 不认；建议用shell_cmd+cmd /c包一层，或直接切到 Git Bash
别碰 “Save all on build” 和 “Auto Save” 这类开关
它们看着省事，实际埋雷。尤其当你正在改一个被其他进程监听的文件（比如 Webpack watch、Flask dev server），自动保存可能触发两次构建，或者导致脚本读到半截内容。
- Sublime 的 Build 是同步阻塞的，但文件写入和外部命令启动有微小时间差
- 如果你依赖
$file_base_name做日志或临时文件名，未保存时它会是空字符串或乱码 - 真要自动保存 → 用插件
AutoSave，并设delay_ms≥ 500，避开高频编辑抖动
最稳的做法：养成习惯，运行前手动按 Ctrl+S —— 这一步没法跳过，也根本不该跳过。
