Sublime Text需通过自定义构建系统运行npm/yarn脚本：设"shell": true、正确working_dir、用cmd数组而非shell_cmd；项目级配置多脚本并绑定快捷键可提升效率，但不支持进程管理与热更新监听。
怎么让Sublime直接运行npm run dev这类脚本
Sublime Text 本身不带包管理器集成，必须靠自定义构建系统（Build System）把npm或yarn命令“接进来”。关键不是写个能跑的命令，而是让它在正确的目录、用正确的 Shell 环境、拿到正确的PATH去执行。
- 打开
Tools → Build System → New Build System…，粘贴以下内容（以npm run dev为例）：
{
"cmd": ["npm", "run", "dev"],
"shell": true,
"working_dir": "${project_path:${folder}}",
"selector": "source.js"
}
-
"shell": true必须加——否则 Windows 上会报'npm' is not recognized，macOS/Linux 可能找不到全局 bin； -
"working_dir"要指向项目根目录，否则package.json读不到，脚本直接失败； - 别用
shell_cmd写成"shell_cmd": "npm run dev"—— 这种写法在 Sublime 中无法正确传递信号（比如 Ctrl+C 终止开发服务器），cmd数组才是安全方式。
为什么yarn脚本有时比npm更稳
不是因为 yarn 天然更好，而是它对环境变量和缓存路径的处理更“钝感”：npm v9+ 在某些终端配置下会读错NODE_ENV或跳过.env，而 yarn 默认严格按yarn.lock还原依赖树，且yarn run启动子进程时继承父 shell 更干净。
- 如果项目用了
yarn，构建系统里直接换掉命令就行：["yarn", "dev"]或["yarn", "run", "dev"]（yarn 3+ 推荐前者）； - yarn 全局安装后，
where yarn（Windows）或which yarn（macOS/Linux）查到的路径，要确保在 Sublime 启动时的PATH里——否则即使终端能跑，Sublime 构建仍会报 command not found； - 遇到
error Command "dev" not found，先确认yarn list --pattern dev是否真有这个 script，yarn 不像 npm 那样自动 fallback 到scripts.dev别名。
多个脚本怎么快速切换不手忙脚乱
不用为每个npm run build、npm test都新建一个.sublime-build文件。项目级配置 + 快捷键绑定才是高效做法。
- 保存项目：
Project → Save Project As…，生成.sublime-project文件； - 编辑该文件，在
"build_systems"下添加多个任务：
"build_systems": [
{
"name": "npm start",
"cmd": ["npm", "run", "start"],
"working_dir": "${project_path}",
"shell": true
},
{
"name": "yarn build",
"cmd": ["yarn", "build"],
"working_dir": "${project_path}",
"shell": true
}
]
- 保存后，按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Build With就能选； - 想进一步提速？给常用任务设快捷键，在
Preferences → Key Bindings里加一行：{"keys": ["ctrl+alt+b"], "command": "build", "args": {"build_system": "npm start"}}。
常见失败：脚本跑了但浏览器打不开、热更新失效
这通常不是 Sublime 的问题，而是构建系统没把开发服务器的生命周期管起来——它只负责“启动”，不监听端口、不转发日志、不支持中断重连。
- 如果你的
npm run dev启的是 Vite/Next/Nuxt 服务，Sublime 构建成功后只会显示 “Finished” 就退出，实际进程可能已 detach，导致后续修改不触发 HMR； - 解决方法：不要指望 Sublime 当 IDE，它只做“一键触发”；真正需要调试、断点、实时响应，得切到终端或用 VS Code；
- 若坚持在 Sublime 查看输出，加
"target": "exec"并删掉"shell": true，但这样 Ctrl+C 会失效，得手动杀进程（pkill -f "vite"）。
最易被忽略的一点：Sublime 的构建系统不会自动 reload tsconfig.json 或 .env，改了环境变量或 TS 配置后，必须重启 Sublime 才生效——这点和 VS Code 的任务系统完全不同。
