VSCode多根工作区：如何跨文件夹启用TypeScript的「查找所有引用」？

场景 #

我拥有一个VSCode多根工作区，其.code-workspace文件内容如下：

{
    "folders": [
        {
            "name": "root",
            "path": "../"
        },
        {
            "path": "../my_backend"
        },
        {
            "path": "../my_frontend"
        },
        {
            "path": "../my_apicontract"
        }
    ],
    "settings": {
        "files.exclude": {
            "node_modules/": true,
            "my_*/": true
        },
    }
}

其中files.exclude用于整理工作区文件夹，尤其是根文件夹。三个my_...文件夹各对应一个TypeScript模块，my_apicontract作为独立的API契约模块，实现前后端API契约的单一数据源。my_frontend和my_backend的package.json中，均通过file:方式依赖该模块：

// ...
"dependencies": {
    // ...
    "my_apicontract": "file:../my_apicontract"
},
// ...

需求 #

API即将进行多项重大变更，为快速定位受影响的代码，希望在my_apicontract中使用VSCode的「查找所有引用」功能，直接找到前端、后端代码中引用了API契约里所选类型/字段的位置。

问题 #

在my_apicontract中使用「查找所有引用」时，仅能找到模块内部的引用，无法定位到my_frontend或my_backend中的引用；在my_frontend或my_backend中使用该功能时，只能找到当前文件夹和my_apicontract中的引用，无法跨模块查找另一文件夹的引用。

解决配置方案 #

1. 调整TypeScript配置，确保跨模块类型识别 #

• 在.code-workspace文件中添加全局TypeScript配置，统一使用工作区的TypeScript版本，避免语言服务版本不一致：

"settings": {
    // 保留原有配置
    "typescript.tsdk": "./node_modules/typescript/lib",
    "typescript.enablePromptUseWorkspaceTsdk": true
}

• 若使用TypeScript项目引用模式，在my_apicontract的tsconfig.json中添加对前端、后端模块的引用，同时确保每个模块的tsconfig.json的include字段覆盖自身源码路径。

2. 修正files.exclude规则 #

当前files.exclude中的my_*/会隐藏所有my_开头的文件夹，导致VSCode语言服务无法扫描到这些文件夹内的代码。修改规则为仅排除根目录下的my_文件夹（因为已将这些模块单独添加到工作区）：

"files.exclude": {
    "node_modules/": true,
    "../my_*/": true
}

或者直接移除my_*/规则，通过工作区的单独文件夹条目访问这些模块即可。

3. 确保依赖链接正确 #

在my_frontend和my_backend目录下执行npm install（或对应的包管理命令），确保my_apicontract的本地依赖已正确链接，TypeScript能解析到模块的真实文件路径。

4. 重启VSCode加载配置 #

修改完成后，执行「重新加载窗口」命令（Ctrl+Shift+P 选择"Reload Window"），让VSCode重新扫描所有工作区文件，使配置生效。

内容的提问来源于stack exchange，提问作者Hauke P.