VS Code自动导入仅支持最近打开文件？React/JS开发遇索引问题

VS Code确实依赖**TypeScript语言服务（TSLS）**的文件索引与缓存机制来提供自动导入、文件移动后路径自动更新这类智能功能，你遇到的问题就是索引未及时同步导致的。

问题根源 #

TSLS会在后台扫描项目文件构建索引，但以下情况会导致索引滞后：

• 项目文件数量较多时，后台扫描不及时，未被索引的模块无法触发自动导入提示；
• jsconfig.json/tsconfig.json配置不全，比如include字段未覆盖所有业务文件，TSLS不知道要扫描这些文件；
• 文件移动、新增后，TSLS的缓存未自动刷新，导致路径更新不生效。

而打开对应文件或手动保存操作会强制触发局部索引更新，所以此时能正常触发自动导入或路径更新。

解决办法 #

• 完善项目配置文件：在项目根目录创建或修改jsconfig.json（JS项目）或tsconfig.json（TS/React项目），确保include字段覆盖所有需要索引的文件，示例：

  {
    "compilerOptions": {
      "baseUrl": "./src"
    },
    "include": ["src/**/*"],
    "exclude": ["node_modules", "dist"]
  }
  

• 重启TS语言服务：打开命令面板（快捷键Ctrl+Shift+P或Cmd+Shift+P），输入TypeScript: Restart TS Server，强制刷新整个索引缓存；
• 清理VS Code缓存：关闭VS Code后，删除项目根目录下.vscode文件夹（仅缓存项目相关配置，不会删除代码），或者清理全局VS Code缓存目录（Windows：%APPDATA%\Code\Cache；Mac：~/Library/Caches/Code；Linux：~/.cache/Code），重启后重新构建索引；
• 排查干扰扩展：暂时禁用非核心扩展（比如一些小众的代码格式化、语法检查扩展），排查是否有扩展干扰TSLS的正常工作。

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