必须用Node.js脚本自动扫描:findUnusedComponents.js识别easycom、动态组件及多种命名方式,排除node_modules等目录,生成引用次数报告;findUnusedAssets.js反向搜索资源路径,支持交互式删除并统计释放空间;需结合条件编译识别与分阶段真机验证,因tree-shaking无法处理动态import、副作用导出等逃逸场景。

uni-app 项目里“清理无用资源和代码”不是靠手动翻找,而是必须用工具扫描 + 条件编译兜底 + 分阶段验证。光删掉几个不用的图片或组件文件,90% 的体积和性能问题依然在。
怎么用 Node.js 脚本自动找未使用的 Vue 组件
手动查组件引用容易漏,尤其 easycom 自动引入、动态组件()或 PascalCase/kebab-case 混用时。官方不提供扫描能力,得靠自研脚本:
-
findUnusedComponents.js会递归扫描.vue文件,识别import、components:声明、中的标签名、以及easycom配置项 - 排除目录必须包含
node_modules、.git、unpackage,否则扫描卡死或误报 - 输出报告里带“引用次数”,为 0 的才真可删;有些组件只在条件编译块里使用(比如
#ifdef APP-PLUS),脚本需支持识别这类上下文,否则会错标为“未使用” - 删之前先
git stash或备份,因为部分组件可能被 JS 动态require,脚本无法静态分析到
怎么安全删掉没被引用的图片、音频等资源文件
资源文件不写进 template 或 script 就等于“隐形”,HBuilderX 的“代码检测”完全无效。必须用文件级扫描:
-
findUnusedAssets.js扫描static/和uni_modules/下所有.png、.jpg、.svg、.mp3等后缀文件 - 它会反向搜索整个项目(包括
pages.json、manifest.json、JS/Vue 中的字符串字面量),匹配路径是否出现在src=、url()、require()等位置 - 注意:带变量拼接的路径(如
src="${baseUrl}/icon-${type}.png")无法被准确识别,这类资源要人工核对 - 删除前显示预估释放空间,避免误删共用图标(比如多个页面都用
static/logo.png,但脚本因路径写法差异漏识别)
为什么 tree-shaking 不总生效,哪些代码它根本删不掉
uni-app 的 treeShaking: true 依赖 webpack 的静态分析,但很多常见写法会让模块“逃逸”:
- 通过字符串动态
import()加载的模块(如import(`./pages/${pageName}.vue`))—— webpack 无法确定具体加载哪个文件,整块保留 - 导出对象中存在副作用属性(如
export const utils = { log() {}, __testOnly: true }),即使__testOnly没被引用,整个utils也不会被摇掉 - 第三方库中
require('xxx')写在 try/catch 里,或赋值给全局变量(window.xxx = ...),tree-shaking 直接放弃分析 - Vue 组件的
name选项被用于keep-alive缓存,哪怕组件没被实际渲染,也会被保留
清理后必须验证的三个关键点
删完不验证,等于白干。尤其上线前:
- 检查 H5 端是否意外清掉了
localStorage.setItem('ab_test_group', 'v2')这类手动存储——uni.clearStorageSync()不影响它,但脚本若误删了含该逻辑的 JS 文件,AB 测试就全崩了 - App 端打包后用
adb shell ls /data/data/[package]/files/查看uni.env.USER_DATA_PATH下是否残留大量未清理的下载文件或日志,这些不在脚本扫描范围内 - 小程序分包体积要用微信开发者工具的“代码依赖分析”二次确认,因为
static/下图片被删后,如果某 page.json 的usingComponents还引用着已删组件,会导致分包构建失败但错误提示极隐蔽
真正难的不是“找到无用资源”,而是判断“它到底算不算无用”——动态路径、条件编译、运行时 require、跨端差异化引用,都会让静态扫描失效。每次清理后必须在真机上跑核心路径,而不是只信控制台输出的“已删 127 个文件”。











