VSCode通过.code-workspace文件实现多项目隔离管理，该JSON文件显式声明文件夹、扩展、任务等配置，避免多根视图导致的插件失效和环境混淆。
VSCode 本身不支持传统意义上的“多项目并行打开”（比如同时打开两个独立的 package.json 根目录且各自有完整语言服务），但通过 Workspace（工作区）机制可以安全、隔离地管理多个项目，避免配置冲突和语言服务器混乱。
什么是 .code-workspace 文件？
它是一个 JSON 配置文件，显式声明一组文件夹（"folders"）、推荐扩展（"extensions"）、任务（"tasks"）和调试配置（"launch"）。与单纯“打开多个文件夹”不同，它把多个项目绑定为一个逻辑单元，且每个文件夹保持独立的语言服务上下文。
常见误操作：直接拖拽多个文件夹到 VSCode 窗口 → 这会创建“多根文件夹视图”，但没有持久化配置，重启后丢失，且某些插件（如 ESLint、Prettier）可能因根目录模糊而失效。
- 正确做法：菜单栏 File → Save Workspace As…，保存为
my-project.code-workspace - 该文件可提交到 Git（但建议排除
"settings"中的用户级路径或 token） - 打开时双击该文件，或命令面板运行
Workspaces: Open Workspace from File…
多个项目共存时如何隔离 Node.js / Python 环境？
VSCode 不自动识别每个文件夹下的 node_modules 或 venv；必须显式配置 "settings" 按文件夹生效。
在 .code-workspace 的 "settings" 下，用 "[javascript]"、"[python]" 等语言标识符做条件配置：
{
"folders": [
{ "path": "frontend" },
{ "path": "backend" }
],
"settings": {
"[javascript]": {
"eslint.workingDirectories": ["./frontend"],
"typescript.preferences.importModuleSpecifier": "relative"
},
"[python]": {
"python.defaultInterpreterPath": "./backend/.venv/bin/python",
"python.formatting.provider": "black"
}
}
}
- 不要在全局设置里写
python.defaultInterpreterPath，否则所有项目共享同一解释器 -
eslint.workingDirectories必须是相对路径（从 workspace 根开始），且需对应实际存在的文件夹 - 如果某个文件夹没配语言特定设置，它会回退到用户设置，容易引发 lint 或格式化错乱
为什么有些插件在多文件夹工作区里不生效？
根本原因是插件的激活事件（activationEvents）未匹配当前上下文。例如：editorLangId == 'typescript' 只在打开 .ts 文件时激活，而如果你只打开了文件夹但没打开任何 .ts 文件，TypeScript 插件就不会加载其语言功能。
- 检查插件文档是否明确支持
workspace模式（如ESLint支持，GitLens支持，但部分老旧插件不支持） - 在
.code-workspace的"extensions"字段中列出必需插件，提示团队成员安装一致版本 - 若插件仍异常，尝试在对应文件夹内打开一个源文件（如
index.ts），强制触发激活
最易被忽略的是：工作区设置中的路径必须相对于 .code-workspace 所在位置，而不是某个子文件夹——一旦搞错层级，python.defaultInterpreterPath 就会指向不存在的位置，而错误提示往往只显示“找不到 Python 解释器”，不会告诉你路径解析失败的具体原因。
