import type { Dayjs } from 'dayjs';
// tsconfig.json
"verbatimModuleSyntax": true
npx vite build --mode production

打包分析里有一个只用来标注类型的日期库整包进了首屏,gzip 后 180KB。源码那一行是 import { Dayjs } from 'dayjs',名字只出现在参数类型上。这类现象通常不是突然出现的,往前翻半天日志能看到苗头。

追下去是这么回事:普通 import 会被当成运行时依赖保留,即使导入的名字只出现在类型位置。打包器判断不了它有没有副作用,只能整包打进去,加上 type 关键字后整行在编译阶段被擦掉。

「import type 擦除」改完先别急着全量,挑一台机器放半天,真有问题这段时间就能看出来。同类问题如果隔一段时间又出现,多半是某个定时任务或重启流程把改动冲掉了。

把这次用到的命令存进笔记,比记住结论有用,换个环境还能照着走。

处理上按这个顺序:把只用于类型的导入统一改成 import type;打开 verbatimModuleSyntax 让编译器提示;用 lint 规则批量修 存量一次清完;改完再看产物分析 确认那块消失。

确认没问题再收工,产物里搜不到那个库的代码 首屏体积回到原来的量级 类型提示仍然正常。

作者 9823189