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 有本质差距。