关键在于启用 Terser 的 keep_fnames 配置并确保具名函数被显式引用：Vite 中设 terserOptions.keep_fnames = true，Webpack 中在 TerserPlugin 里配置；仅对具名函数表达式和函数声明生效，需配合 JSDoc @export 或导出赋值防止内联删除，构建后验证 name 属性是否保留。
关键在于让混淆工具明确识别“这个函数名是公开接口的一部分”，而不是当作临时变量或可内联的局部逻辑。具名函数表达式（const fn = function myName() { }）中的 myName 是内部名称，Terser 等工具默认会抹掉它——除非你主动告诉工具：这个名不能动。
对 Terser（Vite/Webpack 默认）启用 keep_fnames
这是最直接有效的配置项，专为保护函数内部名称设计：
- Vite 中，在
vite.config.ts的构建选项里开启：build: { minify: 'terser', terserOptions: { keep_fnames: true } } - Webpack + TerserPlugin：在插件配置中加入
new TerserPlugin({ terserOptions: { keep_fnames: true } }) - 注意：
keep_fnames对箭头函数、匿名函数、方法简写（{ init() {} }）完全无效，只作用于具名函数表达式和函数声明
用 JSDoc @export 标记关键函数
某些构建链（如 Closure Compiler 或支持 JSDoc 的 Rollup 插件）会将 /** @export */ 视为导出信号，强制保留名称：
- 写法示例：
/** @export */<br>const validate = function validateForm(data) { return data?.length > 0; }; - 该注释能辅助工具建立“此名需暴露给外部环境”的语义，尤其适合被插件系统、框架钩子（如 Vue 的
methods）动态调用的函数
避免触发内联优化的写法
Terser 在 --compress 模式下可能把未被引用的具名函数表达式直接内联并擦除原名。要防止这点：
- 确保函数至少被一次显式调用或赋值到导出对象上，例如：
export const handlers = { onSubmit: function onSubmit(e) { ... } }; - 不要只声明不使用：
const init = function init() {}; // ❌ 未被引用，极易被删名甚至整个移除 - 若函数仅用于内部逻辑且无需调试追踪，可改用匿名函数；若需保留堆栈可读性或外部反射访问，则必须配合
keep_fnames+ 显式引用
验证是否生效的实操方式
构建后立刻检查 dist 文件，别等上线：
- 搜索原始内部名（如
validateForm），确认它仍以明文出现，而非变成a或_0xabc123 - 在浏览器控制台执行：
typeof yourModule.validateForm === 'function'，并查看yourModule.validateForm.name是否仍为"validateForm" - 若返回
""或"a"，说明keep_fnames未生效，或函数被提前内联/删除，需回查引用链与压缩配置
