最有效方式是在导出层重命名并显式控制。使用 export { x as y } 让 ide 精准识别新语义，禁用 export default 并统一命名导出，通过 api.ts 构建“导出防火墙”，配合静态检查堵住引用扩散漏洞。
直接在导出层做重命名和显式控制，是提升 IDE 重构质量、限制变量引用扩散最有效的方式。它不改源码逻辑，却能让类型提示更准、重命名范围更可控、误用路径更难发生。
用 export { x as y } 让 IDE 精准识别新语义
当把内部函数 getData 重命名为对外接口 fetchUserProfile 时，IDE（如 VS Code + TypeScript）会自动将新名纳入类型索引。调用方 import 后获得的补全、跳转、重命名建议都基于 fetchUserProfile，而不是原始名。
- 导入写法保持简洁：
import { fetchUserProfile } from './api'，无需额外赋值或包装 - 重命名操作只影响该导出名，不会波及
getData在模块内的所有使用点 - TypeScript 的
.d.ts声明文件需同步更新导出项，否则 IDE 仍显示旧名——这是常见疏漏点
禁用 export default，强化重构边界感
默认导出容易被随意重命名（如 import api from './api' → import xxx from './api'），导致 IDE 无法建立稳定引用链，重命名时可能漏掉某些别名用法。
- 统一使用命名导出：
export const validateOrderInput、export function submitOrderFlow() - 这样 IDE 能准确追踪所有
import { validateOrderInput }的位置，重命名时一键覆盖全部 - 配合 ESLint 规则
import/no-default-export，从工程规范上杜绝默认导出
通过顶层 api.ts 构建“导出防火墙”
把所有业务能力收口到一个 src/api/index.ts，只从这里 re-export 经过筛选的函数。IDE 对这个文件的引用分析就代表了整个模块的“合法出口”，反向依赖自然受限。
- 底层工具函数（如
./utils/deepClone.ts）不直接暴露，避免被跨域调用 - 可在导出前加轻量包装：
export const submitOrder = wrapWithMetrics(submitOrderRaw) - 构建时启用
noUnusedExports，自动剔除未被api.ts引用的导出项，防止“悄悄暴露”
配合静态检查堵住引用扩散漏洞
仅靠语法不能阻止运行时反射或深层路径导入（如 import { helper } from './core/helper'），必须叠加工具链约束。
- 用
depcheck或自定义 AST 扫描，在 CI 中报出非法跨模块引用（例如 reporting 模块直接引入 payment 内部 utils） - 在
tsconfig.json中配置"compilerOptions": { "noImplicitAny": true, "forceConsistentCasingInFileNames": true }，减少因大小写或类型模糊引发的误引用 - 对关键模块添加
declare module '@/core/*' { export {} }，显式封锁未授权导入路径
