Node/Django大型项目中VS Code IntelliSense响应缓慢求助

问题概述 #

在大型Node或Python（Django）项目中，VS Code的IntelliSense响应延迟超过7秒。刚打开项目窗口时功能正常，但底部“loading intellisense status”加载完成后，卡顿问题立刻出现，推测由项目体量过大导致。

已尝试的解决方案 #

• 删除所有扩展
• 禁用所有扩展
• 试用VS Code Insiders版本
• 配置基础jsconfig.json
• 配置正确的.gitignore
• 完全重装VS Code

当前jsconfig.json配置 #

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "Node",
    "target": "ES2020",
    "strictNullChecks": true,
    "strictFunctionTypes": true
  },
  "exclude": [
    "node_modules",
    "**/node_modules/*"
  ]
}

针对性优化方案 #

Node项目专属优化 #

1. 细化排除目录
   扩展jsconfig.json的exclude规则，排除构建产物、日志、临时文件等无需分析的目录，缩小语言服务的扫描范围：

   "exclude": [
     "node_modules",
     "**/node_modules/*",
     "dist",
     "build",
     "logs",
     "temp",
     "**/*.min.js",
     "**/coverage"
   ]
   

2. 启用增量缓存
   在compilerOptions中添加增量编译配置，利用TypeScript的缓存机制减少重复分析：

   "compilerOptions": {
     // 原有配置保留
     "incremental": true,
     "tsBuildInfoFile": ".vscode/.tsbuildinfo"
   }
   

3. 调整类型检查策略
   全局关闭JS类型检查，仅对需要的文件通过// @ts-check注释单独启用，降低资源消耗：

   "compilerOptions": {
     // 原有配置保留
     "checkJs": false
   }
   

4. 优化VS Code语言服务设置
   在工作区settings.json中添加以下配置，提升TSServer性能：

   "typescript.tsserver.maxTsServerMemory": "8192",
   "typescript.tsserver.excludeWorkspaceFromAutomaticTypingAcquisition": true,
   "javascript.implicitProjectConfig.checkJs": false
   

Django项目专属优化 #

1. 排除无关Python目录
   在工作区settings.json中配置python.analysis.excludePaths，排除虚拟环境、缓存、迁移文件等：

   "python.analysis.excludePaths": [
     "**/node_modules",
     "**/__pycache__",
     "**/migrations",
     "**/static",
     "**/media",
     "venv",
     ".venv",
     "**/tests/__pycache__"
   ]
   

2. 降低Python语言服务负载
   调整类型检查级别，关闭非必要的自动功能：

   "python.analysis.typeCheckingMode": "basic",
   "python.analysis.autoImportCompletions": false,
   "python.analysis.memory.keepLibraryAst": false
   

3. 配置Django专属设置
   确保Python扩展正确识别Django项目，避免无效扫描：

   "python.analysis.djangoEnabled": true,
   "django.projectRoot": "${workspaceFolder}"
   

通用优化 #

• 拆分工作区：将大型项目拆分为多个子模块，使用VS Code多根工作区功能，仅打开当前开发的模块，减少扫描范围。
• 清理VS Code缓存：定期删除VS Code缓存目录（Windows: %APPDATA%\Code\Cache，macOS: ~/Library/Caches/Code，Linux: ~/.cache/Code），避免缓存堆积。
• 升级硬件：若项目体量极大，升级内存至16G以上可显著提升语言服务运行效率。

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