如何让VSCode中的Clangd仅索引当前打开文件与标准头文件？

核心原因 #

Clangd在Windows环境下默认会扫描整个工作区的所有文件构建索引，即便文件间无任何依赖关系，这是导致操作响应变慢、任务超时的核心原因。以下是针对性的解决方法：

1. 通过.clangd配置文件限制索引范围 #

在工作区根目录（OI文件夹）创建.clangd文件，写入以下配置：

Index:
  Background: false
  # 直接排除所有OJ子目录的文件索引，仅专注当前打开文件
  Skip:
    - "**/Codeforces/*"
    - "**/ATCoder/*"
    - "**/luogu/*"
CompileFlags:
  # 强制启用语法检查模式，跳过不必要的依赖分析
  Add: [-xc++, -fsyntax-only]

2. VSCode工作区设置优化 #

在工作区的.vscode/settings.json中添加以下配置：

{
  "clangd.arguments": [
    "--background-index=false",
    "--pch-storage=disk",
    "--limit-references=0",
    "--limit-results=0"
  ],
  "files.exclude": {
    "**/Codeforces/*.cpp": true,
    "**/ATCoder/*.cpp": true,
    "**/luogu/*.cpp": true
  },
  "search.exclude": {
    "**/Codeforces/*.cpp": true,
    "**/ATCoder/*.cpp": true,
    "**/luogu/*.cpp": true
  }
}

• files.exclude让VSCode不将其他OJ目录的文件暴露给Clangd；
• --limit-references和--limit-results减少不必要的符号搜索，直接提升响应速度。

3. 单文件独立编辑模式 #

如果上述配置仍未解决问题，可直接在VSCode中使用「打开文件」而非「打开文件夹」的方式编辑单个OJ代码文件，此时Clangd只会处理当前打开的文件，完全规避工作区扫描逻辑。

额外优化建议 #

• 更新Clangd至最新版本，旧版本在Windows下的索引逻辑存在性能缺陷；
• 关闭VSCode中其他无关的C/C++类插件，避免功能冲突；
• 清理Clangd缓存：删除Windows默认缓存目录%USERPROFILE%\.cache\clangd后重启VSCode。

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