Sublime Text 不能直接运行 npm 脚本，必须通过自定义构建系统调用系统 shell 执行；常见问题源于 working_dir 配置错误、未设 "shell": true 导致 PATH 不生效，或使用 shell_cmd 而非 cmd 数组致使信号无法透传。
Sublime Text 不能直接“运行 npm 脚本”，必须靠自定义 Build System 把命令转给系统 shell 执行；配错 working_dir 或漏掉 "shell": true，90% 的“点不动”问题就出在这儿。
为什么 npm run dev 点了没反应或报 'npm is not recognized'
Sublime 启动时读的是系统级 PATH，不是你 Shell 配置里改过的 PATH（比如 zshrc 里加的 node/yarn 路径，Sublime 根本看不到）。Windows 上尤其明显——即使 cmd 里能跑 npm，Sublime 构建仍会失败。
- 必须加
"shell": true：不加的话，Windows 无法解析npm命令名，macOS/Linux 可能找不到全局 bin -
working_dir必须设为"${project_path:${folder}}"：否则 Sublime 会在自己安装目录下找package.json，当然找不到脚本 - 别用
shell_cmd写成"shell_cmd": "npm run dev"：这种写法 Ctrl+C 终止不了开发服务器，cmd数组才支持信号透传
如何让一个 .sublime-build 文件支持多个 npm script
不用为每个脚本（start、build、test）都建一个文件。用 $ 占位符 + 快捷键绑定更轻量。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 构建配置里写
"cmd": ["npm", "run", "$"]，保存为NpmRun.sublime-build - 执行时按
Ctrl+Shift+P→ 输入Build With…→ 选NpmRun→ 回车后直接输脚本名，比如dev - 如果想固定常用脚本，还是建议项目级配置：在
.sublime-project里内联定义多个build_systems，名字带描述（如"name": "Frontend: dev"），避免跨项目误用
中文路径或 require('./config.json') 失败怎么办
根本原因是工作目录不对，或者编码不一致导致 Node.js 进程启动失败，而不是 Sublime “不支持中文”。
-
working_dir必须是"${project_path:${folder}}"，不是"$file_path"—— 后者指向当前文件所在目录，不是项目根，require相对路径会断 - 中文路径下，加
"encoding": "utf-8"到构建配置里，防止 Node.js 启动时因编码异常崩溃 - 如果用了
nodemon或ts-node这类 wrapper，确保它们是全局安装且 PATH 可见；否则换用本地npx nodemon更可靠
真正麻烦的不是写 JSON，而是 Sublime 构建系统不暴露进程生命周期——它不会告诉你服务是否已启动成功，也不会自动 kill 上一个实例。需要热更新或后台守护，得靠 Terminus 插件起终端面板，再手动管理，这点和 VSCode 的 task + problemMatcher 有本质差距。
