必须写自定义 webpack 插件，在 resolveid 钩子中匹配 locale 路径并重定向至空模块，再于 load 钩子返回 'export default {};'，否则 tree-shaking 无法剔除未用语言包。
能移除，但不能靠 Webpack 自带功能，必须写自定义插件拦截 resolveId 阶段，对 /locale/xxx.js 类路径做白名单过滤。直接配 TerserPlugin 或开启 tree-shaking 没用——语言包是按文件加载的，不是按导出项引用的。
为什么 tree-shaking 对 locale 文件完全无效
Tree-shaking 依赖 ESM 静态分析导出与导入关系，而语言包通常以独立模块形式被显式引入：import 'dayjs/locale/zh-cn' 或 require('ant-design-vue/lib/locale-provider/zh_CN')。Webpack 把每个 locale 文件当作一个“有副作用”的完整模块，只要被 require/import 就保留，不会分析内部是否真被使用。
- 即使你只用了
zh-CN，import 'dayjs/locale/*'全量写法会让所有 locale 被打包 -
sideEffects: false在 package.json 里对第三方 locale 目录不生效（你改不了人家的配置） - 动态
require()或字符串拼接路径（如require(`./locale/${lang}`)）会彻底关闭静态分析
核心思路：在 resolveId 钩子中重定向非白名单 locale
Webpack 插件的 resolveId 是模块路径解析的入口，此时还能干预“这个路径最终加载哪个文件”。我们在这里匹配 locale 路径，把非白名单语言包重定向到一个空模块，让后续构建流程“加载了但什么也没做”。
- 匹配正则建议用：
/[\/](locale|locales|lang|language)[\/][a-z_-]+.js$/i，覆盖moment/locale、element-plus/lib/locale等常见结构 - 白名单语言要统一转小写比对，避免
ZH-CN和zh-cn被判为不同 - 返回
{ id: ' virtual:empty-locale', external: true }是关键：virtual:前缀防止真实路径冲突，external: true避免被当作未解析模块报错
load 钩子里必须提供空模块内容
如果只在 resolveId 里重定向，Webpack 进入 load 阶段时找不到 virtual:empty-locale 的内容，会报 Module not found 错误。必须补上 load 实现：
load(id) {
if (id === ' virtual:empty-locale') {
return 'export default {};';
}
}
- 返回空对象即可，部分库（如 antd）会尝试读取
locale.name，所以不能返回undefined或空字符串 - 不要用
export {}，ESM 要求至少一个命名导出或默认导出 - 如果项目用了 TypeScript，确保该虚拟模块不参与类型检查（它本就不该有类型）
注意 Vite 用户别套用这个方案
这份插件逻辑专为 Webpack 设计，Vite 的插件机制和钩子名完全不同（比如用 resolveId + load，但返回格式和生命周期语义有差异）。Vite 用户应参考其官方插件示例，或直接复用知识库中已验证的 localePrunePlugin（它基于 Vite 的 resolveId 和 load 实现，且已处理大小写、路径斜杠兼容等问题）。
最易被忽略的一点：插件必须放在 webpack.config.js 的 plugins 数组里，且要在 NormalModuleReplacementPlugin 之类可能提前介入 locale 路径的插件之后执行——顺序错了会导致拦截失效。
