VS Code 的多项目管理依赖 .code-workspace 文件实现真正独立配置：它定义文件夹、扩展、设置等，使项目上下文可序列化复现；需显式创建并保存，避免设置污染，终端/调试/扩展均可按工作区分隔。
VS Code 本身不支持“多项目并行编辑且各自独立配置”的原生模式，所谓“高效管理多个项目”，本质是正确使用 workspace（工作区）机制，而非反复打开多个窗口或依赖插件模拟项目切换。
什么是真正的 VS Code 工作区？
一个 .code-workspace 文件不是快捷方式，而是一个 JSON 配置文件，它明确定义了：包含哪些文件夹、启用哪些扩展、设置哪些 settings.json 覆盖项、保存哪些已打开的编辑器标签。它让“项目上下文”可序列化、可共享、可复现。
常见误区：
– 把多个文件夹拖进同一个窗口 ≠ 创建工作区（这只是多根模式，无持久配置）
– 用 File > Open Folder 打开不同项目 → 每次覆盖上一个，丢失前一个项目的终端/调试/设置状态
正确做法：
– 对每个需长期维护的项目，显式创建专属 .code-workspace
– 用 File > Save Workspace As… 保存，文件名建议含项目名（如 my-api.code-workspace）
– 后续双击该文件，或运行 code my-api.code-workspace，即可完整恢复上下文
如何避免工作区之间设置互相污染？
VS Code 设置分三层：用户级（全局）、工作区级（.code-workspace 内）、文件夹级（某子文件夹下的 .vscode/settings.json）。优先级为：文件夹级 > 工作区级 > 用户级。
关键控制点：
– 在 .code-workspace 的 settings 字段中，只写真正与该工作区强相关的配置，例如：
"eslint.workingDirectories"（指定 ESLint 查找路径）
"python.defaultInterpreterPath"（绑定特定虚拟环境）
"files.exclude"（隐藏该项目特有的构建产物）
– 避免在工作区设置里覆盖通用行为，比如 "editor.tabSize" 或 "files.autoSave" —— 这些应统一放在用户设置中
– 若某子文件夹（如 frontend/）有完全独立的技术栈，可在其内部建 .vscode/settings.json，VS Code 会自动识别并叠加
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
终端、调试、扩展怎么做到“按工作区分离”？
终端和调试器本身不跨工作区共享，但容易被忽略的是：扩展的行为是否受工作区影响。
实操要点：
– 终端：每个工作区启动的终端默认 cwd 是工作区根目录；若工作区含多个文件夹，终端初始路径取第一个文件夹；可通过终端右上角下拉菜单手动切换 cwd
– 调试：所有 .vscode/launch.json 必须放在工作区根目录（或某个文件夹下的 .vscode/），否则无法识别；多根工作区允许为不同文件夹定义不同 launch 配置，用 "cwd" 和 "program" 显式指向对应路径
– 扩展：部分扩展（如 GitLens、Prettier）支持按工作区启用/禁用，在 .code-workspace 中用 "extensions.ignoreRecommendations" 或 "extensions.enabledExtensions" 精确控制；但注意，像 Python、ESLint 这类语言服务扩展，实际生效范围仍取决于你打开的文件路径，而非工作区声明
快速切换与日常维护技巧
频繁切换工作区时，别依赖菜单导航：
– 将常用 .code-workspace 文件放在固定目录（如 ~/code/workspaces/），然后：
macOS/Linux：终端执行 code ~/code/workspaces/my-app.code-workspace
Windows：用 Win+R 输入 code "C:\code\workspaces\my-app.code-workspace"
– 安装官方扩展 Project Manager（作者: alefragnani），它把所有工作区自动索引，用 Cmd+P（或 Ctrl+P）输入 project 即可快速搜索并打开
– 删除旧工作区前，先检查 .code-workspace 文件里的 "folders" 数组是否还存在对应路径 —— VS Code 不校验路径有效性，失效路径会导致工作区加载缓慢甚至报错 Unable to resolve non-existing folder
最常被跳过的细节：工作区文件里的 "folders" 是相对路径还是绝对路径？默认是相对路径（相对于 .code-workspace 文件位置），一旦移动该文件，路径就失效。生产环境建议一律用绝对路径，或确保工作区文件与其管理的项目目录保持固定相对关系。
