如何配置VS Code的TypeScript IntelliSense搜索指定外部路径的类？

1. 配置tsconfig.json的baseUrl和paths #

仅添加include不足以让IntelliSense正确识别外部库，需结合baseUrl和paths定义模块别名，同时精确指定要纳入类型检查的文件范围。

修改typescript/myproject/tsconfig.json：

{
  "compilerOptions": {
    "baseUrl": ".", // 以当前tsconfig所在目录为基准路径
    "paths": {
      "@lib/*": ["../../@lib/typescript/src/*"] // 为外部库路径设置别名
    },
    // 保留你原有的编译配置，示例如下
    "target": "ESNext",
    "module": "CommonJS",
    "strict": true,
    "esModuleInterop": true
  },
  "include": [
    "./**/*", // 包含当前项目所有文件
    "../../@lib/typescript/src/**/*" // 精确包含外部库src目录下的所有文件
  ],
  "exclude": [
    "node_modules"
  ]
}

2. 完善工作区配置（如果使用.code-workspace文件） #

确保myproject.code-workspace明确包含外部库目录，让VS Code将其纳入工作区索引：

{
  "folders": [
    {
      "path": "." // 当前项目目录
    },
    {
      "path": "../../@lib/typescript" // 外部库目录
    }
  ]
}

3. 重启TypeScript服务 #

配置修改后，需要让VS Code重新加载TypeScript服务以生效：

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）
• 输入并选择TypeScript: Restart TS Server

4. 测试自动提示 #

现在在main.ts中输入Logg，IntelliSense会自动提示Logger类，且可自动导入为：

import { Logger } from '@lib/logger';

原配置无效的原因 #

• include路径若仅写../../@lib/typescript，可能包含非src目录的冗余文件（如编译产物、node_modules），导致TypeScript解析混乱，精确指定src/**/*更可靠。
• 未配置paths和baseUrl时，TypeScript无法将外部路径识别为可解析模块，IntelliSense无法生成自动提示。

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