Sublime Text 可通过配置构建系统调用 Webpack，但需显式设置 "shell": true、"working_dir" 和使用 npx；监听需变体或 Terminus 插件；保存自动构建应避免 --watch 阻塞；源码定位需 sourcemap 与语法高亮匹配。
Sublime Text 本身不运行 Webpack，但能可靠触发、监听和反馈 Webpack 构建任务——关键在于构建系统（Build System）的配置是否匹配项目实际依赖路径与执行环境。
为什么 npm run build 在终端能跑，Sublime 里却报 "command not found"
根本原因不是 Sublime 有问题，而是它的构建系统默认不加载 shell 环境变量（比如 PATH），导致找不到 npm 或本地 node_modules/.bin/webpack。
- Windows 下必须加
"shell": true，否则npx和npm命令全失效 - macOS/Linux 也建议加
"shell": true，避免因 Sublime 启动方式（如桌面图标）导致 shell profile 未加载 -
"working_dir": "${project_path}"必须显式设置，否则npx无法定位当前项目的node_modules - 别用全局安装的
webpack：改用["npx", "webpack", "--config", "webpack.config.js"]，确保调用的是项目级版本
如何让 Ctrl+B 直接启动 webpack --watch 并实时看到错误
靠单一 Build System 默认行为做不到持续监听输出，需组合两个能力：变体（variant）+ 终端插件。
- 在
.sublime-build文件中定义"variants"，例如：{ "name": "Webpack — Watch", "cmd": ["npx", "webpack", "--watch", "--config", "webpack.config.js"], "working_dir": "${project_path}", "shell": true } - 按
Ctrl+Shift+B（Win/Linux）或Cmd+Shift+B（macOS）唤出构建菜单，选该变体即可启动 - 但注意：原生 Build System 不支持滚动查看长日志、无法交互中断。推荐装
Terminus插件，配一个独立终端命令：{"title": "webpack watch", "cmd": ["npm run watch"], "shell": true}，这样错误堆栈可展开、可点击跳转文件行号
保存 JS 文件时自动触发构建，但不卡住编辑器
Sublime 原生不支持“保存即构建”，需借助插件，且必须避开阻塞主线程的陷阱。
- 装
Save Actions插件后，在Preferences → Package Settings → Save Actions → Settings – User中填：{ "save_actions": [ ["build", {"build_system": "Webpack.sublime-build"}] ] } - ⚠️ 切勿把
"cmd"设为["npx", "webpack", "--watch"]：Save Actions 是同步触发，会卡死保存流程 - 正确做法是只绑定一次构建（如
npm run build），再另起一个Terminus终端常驻--watch模式 - 若项目有多个构建脚本（
dev/build/test），建议用.sublime-project文件内联定义不同build_systems，避免全局配置冲突
Webpack 报错定位不到源码行号？检查 sourcemap 和 Sublime 语法识别
错误信息里显示 bundle.js:123 而不是 src/index.tsx:45，大概率是两处没对齐。
- 确认
webpack.config.js中已启用devtool: 'source-map'或'cheap-module-source-map'（开发期） - 确保 Sublime 当前打开的文件使用了正确的语法高亮：.tsx 文件右下角应为
TypeScript JSX，不是JavaScript；.vue 文件应为Vue Syntax Highlight - 如果用了 Vite 替代 Webpack，不要硬套 Webpack 的构建配置——Vite 的
npm run dev应该走自己的 server，Sublime 只负责调用，不参与 HMR 逻辑
真正容易被忽略的点是：Webpack 的错误输出是否经过了 stats 配置过滤。比如 stats: "errors-only" 会让 warning 消失，而 Sublime 构建面板默认只捕获 stdout，stderr 才带颜色和堆栈——务必在构建配置里保留 "quiet": false 和默认 stats 级别，不然你会以为“没报错”，其实是被吞掉了。
