VS Code中TypeScript路径映射下Intellisense自动导入失效问题

我碰到过好几个开发者遇到这个问题——路径映射（别名）配置好之后手动导入完全正常，但输入类名时Intellisense的自动导入提示灯泡就是不出现，咱们一步步排查解决：

1. 先确认路径映射配置的准确性 #

首先打开项目根目录下的tsconfig.json（JS项目用jsconfig.json），重点检查compilerOptions里的baseUrl和paths配置：

{
  "compilerOptions": {
    "baseUrl": "./", // 这个要和你的项目结构匹配，比如如果源码都在src下就设为"./src"
    "paths": {
      "@shared-vb/*": ["../shared/vb/*"] // 注意前后的通配符*必须对应，确保能匹配到目标目录下的所有文件
    }
  },
  "include": ["src/**/*", "../shared/vb/**/*"], // 务必把目标共享目录加入include，让TS编译器能扫描到它
  "exclude": ["node_modules"]
}

关键注意点：baseUrl是路径映射的基准，paths的通配符要严格对应，而且include必须包含../shared/vb目录，否则TypeScript根本不会解析该目录下的文件，Intellisense自然拿不到类型信息。

2. 强制刷新VS Code的TS/JS服务缓存 #

VS Code有时候会缓存旧的配置，导致新的路径映射不生效：

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server（JS项目选JavaScript: Restart JS Server），回车执行；
• 如果还不行，直接关闭VS Code，删除项目根目录下.vscode文件夹里的缓存文件（保留settings.json即可），再重新打开项目。

3. 确保使用项目本地的TypeScript版本 #

VS Code自带的全局TS版本可能和你项目本地安装的版本不一致，导致配置解析逻辑有差异：

• 点击VS Code右下角的TS版本号（比如5.1.6），选择Use Workspace Version，切换到项目本地安装的TS版本。

4. 检查目标文件的导出格式 #

确认vb-sessioninfo.ts的导出方式符合Intellisense的识别规则：
如果是默认导出：

export default class VbSessionInfo {
  // 类内容
}

如果是命名导出：

export class VbSessionInfo {
  // 类内容
}

注意：如果导出有语法错误，或者导出名称和你输入的不一致，Intellisense也无法匹配到。

5. 排查插件和VS Code设置冲突 #

• 暂时禁用所有第三方代码插件（比如自定义路径别名插件、某些格式化插件），重启VS Code后测试是否恢复正常；
• 打开VS Code设置（Ctrl+,/Cmd+,），搜索typescript.suggest.autoImports，确保这个选项是开启状态（默认开启，但可能被误关）。

如果以上步骤都试过还是没解决，可以尝试删除node_modules文件夹，重新执行npm install或yarn install，再重复步骤2刷新服务。

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