VSCode中为特定文件夹分配独立工作空间-VSCode-PHP中文网

“添加文件夹到工作区”不等于创建独立工作空间，因它仅生成临时视图、不保存配置且无.code-workspace文件支撑；真正的工作空间必须通过空窗口下ctrl+shift+p执行“create workspace”命令显式创建，并以.code-workspace文件为唯一识别依据。

vscode中为特定文件夹分配独立工作空间

为什么“添加文件夹到工作区”不等于创建独立工作空间

直接在已打开的单文件夹窗口里点“将文件夹添加到工作区”，只会生成临时视图——关掉窗口就丢失，Ctrl+P 搜不到新加入目录里的文件，调试配置也压根不会加载。这不是工作空间，只是界面叠层。

真正的工作空间必须由 .code-workspace 文件显式定义，它才是 VS Code 识别“多根上下文”的唯一依据。没这个文件，所有设置、调试、搜索都退化为单项目行为。

空窗口是前提：必须先关闭所有文件夹，确保 VS Code 处于无任何打开路径的状态
命令入口唯一：Ctrl+Shift+P → 输入 Workspaces: Create Workspace → 回车
路径选择要按住 Ctrl（Windows/Linux）或 Cmd（macOS）多选，不能逐个添加
保存动作不可跳过：弹出对话框后必须手动指定路径并命名，例如 my-app.code-workspace

如何让每个文件夹拥有自己的 settings.json 和 launch.json

VS Code 的配置优先级是：文件夹级 .vscode/settings.json > 工作区级 .code-workspace 中的 settings 字段 > 用户全局设置。所以想给某个子项目单独配缩进、格式化或调试入口，就得把配置放它自己根目录下的 .vscode 文件夹里。

比如你有 frontend/ 和 backend/ 两个文件夹，希望前端用 Prettier、后端用 ESLint，就不能只在 .code-workspace 里写一个通用规则，而要在各自目录下建 .vscode/settings.json：

{
  "editor.tabSize": 2,
  "editor.formatOnSave": true,
  "prettier.singleQuote": true
}

调试同理：launch.json 必须放在对应子项目的 .vscode 目录中，且 program 路径要用 ${workspaceFolder:Frontend} 这类带名称的变量，而不是硬编码相对路径。

workspaceFolder:name 中的 name 必须和 .code-workspace 里 folders 数组中对应项的 name 字段完全一致
如果没写 name，只写了 path，那 ${workspaceFolder:xxx} 会失效，调试器找不到目标文件
.vscode 文件夹不自动创建，需手动新建，且不能放在工作区根目录，必须放在每个子项目自己的根目录下

保存工作区后，哪些配置会被持久化

.code-workspace 文件本身只存三类东西：文件夹列表、顶层 settings（覆盖所有子项目）、以及可选的 extensions 推荐列表。它不存你打开过哪些文件、终端状态、编辑器分组——这些是 VS Code 自己缓存的，关掉再开可能丢。

VSCode 1.118

微软正式发布 Visual Studio Code 1.118 版本。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控。

下载

真正能随工作区一起复现的，只有你明确写进以下位置的内容：

.code-workspace 文件中的 folders 和 settings
每个子项目根目录下的 .vscode/settings.json
每个子项目根目录下的 .vscode/launch.json（调试）
每个子项目根目录下的 .vscode/tasks.json（构建任务）
每个子项目根目录下的 .vscode/extensions.json（推荐扩展）

注意：files.exclude 和 search.exclude 如果写在 .code-workspace 里，是全局生效的；如果写在某个子项目的 .vscode/settings.json 里，则只对该文件夹起作用——这点常被忽略，导致搜索慢或文件树杂乱。

团队共享工作区时最容易踩的坑

把 .code-workspace 提交到 Git 是好习惯，但硬编码本地绝对路径（比如 "path": "/Users/you/project/backend"）会让别人双击打不开。必须全用相对路径或环境变量。

VS Code 支持 ${env:HOME}、${workspaceRoot}（已弃用）、${workspaceFolder} 等变量，但要注意：

${env:HOME} 在 Windows 上对应 %USERPROFILE%，跨平台安全
${workspaceFolder} 在 .code-workspace 的 folders 里无效，只能用在 launch.json 或 tasks.json 中
别在 .code-workspace 里写 "path": "./backend"，应该写 "path": "backend"——路径是相对于 .code-workspace 文件自身位置解析的
如果工作区文件放在项目外（比如放在 ~/workspaces/），所有 path 值都要从那个位置出发算相对路径