uni-halo/hermes/performance.md

性能与分包规范

1. 分包(微信主包 2M 硬限制)

• 分包目录放 src/pages/ 之外,注册到 vite.config.ts 的 UniPages({ subPackages })
• 低频/独立业务(如 demo、设置二级页)优先进分包
• bundle-optimizer 已启用(仅微信端):支持模块异步跨包调用、组件异步跨包引用,分包间复用代码不需要复制
• 判断该不该分包:页面是否首屏必需?不是 → 分包

2. 构建内置优化(不要重复做)

优化	状态	说明
console/debugger 移除	VITE_DELETE_CONSOLE=true	提交前不用手工删 console
sourcemap	关闭	需要时改 vite.config.ts,勿长期开
minify	esbuild	dev 不压缩、prod 压缩
build target	es6	兼容低版本 WebView

3. 包体积日常检查

pnpm build:h5   # H5 生产构建自动打开 visualizer 分析
# 产物:node_modules/.cache/visualizer/stats.html

小程序端看微信开发者工具的「代码依赖分析」。

4. 编码侧规则

• 静态图片:大图优先网络地址或压缩后放 src/static;SVG 图标走 src/static/my-icons/(i-my-icons-*)
• UnoCSS safelist 只加动态拼接类名,每加一项全量注入,能不用则不用
• 列表页一律 z-paging(虚拟分页),不手写 onReachBottom 加载
• auto-import(src/hooks)按名导入即用;注意 eslint 已关闭 no-unused-vars,未使用导入无守卫,删改代码时自查
• 新增第三方依赖前看体积:小程序端无 tree-shake 保障的库(如全量 UI 库)优先按需引入