Sublime中UglifyJS/Terser构建失败主因是PATH未继承，必须用绝对路径；混淆无效多因漏写--mangle或版本不支持ES6，推荐改用Terser并显式配置reserved保留关键变量名。
为什么直接用 UglifyJS CLI 在 Sublime 里跑不通
很多人试过在 Sublime 的 Build System 里写 uglifyjs input.js -o output.min.js，结果报错 command not found: uglifyjs 或空文件——根本原因是 Sublime 的构建环境默认不读取你的 shell PATH（尤其是 macOS 的 ~/.zshrc 或 Linux 的 ~/.bash_profile），Node.js 全局 bin 路径压根没加载进来。
实操建议：
- 先在终端运行
which uglifyjs，拿到绝对路径，比如/usr/local/bin/uglifyjs或/Users/xxx/.nvm/versions/node/v18.18.2/bin/uglifyjs - 不要依赖
npm install -g uglify-js后直接写命令名，Sublime 构建系统不认识“全局命令”这回事 - 如果用的是
terser（UglifyJS 的现代替代品），同样要填绝对路径，且注意terser默认不带.js后缀，别写成terser.js
Sublime Build System 配置要点（支持保存即压缩 + 混淆）
新建 Tools → Build System → New Build System，粘贴以下内容并保存为 JavaScript-Compress.sublime-build：
{
"cmd": ["/usr/local/bin/terser", "$file", "-o", "${file_path}/${file_base_name}.min.js", "--compress", "--mangle", "--format", "semicolons=false"],
"selector": "source.js",
"file_regex": "^([^:]+):([0-9]+):([0-9]+):\s+(.*)$",
"shell": true
}
关键说明：
立即学习“Java免费学习笔记（深入）”；
-
"cmd"数组第一项必须是terser绝对路径；$file是当前文件全路径，${file_base_name}自动去掉扩展名 -
--mangle开启变量名混淆，--compress做语法级压缩（删空格、合并表达式等），不加这两个就只是格式化 -
"shell": true必须设为true，否则$file等变量不展开 - 混淆后代码不可调试，如需 source map，追加
--source-map "content=true"，但会生成额外文件
混淆后变量名还是没变？检查这几个地方
常见现象：构建成功、输出了 .min.js，但打开一看函数名、参数名原样未动，像 function getUser(id) { ... } 还是明文。
原因和对策：
-
--mangle参数漏了，或拼错成--mangel—— 命令行工具不会报错，只会静默忽略 - 用了
uglify-js@2.x（老版本），它默认不启用mangle，必须显式加--mangle；而terser默认也不开，同样要写 - 源码里有
/*#__NOINLINE__*/或/*@__NOINLINE__*/这类注释，会阻止对应函数被混淆 - ES6+ 解构赋值、class 字段等语法，老版 UglifyJS 不支持，会跳过混淆甚至报错，换
terser是更稳的选择
想保留特定变量名不混淆怎么办
比如项目里用了 window.API 或 globalThis.config，混淆后变成 window.a 就炸了。
两种办法：
- 用
--mangle reserved=['API','config']，把要保留的全局变量名列进reserved数组（注意单引号要写在 JSON 字符串里，实际是双引号包裹的字符串："--mangle", "reserved=['API','config']"） - 更可靠的方式：改用配置文件。建一个
terser.config.json放项目根目录，内容含"mangle": { "reserved": ["API", "config"] }，然后构建命令里用--config-file terser.config.json - 别试图用
/*#__PURE__*/注释控制混淆——那是给compress用的，跟mangle无关
真正麻烦的不是配错参数，而是混淆后运行时报 ReferenceError 却查不出哪变了——建议每次压缩完，用浏览器 console 手动执行一两行关键逻辑验证。
