如何通过Grunt仅混淆Uglify.js中部分全局变量/函数名

很高兴能帮你搞定这个问题！UglifyJS的混淆功能其实支持非常精细的全局标识符控制，结合Grunt的配置就能实现你要的「只混淆部分全局变量/函数」的需求，下面是两种靠谱的方案：

方案1：保留不需要混淆的全局变量（推荐） #

这种方式最直观——你把不想被混淆的全局变量/函数名列出来，剩下的全局标识符就会自动被混淆。核心是要开启toplevel选项，让Uglify处理全局作用域的内容。

在你的Gruntfile.js里，Uglify的配置可以这么写：

grunt.initConfig({
  uglify: {
    options: {
      mangle: {
        // 开启全局作用域的混淆处理
        toplevel: true,
        // 这里放你需要保留原名的全局变量/函数
        reserved: ['myPublicAPI', 'globalUtilityFunc', 'importantGlobalVar']
      }
    },
    build: {
      files: {
        'dist/bundle.min.js': ['src/**/*.js']
      }
    }
  }
});

配置后，除了reserved数组里的标识符，其他全局变量和函数都会被Uglify自动替换成短名。

方案2：仅混淆指定的全局变量 #

如果你的需求是反过来——只混淆特定的几个全局标识符，其余全部保留，那可以用自定义名称缓存的方式来实现。步骤如下：

1. 先创建一个名称映射缓存，手动指定要混淆的变量对应的新名称：

// 自定义要混淆的全局变量/函数的名称映射
const nameCache = {
  vars: {
    "internalGlobalVar": "a",
    "hiddenUtilityFunc": "b"
  }
};

2. 在Grunt的Uglify配置里引用这个缓存，同时设置相关规则：

grunt.initConfig({
  uglify: {
    options: {
      mangle: {
        toplevel: true,
        // 使用我们自定义的名称缓存
        nameCache: nameCache,
        // 保留未在缓存中指定的函数名
        keep_fnames: true,
        // 确保缓存里的原名称不会被意外保留（结合reserved反向控制）
        reserved: Object.keys(nameCache.vars).concat(['otherGlobalToKeep'])
      }
    },
    build: {
      files: {
        'dist/bundle.min.js': ['src/**/*.js']
      }
    }
  }
});

这种方式适合你明确知道要混淆的变量列表，且数量不多的场景。

关键注意点 #

• 一定要开启toplevel：Uglify默认不会处理全局作用域的标识符，必须显式开启这个选项才能让全局变量混淆生效。
• 验证混淆结果：配置完成后一定要测试混淆后的代码功能，尤其是涉及全局变量交互的部分，避免因为混淆导致依赖断裂。
• 多文件一致性：如果你的项目有多个源文件，reserved列表要在所有文件中保持一致，防止出现未定义的错误。

内容的提问来源于stack exchange，提问作者Oliver Goossens