.code-workspace 文件保存四个关键字段：folders（必填路径数组）、settings（工作区级配置，语言专属设置需嵌套如"[typescript]"）、extensions（recommendations推荐列表）、launch和tasks（调试与任务配置，非必需但高频使用）。
`.code-workspace` 文件保存哪些关键字段
它不是快捷方式，而是一个可提交、可复现的 JSON 配置快照。核心保存四类信息，缺一不可：
-
folders：必须项，数组结构，每个元素含path（相对或绝对路径）和可选name（用于调试变量如${workspaceFolder:frontend}） -
settings：工作区级覆盖配置，优先级高于用户设置但低于单文件夹内.vscode/settings.json；语言专属设置如"[typescript]": { "editor.formatOnSave": true }必须写在这里，不能扁平写editor.formatOnSave -
extensions：仅含recommendations字段，列出团队推荐安装的扩展 ID（如"esbenp.prettier-vscode"），不自动安装，只触发提示 -
launch和tasks：非必需但高频使用，定义调试配置（支持compounds联调）和可运行任务；它们不会继承自子文件夹，必须显式写入该文件或通过.vscode/launch.json等文件在对应文件夹下提供
为什么改了 settings 却没生效
常见现象是修改了 .code-workspace 的 settings，但打开 TypeScript 文件时格式化仍不触发。根本原因是配置层级错位：
- 把
"editor.formatOnSave": true写在settings顶层 → 对所有语言生效，但 TypeScript 语言服务可能忽略它 - 正确写法是嵌套进语言 ID 块：
"[typescript]": { "editor.formatOnSave": true }，VSCode 才会将其注入 TS 语言服务器 - 如果某个文件夹内已有
.vscode/settings.json，且其中也定义了"[typescript]"块，则以该文件夹设置为准（优先级更高） - 验证是否生效：打开任意 .ts 文件，Ctrl+, → 搜索 formatOnSave → 右侧显示 “Workspace” 来源即表示已加载
终端默认路径为什么总进错文件夹
VSCode 启动终端时默认进入第一个 folders 数组项的路径，而不是你当前打开的文件所在文件夹。这常导致 npm run dev 报错“command not found”。
- 解决办法不是删掉其他文件夹，而是调整
folders数组顺序：把最常用、需频繁开终端的项目放在首位 - 或者手动在终端里执行
cd ../backend切换，但更可持续的方式是在该文件夹下建.vscode/settings.json，写入"terminal.integrated.cwd": "${workspaceFolder}" - 注意：
terminal.integrated.cwd无法在工作区settings顶层直接设为动态值（如${workspaceFolder:backend}），必须写在对应文件夹的本地settings.json中
工作区文件能提交到 Git 吗？要注意什么
可以且应该提交，但有三个硬性约束：
- 路径必须用相对路径（如
"path": "frontend"），禁用绝对路径（如/Users/me/project/frontend），否则别人拉下来打不开 -
settings里避免写机器相关配置，例如"python.defaultInterpreterPath"或"git.path"，这些应交给用户本地设置或通过 devcontainer 处理 - 别把
.vscode/tasks.json或.vscode/launch.json直接塞进.code-workspace—— 它们体积大、易冲突，应保留在各自文件夹下，由 VSCode 自动发现 - 提交前检查：双击该文件，在干净的 VSCode 空窗口中打开，确认所有文件夹能加载、无红色警告、终端路径合理
实际使用中最容易被忽略的是 folders 数组顺序对终端和默认工作上下文的影响，以及语言专属设置必须嵌套声明——这两点不满足，90% 的“配置不生效”问题就已埋下。
