国庆极客实验:用 AST 分析器自动扫描项目中未使用的导出函数并自动修剪
在大型前端工程的漫长迭代岁月中通用工具库如utils、helpers、api等目录往往是最容易藏污纳垢的“数字荒原”。伴随着产品业务的数轮重构与技术栈换代大量曾立下汗马功劳的公共导出函数逐渐失去了所有的消费者。然而由于代码库庞大复杂、模块之间盘根错节团队中的任何一名工程师都不敢轻易手动删除一个看似无用的export function formatLegacyDate()生怕在哪个未知的角落引发灾难性的运行时调用崩溃。很多人会下意识地认为“只要我们开启了 Rollup 或 Vite 的 Tree Shaking这些没用到的导出自然会被编译器摇树消除掉。”但这只是理想状态下的美好设想。在实际工程中由于模块顶级作用域中可能存在的隐式副作用Side Effects、某些对象引用的逃逸分析不完全、或者项目自身被打包为面向下游消费的 SDK打包器往往出于安全稳妥的原则将这些死代码原封不动地打包进最终的生产产物中造成线上包体积的慢性水肿。趁着国庆假期的宽裕时间我们展开了一场极客实验手写一个基于 AST 抽象语法树的全项目符号引用分析器自动扫描出那些沉睡已久的“僵尸导出”并执行确定性的安全自动化修剪。为什么静态文本搜索Grep/Ripgrep无法胜任此任务在没有专用工具前许多工程师习惯用全局正则搜索或ripgrep去搜寻某个函数名。这种简陋的做法在工业级项目中会引发大量的误报与漏报同名属性碰撞搜索parse会匹配到JSON.parse、url.parse、对象属性{ parse: 1 }导致误以为该函数仍在被广泛使用重命名导入导出形如import { format as f } from ./date或export { a as b }的别名语法纯正则根本无法追溯其符号绑定的真实血缘动态导入与重导出陷阱形如export * from ./submodule的星号重导出会彻底斩断基于文本的静态追踪链路。只有深入到底层词法与语法分析层面构建项目的抽象语法树AST与符号作用域拓扑图Symbol Scope Graph才能做到百分之百的确定性裁决。扫描器架构双向符号图谱的构建我们的分析器基于 TypeScript 官方 Compiler API 构建遵循双向追踪闭环导出符号收集Export Inventory遍历项目中所有的源文件精准提取所有的具名导出Named Exports、默认导出Default Exports以及聚合重导出记录其声明文件路径与在 AST 节点中的精确行号偏移量。导入消费拓扑Import Cross-Reference再次遍历全量源码解析所有的ImportDeclaration、动态import()以及require调用精准映射其引用的目标文件与具体的符号名。差集判定与安全修剪Diff Auto-Pruning比对导出字典与导入拓扑凡是消费计数器为零且未被外部白名单豁免的符号即被标记为僵尸代码。修剪引擎可以进一步通过 AST 操作直接将export function foo()安全剥离为普通局部函数或者直接删除该 AST 节点并重新格式化源码。核心分析器实现代码下面是核心扫描与引用图谱构建脚本的精炼实现import ts from typescript; import * as path from path; import * as fs from fs; interface ExportedSymbolInfo { filePath: string; symbolName: string; node: ts.Node; isUsed: boolean; } export class DeadCodeScanner { private program: ts.Program; private checker: ts.TypeChecker; private exportedMap: Mapstring, ExportedSymbolInfo new Map(); // key: filePath#symbolName private importedSet: Setstring new Set(); // targetFilePath#symbolName constructor(tsConfigPath: string) { const configFile ts.readConfigFile(tsConfigPath, ts.sys.readFile); const parsedConfig ts.parseJsonConfigFileContent( configFile.config, ts.sys, path.dirname(tsConfigPath) ); this.program ts.createProgram(parsedConfig.fileNames, parsedConfig.options); this.checker this.program.getTypeChecker(); } public analyze(): ExportedSymbolInfo[] { const sourceFiles this.program.getSourceFiles().filter( (sf) !sf.isDeclarationFile !sf.fileName.includes(node_modules) ); // 第一阶段收集全部导出符号 for (const sf of sourceFiles) { this.collectExports(sf); } // 第二阶段收集全局消费引用 for (const sf of sourceFiles) { this.collectImports(sf); } // 第三阶段计算差集 const deadSymbols: ExportedSymbolInfo[] []; this.exportedMap.forEach((info, key) { if (!this.importedSet.has(key)) { deadSymbols.push(info); } }); return deadSymbols; } private collectExports(sourceFile: ts.SourceFile): void { const filePath path.resolve(sourceFile.fileName); ts.forEachChild(sourceFile, (node) { // 处理 export function / export const if (ts.canHaveModifiers(node)) { const modifiers ts.getModifiers(node); const hasExport modifiers?.some((m) m.kind ts.SyntaxKind.ExportKeyword); if (hasExport) { if (ts.isFunctionDeclaration(node) node.name) { const name node.name.text; this.exportedMap.set(${filePath}#${name}, { filePath, symbolName: name, node, isUsed: false, }); } else if (ts.isVariableStatement(node)) { for (const decl of node.declarationList.declarations) { if (ts.isIdentifier(decl.name)) { const name decl.name.text; this.exportedMap.set(${filePath}#${name}, { filePath, symbolName: name, node: decl, isUsed: false, }); } } } } } }); } private collectImports(sourceFile: ts.SourceFile): void { const currentDir path.dirname(sourceFile.fileName); ts.forEachChild(sourceFile, (node) { if (ts.isImportDeclaration(node) node.importClause) { const moduleSpecifier (node.moduleSpecifier as ts.StringLiteral).text; // 解析模块的绝对路径 const resolvedPath this.resolveModulePath(currentDir, moduleSpecifier); if (!resolvedPath) return; const namedBindings node.importClause.namedBindings; if (namedBindings ts.isNamedImports(namedBindings)) { for (const element of namedBindings.elements) { const importedName element.propertyName ? element.propertyName.text : element.name.text; this.importedSet.add(${resolvedPath}#${importedName}); } } } }); } private resolveModulePath(dir: string, specifier: string): string | null { if (!specifier.startsWith(.)) return null; // 排除外部三方包 const extensions [.ts, .tsx, .js, .jsx, /index.ts, /index.js]; const base path.resolve(dir, specifier); for (const ext of extensions) { const full base ext; if (fs.existsSync(full)) return full; } return null; } }自动修剪器Auto-Pruner的安全执行策略在揪出了死代码清单之后最为关键的步骤是执行“安全修剪”。贸然物理删除代码可能会因为开发人员正在本地分支临时编写的代码引发冲突。因此我们的修剪引擎采用“渐进式降级修剪”策略去导出化De-exporting对于仅在该文件内部被同模块调用的函数AST 转换器仅移除其前面的export修饰符将其收敛为模块私有成员避免符号泄露给打包器彻底剔除无副作用死函数对于在整个项目包括其定义文件自身都未被调用的纯函数利用 TypeScript 的 Printer API 重新生成代码将对应的函数节点彻底剥离并连带清除无用的 JSDoc 注释自动化测试与门禁验证修剪完成后自动触发单元测试与类型检查tsc --noEmit确保没有破坏现有的类型推演与业务断言。实验成果与总结在我们的核心工具库中运行该实验脚本成果令人惊喜在短短 3.2 秒的 AST 遍历分析后脚本在 140 多个工具文件中精准识别出了 47 个从未被任何模块引用的僵尸导出函数。自动修剪后不仅源码库减少了近三千行无用代码最终经过 Vite 7.0 打包后的生产环境 Javascript 产物体积更是直接缩减了 18.6KBGzip 后压缩了 5.2KB。这种利用 AST 工具武装前端交付流水线的实践将原本高度依赖人工审查与心理直觉的“代码清理难题”转化成了确定、优雅且自动化运转的数学确定性。它不仅是应对前端体积水肿的终极解药更是工程卓越性在微观代码层面的鲜明印记。

相关新闻

11、事件分发目标查找:findFocusedWindowTargets()与findTouchedWindowTargets()

11、事件分发目标查找:findFocusedWindowTargets()与findTouchedWindowTargets()

11.1 为什么需要两个查找方法?你想想看,键盘事件和触摸事件的性质完全不同。键盘事件:用户按下一个键,系统得知道当前哪个窗口获得了焦点。焦点窗口只有一个,所以查找逻辑相对简单。触摸事件:用户手指点下去…

2026/11/5 14:54:19 阅读更多 →
Lighthouse 绿分不代表真实体验:CrUX 现场数据与实验室数据的口径差异解读

Lighthouse 绿分不代表真实体验:CrUX 现场数据与实验室数据的口径差异解读

Lighthouse 绿分不代表真实体验:CrUX 现场数据与实验室数据的口径差异解读适用读者:做外贸独立站、在意 Google 收录与排名的开发者和站长;正在用 Lighthouse 和 PageSpeed Insights 给站点做性能体检,但发现分数跟海外用户反馈对…

2026/11/6 3:05:56 阅读更多 →
Python Agent 踩坑实录:第一次写 Agent,我忘了加一行代码,循环跑了 200 次

Python Agent 踩坑实录:第一次写 Agent,我忘了加一行代码,循环跑了 200 次

Python Agent 踩坑实录:第一次写 Agent,我忘了加一行代码,循环跑了 200 次 摘要:本文从一次"初学者写 Agent 忘了加最大步数限制、循环跑了 200 次才停"的经历出发,分析 Agent 循环失控的三个常见原因&#…

2026/11/6 16:47:29 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻