工作区设置（.vscode/settings.json）优先级高于用户设置，会自动覆盖同名配置；修改后部分设置需重启窗口才生效，且应提交到仓库以保障团队一致。
工作区设置和用户设置到底谁生效？
工作区设置（.vscode/settings.json）优先级高于用户设置（全局设置），只要项目根目录下存在 .vscode 文件夹且含 settings.json，VSCode 就会自动加载并覆盖同名的用户设置。这不是“可选行为”，而是默认机制——不需要额外启用或配置。
常见误判是改了用户设置后发现项目里没变化，其实是因为工作区设置里写了同名项，比如用户设置了 "editor.tabSize": 2，但项目里写了 "editor.tabSize": 4，最终生效的是后者。
- 检查当前生效设置：按
Ctrl+,（Win/Linux）或Cmd+,（macOS）打开设置界面，右上角切换到 Workspace 标签页，就能看到哪些设置来自工作区 - 想快速确认某项是否被工作区覆盖：在设置搜索框输入关键词（如
files.exclude），带 “(Workspace)” 标记的就是当前项目生效的值 - 删除工作区设置后不会自动回退到用户设置的旧值——它会回退到 VSCode 默认值，除非你手动删掉
.vscode/settings.json里的对应字段
如何为项目生成标准的 .vscode/settings.json
别手写空文件再填参数。最稳的方式是：打开项目根目录 → 打开命令面板（Ctrl+Shift+P）→ 输入并执行 Preferences: Open Workspace Settings (JSON)。VSCode 会自动生成带注释模板的 settings.json，且确保路径正确、格式合法。
直接编辑 .vscode/settings.json 是唯一可靠方式；通过图形界面点选设置再保存，有时会意外写入用户设置而非工作区（尤其当没主动切到 Workspace 标签时）。
- 常用项目级配置示例（可直接复制进
settings.json）：{ "editor.tabSize": 2, "files.exclude": { "**/node_modules": true, ".next": true }, "eslint.enable": true, "prettier.requireConfig": true } -
files.exclude和search.exclude区别明显：files.exclude影响资源管理器显示，search.exclude控制全局搜索范围，两者需分开配 - 敏感配置（如
git.ignoreLimit或调试器路径）尽量只在必要项目中显式声明，避免污染其他项目
多根工作区（Multi-root Workspace）怎么管不同子项目的设置？
当你用 File > Add Folder to Workspace... 加入多个文件夹，VSCode 会生成一个 .code-workspace 文件。这个文件本身不存编辑器设置，但它可以指定每个文件夹的专属设置路径，靠的是 "folders" + "settings" 组合。
不能指望在 .code-workspace 里直接写 "editor.fontSize": 14 —— 这种顶层设置会被所有文件夹继承，起不到“独立”作用。真要差异化，必须为每个子项目维护自己的 .vscode/settings.json。
- 推荐结构：
my-workspace.code-workspace ├── project-a/ │ └── .vscode/settings.json ← 管 project-a ├── project-b/ │ └── .vscode/settings.json ← 管 project-b
- 如果某个子项目需要特殊插件支持（如 Rust 的
rust-analyzer），在它的.vscode/extensions.json里声明，比全局装一堆插件更干净 - 注意：
.code-workspace文件里的"settings"字段只影响整个工作区层面的行为（如"workbench.startupEditor": "none"），和单个项目编辑器行为无关
为什么改了 settings.json 没反应？几个高频卡点
不是所有设置都能热更新。有些字段修改后必须重启窗口（Developer: Reload Window），尤其是涉及语言服务、文件监听或插件初始化的配置，比如 "typescript.preferences.importModuleSpecifierEnding" 或 "emeraldwalk.runonsave"。
- 检查文件编码：确保
.vscode/settings.json是 UTF-8 无 BOM，否则可能解析失败（VSCode 不报错，但静默忽略整个文件） - 路径别写错：
"files.associations"中的 glob 模式区分大小写（Linux/macOS 下），"*.jsx"不会匹配Component.JSX - 插件设置优先级更高：比如 Prettier 插件的
"prettier.semi"会覆盖"editor.insertSpaces"的效果，这类冲突得看具体插件文档 - Git 忽略别漏掉：
.vscode/应该提交到仓库（除非含密钥等敏感信息），但很多人把它加进了.gitignore，导致团队成员拉代码后根本没工作区设置
.vscode」——而不是靠记忆在不同项目间手动切设置，或者把所有东西堆进用户设置里硬扛。
