VS Code自动补全提示最长耗时6秒显示问题求助

问题根因 #

该问题由VS Code内置的JavaScript/TypeScript语言服务（tsserver）类型推导性能瓶颈导致：

• 导出Mongoose模型时，tsserver需要自动推导该模型的完整类型定义，而Mongoose的类型系统嵌套层级深、结构复杂，会触发大量递归计算
• 项目存在node_modules目录时，tsserver默认会自动扫描目录下的所有类型定义文件参与推导，进一步放大了计算量，最终导致补全响应延迟
• 数月前无此异常是因为近期版本的TypeScript服务或Mongoose自带类型引入了性能退化bug

可行解决方案 #

• 添加项目配置文件限制索引范围
  在项目根目录新建jsconfig.json文件，写入以下内容，明确排除不需要tsserver索引的目录，限制类型推导范围：

{
  "exclude": ["node_modules", "**/node_modules/*"],
  "typeAcquisition": {
    "enable": true,
    "include": ["mongoose"]
  }
}

如果不需要自动获取第三方包类型，可以把typeAcquisition.enable设为false，性能提升会更明显。

• 修复Mongoose类型冲突
  Mongoose 6.0之后已经内置了官方类型定义，如果你项目中额外安装了@types/mongoose包，执行以下命令卸载即可解决类型重复计算的问题：

npm uninstall @types/mongoose

• 手动指定导出类型减少自动推导开销
  修改models/test.js的导出语句，用JSDoc明确标注导出类型，避免tsserver递归推导模型完整类型：

// 在导出前添加JSDoc注解
/** @type {import('mongoose').Model<{language: string, dates: {created: Date, modified: Date}}>} */
const Test = mongoose.model('Tests', testSchema);
module.exports = Test;

• 优化VS Code内置TS服务配置
  • 升级VS Code到最新正式版，更新内置的TypeScript服务版本修复已知性能bug
  • 触发补全延迟时，按Ctrl+Shift+P（Mac为Cmd+Shift+P）执行TypeScript: Restart TS Server即可快速恢复正常
  • 可以在VS Code设置中搜索typescript.tsserver.maxTsServerMemory，将默认值调整为4096（4GB），避免服务因内存限制触发GC卡顿

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