VS Code仅在Node.js项目中代码提示延迟3-4秒，该如何解决？

常见诱因 #

• TypeScript/JavaScript 内置语言服务（tsserver）负载过高：Node.js 项目依赖包数量多、node_modules 体积过大时，tsserver 需要扫描的文件总量超出常规负载，会直接导致补全响应变慢
• 无效文件被纳入扫描范围：项目内的打包产物、日志文件、缓存目录未配置排除规则，tsserver 会额外消耗资源扫描无业务价值的文件
• Monorepo 多包项目未做扫描范围限制：未在配置中指定仅扫描当前开发的子项目目录时，tsserver 会默认遍历所有子包的代码，运算量陡增
• 插件资源抢占：多个代码补全、语法检查类插件同时运行时，会和内置的 tsserver 抢占 CPU、内存资源，拖慢补全响应速度
• 版本性能缺陷：旧版本 VS Code 内置的 tsserver 存在已知的性能问题，对大项目的扫描优化不到位
• 硬件资源不足：项目体量较大时，如果设备可用内存小于 8G，tsserver 扫描文件过程中容易出现内存占用过高、响应滞后的情况

解决方案 #

• 配置扫描范围规则
  在项目根目录的 jsconfig.json（JS项目）或 tsconfig.json（TS项目）中添加扫描范围配置，示例如下：

{
  "include": ["./src"], // 仅扫描源码目录，Monorepo项目可指定到对应子包目录
  "exclude": ["node_modules", "dist", "build", "logs", "*.log", ".cache"]
}

• 调整 tsserver 内存上限
  打开 VS Code 设置，搜索 TypeScript › Tsserver: Max Ts Server Memory，将默认值调整为 4096 或更高（单位为 MB）。

• 优化插件配置
  仅对当前 Node.js 工作区禁用冗余的补全类、语法检查类插件，保留核心必要插件即可，避免多插件资源抢占。

• 升级相关版本
  更新 VS Code 到最新稳定版，同时将项目本地的 TypeScript 版本升级到最新稳定版，开启 VS Code 设置项 TypeScript › Tsserver: Use Local Tsdk，使用项目本地的 TS 服务获得更好的性能优化。

• 关闭不必要的补全项
  打开 VS Code 设置，关闭 JavaScript › Suggest: Names、JavaScript › Suggest: Paths 等不需要的补全选项，减少 tsserver 的运算量。

• 优化依赖管理
  删除项目中未使用的冗余依赖，可切换使用 pnpm 等轻量化包管理器，大幅减少 node_modules 下的文件数量。

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