VSCode通过.code-workspace文件实现多文件夹统一管理，而非同时打开多个根目录；它以JSON格式记录文件夹路径、分层设置、扩展推荐等，支持按优先级覆盖配置，并需合理规避性能与功能边界问题。
VSCode 本身不支持传统意义上的“多项目并行打开”，但通过工作区（Workspace）机制，可以高效管理多个关联文件夹——关键不是同时打开多个根文件夹，而是把它们组织进一个 .code-workspace 文件里。
什么是 VSCode 工作区（.code-workspace）
工作区是 VSCode 的配置容器，本质是一个 JSON 文件，记录了哪些文件夹被纳入、各文件夹的设置覆盖项、推荐扩展、任务和调试配置等。它不是“打开多个窗口”，而是把多个文件夹当作一个逻辑项目来统一管理。
- 直接双击
myproject.code-workspace就能加载全部文件夹和专属设置 - 每个文件夹可单独启用/禁用，右键文件夹 →
Remove Folder from Workspace - 工作区设置（
settings.json中的"folders"和"settings"段）优先级高于用户设置，低于文件夹内.vscode/settings.json
如何创建和编辑多文件夹工作区
不要用“文件 → 打开文件夹”逐个添加——那样只会切换根目录。正确路径是：先关闭所有文件夹，再通过命令面板初始化工作区。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Workspaces: Add Folder to Workspace... - 依次添加需要的文件夹（如
./backend、./frontend、./docs） - 执行
Workspaces: Save Workspace As...，保存为myproject.code-workspace - 之后修改工作区结构，直接编辑该文件：里面
"folders"是路径数组，"settings"可写跨文件夹生效的通用配置（比如统一禁用某 linter）
多文件夹下设置冲突怎么处理
不同文件夹可能有同名配置（如 eslint.enable），VSCode 按“工作区 → 文件夹 → 用户”三级覆盖。容易出问题的是语言特有设置（如 "[typescript]": { "editor.formatOnSave": true }）在工作区中写错位置。
- 全局生效的设置（如主题、字体大小）写在工作区
"settings"顶层 - 只对某个文件夹生效？在对应文件夹内建
.vscode/settings.json，内容如{"editor.tabSize": 2} - 语言专属设置必须放在工作区
"settings"的"[language-id]"块里，不能直接写"editor.formatOnSave"—— 否则对所有语言生效 - 检查实际生效值：打开任意文件，按
Ctrl+,，搜索目标设置项，右侧会显示“Workspace (Remote)”、“Workspace”、“Folder” 等来源标识
常见误操作与性能隐患
加太多文件夹不等于更好管理，反而可能拖慢搜索、Git 集成和扩展响应。
- 避免把
node_modules、build/、dist/所在文件夹直接加入工作区——它们应由各自文件夹的.gitignore和.vscode/settings.json中的"files.exclude"控制 - Git 面板默认只显示当前活动文件夹的变更。如需跨文件夹查看，安装扩展
GitLens或启用实验性设置："git.autoRepositoryDetection": "subFolders"（但会增加扫描开销） - 调试多个服务？别在一个
launch.json里硬塞所有配置。推荐用compound启动组合，或改用tasks.json+ 终端分组管理
真正麻烦的不是怎么加文件夹，而是哪些不该加、哪些设置该放哪一层、以及 Git 和调试这类功能在多根下的行为边界——这些地方没配对，工作区反而比单文件夹更难维护。
