核心是精准识别可混淆的identifier:声明类记入作用域,引用类查作用域链决定是否替换,字面量类(如属性名)一律跳过;需隔离作用域生成混淆名、保留源码位置信息以支持sourcemap。

直接上手写 AST 混淆工具,核心不是“能不能解析”,而是“哪些 Identifier 能安全重命名、哪些必须跳过、跳过逻辑怎么嵌进遍历里”。漏掉一个 console 或误改 import 的本地绑定名,生成的代码当场报 ReferenceError。
用 Acorn 解析 + 手动遍历是最可控的起点
别一上来就用 @babel/traverse——它默认做作用域分析,但跳过规则(比如 /* @no-obfuscate */)得自己插进 visitor 里,容易覆盖原始逻辑。Acorn 解析后得到纯 ESTree 标准 AST,你可以完全掌控每个节点的处理时机。
-
acorn.parse(code, { ecmaVersion: 2022, sourceType: 'module' })必须带sourceType: 'module',否则import语句直接 parse 失败 - 遍历推荐用递归函数而非栈模拟:对每个节点先检查是否需跳过,再递归子节点,逻辑更直觉
- 遇到
Program节点时初始化全局作用域栈;进入FunctionExpression或BlockStatement(含let/const)时 push 新作用域对象
Identifier 节点必须分三类处理:声明、引用、不可混淆字面量
混淆失败的绝大多数情况,都源于把 Identifier 当成“名字”统一替换,而没区分它在语法中的角色。例如 obj.name 中的 name 是属性访问字面量,不是变量;import { foo as bar } from './x' 中的 bar 是绑定名,可混淆,但 foo 是导入名,不能动。
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 声明类节点:检查
node.type === 'VariableDeclarator'且node.id.type === 'Identifier',或FunctionDeclaration.id、ArrowFunctionExpression.params—— 这些是 binding,记入当前作用域的nameMap - 引用类节点:先查当前作用域链,调用自定义
getBinding(node.name),若返回{ kind: 'local' }或'param',才用nameMap.get(node.name)替换;若返回kind: 'module'(如 import 绑定)或undefined(如全局console),原样保留 - 字面量类节点:出现在
MemberExpression.property且computed === false时,跳过;出现在ObjectProperty.key且shorthand === false时也跳过
生成混淆名必须隔离作用域 + 避开保留字
用全局计数器生成 _a、_b 看似简单,但父子函数同名变量会被压成同一个混淆名,导致闭包失效。也不能用 Math.random(),那会让构建不可重现。
- 每个作用域对象维护独立
nameMap: Map<string string></string>,键为原始名,值为混淆后名 - 混淆名生成函数接收当前作用域已用名集合,用递增计数器(如
let counter = 0)生成_a、_b…,每次生成前检查是否已存在或是否为 JS 保留字(可用is-reserved-word库) - 不要碰
__proto__、constructor、toString这类特殊属性名,即使它们没被声明为变量——运行时行为可能依赖字面量拼写
注释、空格、SourceMap 不是“附加项”,是生产可用的底线
很多手动 AST 工具生成的代码没法 debug,不是逻辑错,是丢掉了原始位置信息。你改了 node.name,但没同步更新 node.loc 和 node.range,@babel/generator 就无法生成正确 source map。
- 用
@babel/generator生成代码,传入{ retainLines: true, compact: false, sourceMaps: true }选项 - 所有替换操作必须调用
path.replaceWith(newNode)(如果用 babel),或手动新建节点并复制loc、range字段(如果纯 Acorn)——直接赋值node.name = 'xxx'会断掉 source map 映射 - 注释节点(
CommentLine/CommentBlock)保留在原 AST 节点的leadingComments/trailingComments上,别删
真正难的不是遍历和替换,是判断“这个 Identifier 到底算不算 binding”。比如 with 语句里的所有引用都不可靠,eval 内部的变量名根本不能静态分析——这些地方必须强制跳过,哪怕加一行 /* @no-obfuscate */ 注释也比瞎猜强。










