VSCode如何管理多个项目_使用工作区有何技巧【教程】

vscode通过.code-workspace文件支持多项目并行编辑，它可跨磁盘路径声明多个根文件夹，统一管理配置、任务与调试环境，且不污染项目目录；而直接打开文件夹仅为单文件夹工作区，设置保存在.vscode/settings.json中。

VSCode 本身不支持传统意义上的“多项目并行编辑”，但通过 工作区（Workspace） 可以高效组织多个相关文件夹、配置和任务——这不是简单打开多个窗口，而是让一组项目共享一套设置、扩展行为和调试上下文。

什么是 .code-workspace 文件，它和直接打开文件夹有啥区别？

直接打开一个文件夹时，VSCode 创建的是「文件夹工作区」，所有设置保存在该文件夹下的 .vscode/settings.json 中；而 .code-workspace 是一个独立的 JSON 文件，显式声明多个根文件夹，并可覆盖全局/文件夹级配置。

关键区别在于：

• .code-workspace 支持跨磁盘路径（比如同时包含 C:/proj/backend 和 D:/proj/frontend）
• 它能统一管理 tasks、launch、extensions 推荐列表（extensions.recommendations）
• 关闭后重新打开，会还原所有已打开的编辑器标签和终端会话（前提是没勾选「在新窗口中打开」）
• 它不会污染任一项目目录——.code-workspace 文件可放在任意位置，比如专门建个 ~/workspaces/ 目录统一管理

如何正确添加多个文件夹到一个工作区？

别用「文件 → 添加文件夹到工作区」反复点——这容易误操作成嵌套子文件夹或重复添加。推荐方式是手动编辑 .code-workspace 文件：

先通过「文件 → 将工作区另存为…」生成一个基础文件，然后用文本编辑器打开它，修改 "folders" 数组：

{   "folders": [     { "path": "../my-api" },     { "path": "../my-web" },     { "path": "../shared-utils" }   ],   "settings": {     "editor.tabSize": 2,     "files.exclude": { "**/node_modules": true }   } }

注意：

• 路径是相对于 .code-workspace 文件所在位置的相对路径，不是绝对路径（除非你明确写 "path": "/full/path/to/project"）
• 不要在 "folders" 里混用相对和绝对路径，VSCode 会报错 Invalid workspace configuration: folder path must be a String
• 如果某个文件夹暂时不想加载，可以加 "mask": true 字段（VSCode 1.86+ 支持），它仍显示在资源管理器中但不索引文件、不触发文件监听

工作区设置（settings）怎么优先级生效？

VSCode 设置有明确优先级链：全局 .code-workspace .vscode/settings.json。但很多人踩坑在以为工作区设置能覆盖所有子文件夹——其实不能。

例如你在 .code-workspace 里写了 "eslint.enable": false，但某个子文件夹里有 .vscode/settings.json 写了 "eslint.enable": true，那这个文件夹仍会启用 ESLint。

真正想「强制统一」某些行为，得用：

• "settings" 下加 "[javascript]": { "editor.formatOnSave": true } 这类语言专属配置
• 把共用配置抽成 .vscode/settings.json 放在每个子项目根目录（配合脚本同步）
• 用 "settings" + "files.watcherExclude" 避免某文件夹触发大量文件系统事件（比如 "**/dist/**"）

为什么我的工作区终端总在第一个文件夹下启动？

VSCode 终端默认继承「活动编辑器所在文件夹」的 cwd（当前工作目录）。如果你没打开任何文件，它就取 "folders" 数组里的第一个路径。

解决办法很直接：

• 右键资源管理器里的某个文件夹 → 「在集成终端中打开」
• 快捷键 Ctrl+Shift+P → 输入 Terminal: Create New Terminal (In Active Workspace Folder)
• 在 .code-workspace 的 "settings" 里加 "terminal.integrated.defaultProfile.windows": "git bash" 等，只改 shell 类型，不改路径

没有「为每个文件夹绑定独立默认终端」的内置机制——这是设计限制，不是 bug。如果真需要隔离环境（比如不同项目用不同 Node 版本），得靠 direnv 或 nvm use 这类 Shell 层工具，在终端启动时自动切换。