VSCode多项目需用多根工作区：拖入多个文件夹仅识别第一个；应通过File>Add Folder to Workspace添加并保存为.code-workspace文件，才能在资源管理器中显示所有根文件夹。

多项目打开时，为什么资源管理器只显示一个文件夹？

VSCode 默认以「单根文件夹」模式启动，即使你拖入多个文件夹，它也只会把第一个作为工作区根目录，其余被忽略。这不是 bug，而是设计逻辑：资源管理器天然绑定 workspace 的根路径。

真正支持多项目并存的机制是「多根工作区」（Multi-root Workspace），必须显式创建 .code-workspace 文件才能启用。

• 不要直接拖拽多个文件夹到 VSCode 窗口——这只会打开第一个
• 正确做法：菜单栏选择 File > Add Folder to Workspace...，逐个添加；或先新建空工作区再添加
• 添加后务必保存为 .code-workspace 文件（如 my-projects.code-workspace），否则关闭后配置丢失
• 保存后，资源管理器顶部会显示工作区名称，并列出所有已添加的根文件夹（带图标区分）

如何让不同项目使用各自独立的设置和扩展？

VSCode 的设置分三层：用户级（全局）、工作区级（.code-workspace）、文件夹级（各项目根目录下的 .vscode/settings.json）。多项目管理中，优先级和作用域容易混淆。

One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载

• settings.json 放在某个子文件夹下（如 frontend/.vscode/settings.json），只影响该文件夹及其子目录（比如只对前端项目启用 eslint.enable）
• .code-workspace 中的 settings 字段，作用于整个工作区——适合统一关闭干扰项（如禁用所有项目的 editor.formatOnSave）
• 扩展本身不按项目隔离，但可配合 extensions.ignoreRecommendations + 工作区级 recommendations 控制提示，避免后端项目弹出 React 插件推荐
• 注意：某些扩展（如 Prettier、ESLint）依赖工作区根路径查找配置文件（.prettierrc、eslintrc.js），若跨文件夹生效异常，大概率是它们没在对应项目根目录下

终端、调试、任务默认作用域为什么总“串项目”？

VSCode 的集成终端、调试器、任务（tasks.json）默认基于「活动编辑器所在的文件夹」决定上下文，但这个逻辑在多根工作区里容易失效——尤其当你从一个项目跳到另一个、却没点击其任意文件时。

• 终端默认启动位置是「当前打开文件所属的文件夹」；如果当前无文件打开，则回退到第一个添加的根文件夹
• 调试时，launch.json 必须放在对应项目的 .vscode/ 下，且 cwd 字段要设为 ${workspaceFolder}（不是 ${workspaceFolderBasename}）
• 任务（tasks.json）同理：每个项目应有自己独立的 .vscode/tasks.json，并在其中用 ${fileDirname} 或 ${workspaceFolder} 明确路径变量
• 快捷键 Ctrl+Shift+P > Terminal: Create New Terminal (In Active Workspace) 可强制指定终端归属，避免误开在错误项目下

为什么搜索（Ctrl+Shift+F）会扫到不相关的项目文件？

默认情况下，多根工作区的全局搜索会遍历所有已添加的根文件夹。如果你只关心当前编辑的项目，又不想每次手动排除，就得调整搜索范围逻辑。

• 搜索框右上角的 … 按钮可展开「files to include/exclude」，输入 !backend/** 排除后端项目（但需手动维护）
• 更可靠的做法：在资源管理器中右键某个文件夹 → Find in Folder，此时搜索仅限该子树
• 或者，在搜索框中直接输入路径前缀，如 frontend/src/**.ts，VSCode 会自动限制范围
• 注意：search.exclude 是全局设置，对多根工作区无效；真正起效的是工作区级 files.exclude 和搜索时的临时路径过滤

实际用起来最常被忽略的一点：多根工作区不是“万能胶水”，它不会自动同步各项目的 Git 状态、依赖安装或语言服务配置。每个文件夹仍是独立实体，只是共享一个窗口和部分 UI 上下文。一旦项目间有强耦合（比如 monorepo），建议改用 pnpm workspace 或 nx 等专用工具管理，VSCode 仅作为编辑器配合。