VS Code如何配置仅在指定用户源码文件夹内执行重构操作

F2重命名这类语义重构操作的扫描逻辑不受全局搜索的search.exclude规则控制，相关扫描范围由当前项目所用语言的语言服务接管，以下是可直接落地的配置方式，适配Ubuntu 22.04环境下的VS Code 1.68.1版本：

通用跨语言配置 #

• 配置files.watcherExclude规则：该配置会让VS Code文件监听、索引系统直接忽略指定目录，所有语言服务做重构扫描时默认不会读取被排除的文件，和仅作用于全局搜索的search.exclude不同，这个规则对重构场景生效。
  打开VS Code的settings.json，添加需要排除的目录即可，如果只需要扫描include和src，把项目下其他所有非源码目录（构建产物、依赖、文档、缓存目录等）都加入排除列表，示例配置：

  "files.watcherExclude": {
    "**/.git": true,
    "**/build": true,
    "**/out": true,
    "**/node_modules": true,
    "**/third_party": true,
    "**/docs": true,
    "**/scripts": true
  }
  

C/C++项目精准配置（适配include/src目录结构） #

提到include、src目录基本是C/C++项目，这类项目可以直接通过对应语言服务的配置实现精准的目录白名单，比通用排除法效率更高：

• 如果你使用微软官方C/C扩展（ms-vscode.cpptools）：
  按Ctrl+Shift+P打开命令面板，选择「C/C: Edit Configurations (JSON)」，修改配置中的浏览路径，仅保留需要扫描的源码目录即可，示例：

  {
    "configurations": [
      {
        "name": "Linux",
        "includePath": [
          "${workspaceFolder}/include",
          "${workspaceFolder}/src"
        ],
        "browse": {
          "path": [
            "${workspaceFolder}/include",
            "${workspaceFolder}/src"
          ],
          "limitSymbolsToIncludedHeaders": true
        }
      }
    ],
    "version": 4
  }
  

  配置后C/C++语言服务的符号索引只会覆盖include和src目录，F2重命名时不会遍历其他目录文件。
• 如果你使用clangd作为语言服务：
  在项目根目录新建.clangd配置文件，添加如下规则限定索引范围：

  Index:
    Background: Build
    ExcludePatterns:
      - "*"
    IncludeFilterRegex: "^(./include|./src)/.*"
  CompileFlags:
    Add: ["-I", "./include"]
  

生效说明 #

配置完成后执行「Developer: Reload Window」命令重载VS Code窗口，等待语言服务按照新规则完成首次索引，后续重构操作就不会全量遍历项目下所有文件了。如果是Python、Java等其他语言项目，逻辑一致，找到对应语言扩展的索引范围配置项，限定到指定源码目录即可，不需要依赖全局搜索的排除规则。

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