如何让VSCode在TypeScript Monorepo项目中正常使用自动导入功能

VS Code 内置的 TypeScript 语言服务默认仅会扫描当前 TS 配置文件覆盖范围内的文件，你的场景下有3个常见触发点：

• common 包的 package.json 没有配置正确的入口、类型声明字段，TypeScript 语言服务无法快速定位到 common 包的导出内容位置
• 你没有配置 Monorepo 维度的 TS 路径别名或者项目引用，语言服务的扫描范围仅局限在 server 包内部，不会主动识别父目录下的 common 包导出符号
• 如果你的项目根目录没有统一的 tsconfig.json，VS Code 会默认使用单个包的 TS 配置作为工作区配置，进一步缩小了可扫描的文件范围

你可以按照以下顺序配置，完成后即可触发正常的自动导入提示：

1. 配置 common 包的入口字段
   在 packages/common/package.json 中新增入口配置，让 TS 语言服务可以直接定位到导出的源文件：

{
  "name": "common",
  "main": "./src/main.ts",
  "types": "./src/main.ts",
  "exports": {
    ".": "./src/main.ts"
  }
}

2. 配置 TypeScript 项目引用（推荐，适配 Monorepo 场景）

• 首先在项目根目录新增 tsconfig.json，统一管理所有子包的引用关系：

{
  "files": [],
  "references": [
    { "path": "./packages/common" },
    { "path": "./packages/server" },
    { "path": "./packages/client" }
  ]
}

• 给 common 包的 tsconfig.json 开启复合模式，支持项目引用：

{
  "compilerOptions": {
    "composite": true,
    // 保留你原有的其他配置
  },
  "include": ["src/**/*"]
}

• 在 server 包的 tsconfig.json 中添加对 common 包的引用：

{
  "compilerOptions": {
    // 保留你原有的其他配置
  },
  "references": [{ "path": "../common" }],
  "include": ["src/**/*"]
}

如果你不想使用项目引用，也可以选择在 server 包的 tsconfig.json 中直接配置路径别名，效果一致：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "common": ["../common/src/main.ts"]
    },
    // 保留你原有的其他配置
  },
  "include": ["src/**/*", "../common/src/**/*"]
}

3. 重启 TS 语言服务
   配置完成后按下 Ctrl+Shift+P，选择「TypeScript: 重启 TS 服务器」，等待加载完成后即可正常触发跨包自动导入。

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