重命名 typescript/javascript 库中的导出类后，即使源码已更新、lsp 能正确跳转，仍出现“export not found”错误——根本原因通常是构建产物未被彻底清理，导致旧导出签名残留。
重命名 typescript/javascript 库中的导出类后，即使源码已更新、lsp 能正确跳转，仍出现“export not found”错误——根本原因通常是构建产物未被彻底清理，导致旧导出签名残留。
在使用 Nx 构建的本地库中，类重命名失败（如从 Foo 改为 Bar）却仍报错 export 'Bar' was not found in 'FooLib'，是一个典型的构建缓存与产物不一致问题。虽然 VS Code 的语言服务（LSP）能识别新名称并支持“Go to Definition”，但这仅说明 TypeScript 类型检查器读取了最新源码；而运行时导入依赖的是实际打包输出（如 dist/ 下的 .d.ts 和 .js 文件），而非源文件本身。
关键原因：构建产物未同步更新
Nx 默认启用增量构建和缓存机制。当你仅修改类名但未触发完整重建时：
-
dist/目录中旧的index.d.ts仍声明export class Foo； - 对应的
index.js仍导出Foo（甚至可能因缓存未重新生成）； - 因此
import { Bar } from 'FooLib'在运行时和类型检查时均失败——前者因实际无Bar导出，后者因.d.ts缺失该符号。
正确解决步骤（Nx 环境）
执行以下命令确保完全清除旧产物并强制全量重建：
# 1. 清理整个 workspace 缓存（推荐） npx nx reset # 2. 删除目标库的 dist 输出目录（替换 `foo-lib` 为你的库名） rm -rf libs/foo-lib/dist # 3. 重新构建该库（--skip-nx-cache 确保不读缓存） npx nx build foo-lib --skip-nx-cache # 4. 在应用项目中重新链接（若为本地 npm link 或 workspace 依赖） npx nx build foo-lib --watch # 开发时可启用热重载
✅ 验证是否成功：检查
libs/foo-lib/dist/index.d.ts是否包含export declare class Bar，且dist/index.js中有exports.Bar = Bar（CJS）或export { Bar }（ESM）。
补充注意事项
-
不要仅删
node_modules：node_modules中的FooLib是构建产物副本，其内容由nx build决定；单纯重装不会更新它。 -
避免
tsc --build混用：Nx 库应统一使用npx nx build，而非直接调用tsc，否则会绕过 Nx 的路径映射与打包逻辑。 -
检查
tsconfig.lib.json：确认"declaration": true已启用，否则.d.ts不生成，导致类型导入失败。 -
IDE 缓存：VS Code 可能缓存 TS 语言服务状态，执行
Ctrl+Shift+P → "TypeScript: Restart TS server"可强制刷新。
完成上述操作后，import { Bar } from 'FooLib' 将正常工作，且类型提示、运行时行为完全一致。记住：在 Nx 工作区中，“改名 → 重建 → 重链接”是原子操作，缺一不可。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
