VS Code自动补全无法识别tsconfig中自定义导出的node_modules路径

核心问题分析 #

VS Code的TypeScript语言服务未优先读取lib包package.json中的exports配置，而是直接解析源文件目录结构，导致自动补全仍推荐旧路径。以下是针对性解决思路：

1. 启用Node.js规范的模块解析模式 #

在app/tsconfig.json的compilerOptions中，将moduleResolution设为node16或nodenext，这两种模式会严格遵循package.json的exports字段解析路径：

{
  "compilerOptions": {
    "moduleResolution": "node16",
    "baseUrl": ".", // 配合paths必须配置，指定路径基准目录
    "paths": {
      "lib/*": ["node_modules/lib/generated/*"]
    }
  }
}

2. 为lib包配置类型映射 #

如果lib是JavaScript项目，需添加类型声明并配置映射，让TypeScript识别exports对应的类型路径：

• 在lib/generated目录下为每个JS文件创建对应.d.ts文件（如a.d.ts）
• 在lib/package.json中添加类型版本匹配规则：

{
  "typesVersions": {
    "*": {
      "*": ["./generated/*.d.ts"]
    }
  }
}

或直接在exports中指定类型导出：

"exports": {
  "./*": {
    "types": "./generated/*.d.ts",
    "default": "./generated/*.js"
  }
}

3. 调整TS路径为工作区相对路径 #

PNPM工作区中node_modules/lib是软链接到项目根目录的lib文件夹，将paths改为相对路径可让语言服务更准确识别：

"paths": {
  "lib/*": ["../lib/generated/*"]
}

4. 重启VS Code的TypeScript服务 #

修改配置后，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），选择TypeScript: Restart TS Server，强制刷新语言服务。

5. 重新链接PNPM工作区包 #

执行pnpm install重新链接工作区依赖，确保node_modules/lib正确指向项目根目录的lib文件夹，避免语言服务读取错误路径。

内容的提问来源于stack exchange，提问作者Abhirup Pal