Javascript代码压缩混淆工具terser详解

原始的JavaScript代码在正式的服务器上,如果没有进行压缩,混淆,不仅加载速度比较慢,而且还存在安全和性能问题. 因此现在需要进行压缩,混淆处理. 处理方案简单描述一下:

1. 使用 terser 工具进行

安装 terser工具:

bash 复制代码

# npm 安装
npm install terser --save-dev

# 或使用 yarn 安装
yarn add terser --dev

2. terser工具详解

基本语法：

bash 复制代码

terser [input.js] [options] --output output.min.js

例如把 input.js 压缩并输出到 output.min.js：

bash 复制代码

terser input.js --compress --mangle --output output.min.js

3. 使用配置文件配置 Terser

Terser 支持将配置项放在单独的配置文件中，便于管理。通常使用一个 JavaScript 文件（如：terser.config.js）进行配置. 我们可以创建一个名为 terser.config.js 的文件, 具体配置如下:

javascript 复制代码

// terser.config.js
module.exports = {
  compress: {
    drop_console: true,   // 去除console.*语句
    drop_debugger: true,  // 去除debugger语句
    passes: 2,            // 多次压缩迭代，效果更明显
    unused: true,         // 删除未使用的代码
    dead_code: true,      // 删除无效的代码分支
  },
  mangle: {
    toplevel: true,       // 混淆顶级变量和函数名
    properties: false,    // 默认不混淆属性名，避免破坏外部接口
  },
  output: {
    comments: false,      // 删除所有注释
    beautify: false,      // 不进行格式化排版，压缩为一行
  },
  sourceMap: {
    filename: "output.min.js",
    url: "output.min.js.map"
  }
};

对于常用的配置项, 详解如下:

compress 压缩选项：

选项名	说明	推荐值
drop_console	移除所有console.*语句	true
drop_debugger	移除所有debugger语句	true
passes	重复压缩次数，数值越高效果越好	2~3
unused	删除未使用的变量或函数	true
dead_code	删除死代码	true

mangle 混淆选项：

选项名	说明	推荐值
toplevel	混淆顶级函数和变量名	true
properties	是否混淆对象属性名	false（慎用
reserved	不被混淆的变量或函数名（保留关键字）	按需配置

output 输出选项:

选项名	说明	推荐值
comments	是否保留注释	false
beautify	是否格式化输出代码	false

sourceMap 源码映射选项:

用于生成 source map 文件，便于调试

选项名	说明
filename	指定输出js文件名
url	source map 文件的名称

4. 运行 Terser 配置文件

使用配置文件进行压缩：

javascript 复制代码

terser input.js --config-file terser.config.js --output output.min.js

--config-file 指定使用的配置文件。
--output 指定输出文件路径。

5. 在 npm scripts 中配置（推荐）

为了方便管理，建议你在项目的 package.json 中添加一个 npm script：

javascript 复制代码

{
  "scripts": {
    "build:js": "terser src/input.js --config-file terser.config.js --output dist/output.min.js"
  }
}

然后执行:

bash 复制代码

npm run build:js

4. 与 Webpack 集成使用（可选)

如果你使用的是 webpack 项目，推荐使用 terser-webpack-plugin：

安装插件：

bash 复制代码

npm install terser-webpack-plugin --save-dev

webpack 配置示例：

bash 复制代码

// webpack.config.js示例
const TerserPlugin = require('terser-webpack-plugin');

module.exports = {
  //...
  optimization: {
    minimize: true,
    minimizer: [
      new TerserPlugin({
        terserOptions: require('./terser.config.js'),
        extractComments: false, // 不生成LICENSE文件
      }),
    ],
  },
};

7. 调试与常见问题

如果代码运行出错，通常是因为mangle或compress配置过于激进，如properties:true可能会破坏代码。你可以逐步放宽选项排查问题。

建议始终开启 sourceMap，方便快速定位问题代码。

8. input.js 与 input.mini.js替换

我们生成了input.mini.js之后, 如何替换呢? 当然你可以手动替换,那样可能会比较复杂,而且容出错.我这边直接是使用了自己写的一个脚本

1. update_js_reference.sh

将html代码中的 input.js替换成 input.mini.js, 代码如下:

bash 复制代码

#!/bin/bash

# 在所有HTML文件中将main.js引用更改为main-mini.js
find  -name "*.html" -type f -exec sed -i '' "s|/static/js/main.js|/static/js/main-mini.js|g" {} \;

echo "已将所有HTML文件中的main.js引用更改为main-mini.js"

2. restore_js_reference.sh

将html代码中的 input.mini.js复原成input.js, 用于继续开发:

bash 复制代码

#!/bin/bash

# 在所有HTML文件中将main-mini.js引用更改回main.js
find -name "*.html" -type f -exec sed -i '' "s|/static/js/main-mini.js|/static/js/main.js|g" {} \;

echo "已将所有HTML文件中的main-mini.js引用更改回main.js"