导出层重命名是语义重构最轻量安全的方式，通过export { x as y }映射对外名称，不改动原始代码，零运行时影响，支持渐进迁移与类型自动关联。
直接在导出层重命名，是语义重构最轻量、最安全的方式。它不碰原始变量名和实现逻辑，只调整对外暴露的名称，既保持内部一致性，又提升外部可读性与兼容性。
核心原理：导出层做“贴标签”动作
export { x as y } 不是重定义，而是映射。x 仍是原变量，只是别人导入时看到的名字变成 y。整个过程发生在编译/打包阶段，对运行时零影响。
- 原始代码完全不动：函数名、变量名、注释、单元测试都不需改
- 接口契约被主动升级：比如把模糊的 getData 改为明确的 fetchUserProfile
- 向后兼容可控：可并行导出新旧名，逐步迁移，再择机下线旧名
典型应用场景与写法
常见于工具模块、API 封装层或跨团队共享包中，目标是让调用方一眼理解用途。
- 消除歧义：export { parseJson as safeParseJson } —— 明确提示该函数做了错误兜底
- 统一命名风格：export { calculateTotal as calcTotal } —— 匹配项目中已有的缩写习惯
- 适配下游约定：export { defaultConfig as APP_CONFIG } —— 满足某框架要求的大写常量名
- 聚合导出时梳理语义：从多个文件汇总后重命名，避免同名冲突或含义混杂
配合导入端使用更高效
导出重命名后，导入端可同步简化调用，无需额外转换逻辑：
- import { fetchUserProfile } from './api'; // 直接用新名，语义清晰
- 不再需要 import { getData } from './api'; const fetchUserProfile = getData;
- 类型定义（如 TypeScript）会自动关联到新名，IDE 提示更准确
注意事项
这个语法简单，但几个细节决定是否真正“无副作用”：
- 不能用于默认导出的重命名（export default … as y 是非法语法），需用 export { default as y }
- 重命名后的名称必须是合法标识符，不能含空格、特殊符号或保留字
- 若模块同时支持 CJS 和 ESM，确保构建工具（如 Vite、Webpack）正确处理具名导出映射
- 文档和类型声明文件（.d.ts）需同步更新导出名，否则使用者看到的仍是旧名
