VSCode多文件夹工作区跨目录查找函数引用失效问题

问题根因 #

• 跨项目检索不到引用：VSCode 内置 JS/TS 语言服务默认以单个项目根目录做上下文隔离，当前工作区下每个业务项目都是独立文件夹，语言服务默认不会跨文件夹构建引用索引；同时各业务项目是从 node_modules 读取私有NPM包的编译产物，没有关联到工作区内的私有包源码，自然无法识别跨项目的同源引用。
• dist 目录排除失效：files.exclude 配置仅控制资源管理器内的文件显示/隐藏，不作用于语言服务的引用检索、全局搜索逻辑，因此即使配置了隐藏dist，引用查找时依然会扫描到目录内的编译产物。

修复操作 #

1. 修正排除规则，覆盖语言服务检索范围 #

在工作区配置的settings节点下，补充search.exclude、javascript.exclude、typescript.exclude三类配置，这三类配置才会控制全局搜索、JS/TS语言服务的扫描范围，同时修正排除规则的匹配范围：

"settings": {
  // 原有其他配置保留，调整files.exclude，删除错误的repositories排除项
  "files.exclude": {
    "**/node_modules": true,
    "**/dist": true
  },
  // 新增：全局文本搜索排除规则
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true
  },
  // 新增：JS语言服务检索排除规则
  "javascript.exclude": {
    "**/node_modules": true,
    "**/dist": true
  },
  // 新增：TS语言服务检索排除规则
  "typescript.exclude": {
    "**/node_modules": true,
    "**/dist": true
  },
  // 其余原有配置保持不变
}

规则前加**/前缀是为了匹配所有层级下的对应目录，避免只排除根目录下的dist、node_modules，子目录内的同名目录依然被扫描。

2. 配置工作区级JS/TS项目配置，打通跨项目索引 #

在工作区根目录（也就是配置里name为Master的根路径）新建jsconfig.json文件（如果项目使用TS则新建tsconfig.json），将所有业务项目源码、私有包源码纳入同一个语言服务上下文，同时配置路径映射让语言服务直接读取私有包源码，而非node_modules内的编译产物，参考配置如下：

{
  "compilerOptions": {
    "target": "es2020",
    "module": "commonjs",
    "checkJs": false,
    "baseUrl": ".",
    "paths": {
      // 将@your-scope/your-private-pkg替换为实际的私有包包名，路径替换为私有包的源码入口相对路径
      "@your-scope/your-private-pkg": ["./repositories/private-pkg/src/index.js"],
      "@your-scope/your-private-pkg/*": ["./repositories/private-pkg/src/*"]
    }
  },
  "include": [
    // 把所有需要参与跨项目检索的业务项目源码目录、私有包源码目录都加入列表
    "./repositories/project_A/src/**/*.js",
    "./repositories/project_B/src/**/*.js",
    "./repositories/project_C/src/**/*.js",
    "./repositories/project_D/src/**/*.js",
    "./repositories/project_E/src/**/*.js",
    "./repositories/project_F/src/**/*.js",
    "./repositories/project_G/src/**/*.js",
    "./repositories/project_H/src/**/*.js",
    "./repositories/project_I/src/**/*.js",
    "./repositories/private-pkg/src/**/*.js"
  ],
  "exclude": [
    "**/node_modules",
    "**/dist"
  ]
}

• 该配置为工作区全局配置，不会覆盖各业务项目自身的jsconfig/tsconfig规则，仅用于给语言服务提供跨项目的索引上下文。
• 路径映射配置生效后，语言服务会直接索引私有包的源码文件，不会再读取各项目node_modules内的私有包编译产物，从根源避免dist目录的无效结果混入。

3. 重启生效 #

配置完成后执行Ctrl+Shift+P（Mac为Cmd+Shift+P）调出命令面板，执行Developer: Reload Window重载窗口，等待语言服务完成全量索引后，再查找引用即可返回全工作区的匹配结果，且不会包含dist目录下的内容。

内容的提问来源于stack exchange，提问作者Grégory L