VSCode中“文件夹”与“工作区”模式存在本质区别：前者单根、自动加载目录，后者多根、依赖.code-workspace文件，影响设置作用域、调试配置、任务管理及状态恢复。
如果您在使用 VSCode 时发现项目打开方式不同导致功能表现差异，例如扩展行为异常、设置不生效或调试配置缺失，则可能是混淆了“工作区”与“文件夹”两种打开模式。以下是理解二者区别的关键要点：
本文运行环境：MacBook Air，macOS Sequoia。
一、定义与本质差异
VSCode 中的“文件夹”指直接打开单个本地目录，此时编辑器以该目录为根路径加载文件，所有设置（如 .vscode/settings.json）仅作用于该目录及其子目录；而“工作区”是通过一个 .code-workspace 文件定义的显式配置集合，可包含多个不相关的文件夹、专属设置、任务和调试配置，形成逻辑统一但物理分散的开发环境。
1、文件夹模式下，VSCode 自动将所选目录设为工作区根，不会生成 .code-workspace 文件。
2、工作区模式下，VSCode 创建并依赖一个 JSON 格式的 .code-workspace 文件，该文件必须被提交至版本控制以保证团队配置一致。
二、设置作用域的不同表现
在文件夹模式中，用户设置（settings.json）位于 .vscode/ 目录下，仅影响当前文件夹；在工作区模式中，设置可分层定义：既可在 .code-workspace 文件内嵌入 settings 字段覆盖所有加入的文件夹，也可为每个文件夹单独指定 settings 文件路径，实现差异化配置。
1、打开命令面板（Cmd+Shift+P），输入 Preferences: Open Workspace Settings (JSON) 可编辑工作区级设置。
2、在 .code-workspace 文件中添加 "settings": {"editor.tabSize": 2} 将统一影响所有关联文件夹的缩进行为。
三、多根支持与文件夹管理方式
工作区支持多根（multi-root），即在一个 VSCode 窗口中同时加载多个物理位置不同的文件夹，适用于微服务架构或前后端分离项目；而文件夹模式仅允许单根，若需切换目录必须关闭当前窗口并重新打开另一个文件夹。
1、在已打开的工作区中，执行 File > Add Folder to Workspace... 可动态追加新文件夹。
2、右键资源管理器中的任一文件夹，选择 Remove Folder from Workspace 可将其从当前工作区移除而不删除磁盘内容。
四、调试与任务配置的绑定机制
launch.json 和 tasks.json 在文件夹模式中必须置于 .vscode/ 目录下才有效；而在工作区模式中，这些文件可置于 .code-workspace 同级目录，也可为每个文件夹分别配置独立的 .vscode/ 子目录，VSCode 会按优先级合并解析。
1、在工作区中启动调试时，VSCode 优先读取 .code-workspace 文件中 "launchConfigurations" 字段定义的配置。
2、若未定义，则回退查找各文件夹下的 .vscode/launch.json，首个匹配到的有效配置即被启用。
五、状态持久化与窗口恢复逻辑
VSCode 保存窗口状态时，文件夹模式仅记录所打开的单个路径；工作区模式则完整保存 .code-workspace 文件路径及其中声明的所有文件夹、布局、已开启的编辑器标签页和终端会话，重启后能精确还原开发上下文。
1、关闭窗口前确保已保存工作区，执行 File > Save Workspace As... 并指定名称与位置。
2、下次启动时双击 .code-workspace 文件，VSCode 将自动以工作区模式加载，而非作为普通 JSON 文件打开。
