vs code 管理大型项目应使用 multi-root workspace：通过 file → add folder to workspace… 添加子目录并 save workspace as… 生成 .code-workspace 文件；搜索需用路径过滤、文件类型限制和关闭正则；跨项目引用可通过 npm link 或直接加入工作区+tsconfig 路径映射解决。
VS Code 管理大型项目，核心不是“打开整个文件夹”，而是用 Multi-root Workspace（多根工作区）精准组织逻辑边界；盲目全局搜索 Ctrl+Shift+F 容易漏结果或卡死，得靠路径过滤、文件类型限制和正则控制。
怎么创建真正有效的多根工作区
直接把多个项目文件夹拖进 VS Code 窗口，看似方便，但不会生成可复用的 .code-workspace 文件——下次打开就丢失结构。必须通过菜单显式创建：
- 选择 File → Add Folder to Workspace… 逐个添加关键子目录（如
frontend、backend、shared-utils） - 添加完毕后，立刻执行 File → Save Workspace As…，存为
my-project.code-workspace - 该文件本质是 JSON，可手动编辑：在
folders下加"path": "../infra"引入外部目录，在settings下配"files.watcherExclude"避免监听node_modules或构建产物
搜索时为什么 Ctrl+Shift+F 总是找不到东西
默认搜索会遍历所有已加载文件，但大型项目里常有三类干扰：
-
node_modules、dist、.git目录未排除，导致超时或结果淹没 - 想查 React 组件但搜到了同名的测试文件（
.test.tsx），没限定后缀 - 搜索字符串含特殊字符（如
props?.user?.name），被当正则误解析
正确做法是：在搜索框右上角点 files to include 输入 src/**/*.{ts,tsx}，点 files to exclude 填 **/node_modules/**,**/dist/**,**/*.test.*，再关掉 Use Regular Expression 图标（除非真需要）。
如何快速定位跨工作区的引用关系
VS Code 的 Go to Definition（F12）默认只在当前工作区生效。若 shared-utils 是独立仓库且作为 npm 包安装，跳转会失败——因为源码不在工作区里。
- 方案一：用
npm link或yarn link把本地包软链进node_modules，再在.code-workspace的settings中加："typescript.preferences.includePackageJsonAutoImports": "auto"
- 方案二：不装包，直接把
shared-utils文件夹加入工作区，然后在tsconfig.json的"paths"中映射别名（如"@utils/*"→"../shared-utils/src/*"） - 两种方式都需重启 TS 服务：按
Ctrl+Shift+P→ 输入Restart TS server
多根工作区不是“多开几个文件夹”的快捷方式，它的价值在于让 settings、extensions（比如只在 backend 启用 Python 插件）、tasks 和 debug configurations 按子项目隔离。一个没配置 launch.json 的前端子目录，不该被后端的调试器干扰——这点容易被忽略，直到某天断点全失效才回头翻文档。
