必须通过“open folder”打开项目根目录，右下角显示“工作区”且在workspace标签页编辑.vscode/settings.json才生效；文件须严格位于根目录、命名小写，仅配置项目专属项如tabsize、search.exclude等。
在 macos 上让 vs code 为每个项目拥有独立的偏好设置，核心是正确使用工作区（workspace）配置，而不是改全局用户设置。关键不在于“怎么点”，而在于“怎么打开、放哪、怎么写”。
必须用“Open Folder”打开项目根目录
这是最常被忽略的前提——VS Code 只有通过 菜单栏 → File → Open Folder…（或快捷键 Cmd+Shift+O）打开整个文件夹时，才会识别并加载该目录下的 .vscode/settings.json。
- 双击单个文件、拖拽文件夹到 Dock 图标、或用 Open File 打开，
.vscode/settings.json完全不会生效 - 打开后看窗口右下角状态栏：显示 工作区（Workspace）才对；若显示“用户”（User），说明没识别成工作区
- 按 Cmd+, 打开设置，右上角切换到 Workspace 标签页——如果空白或提示“未在工作区中”，就是打开方式错了
创建合法的 .vscode/settings.json
文件必须放在项目最外层根目录（即你用 Open Folder 选中的那个文件夹），且路径和命名严格规范：
- 文件夹名必须是
.vscode（全小写，开头带点，不能是VSCode或.VSCode） - 配置文件名必须是
settings.json（全小写，不能是Settings.json或SETTINGS.JSON） - 推荐方式：打开项目后，按 Cmd+Shift+P → 输入并执行 Preferences: Open Workspace Settings (JSON)，VS Code 会自动生成格式正确、带注释模板的文件
只放真正属于项目的配置项
工作区设置不是用户设置的复制粘贴，而是聚焦“这个项目才需要”的内容：
-
适合放的：缩进大小（
"editor.tabSize": 2）、保存自动格式化（"editor.formatOnSave": true）、ESLint 路径（"eslint.workingDirectories": ["./packages/frontend"]）、排除搜索目录（"search.exclude": {"**/dist": true}）、终端环境变量（"terminal.integrated.env.darwin": {"NODE_ENV": "test"}） -
不该放的：主题（
"workbench.colorTheme"）、字体大小（"editor.fontSize"）、窗口缩放（"window.zoomLevel"）——这些是个人习惯，强行统一反而影响体验 - 修改后部分设置需重启窗口（如终端路径、某些扩展开关），可按 Cmd+Shift+P → Developer: Reload Window
进阶：多项目协作与扩展引导
如果项目需要团队快速对齐环境，还可补充两个轻量但关键的文件：
-
.vscode/extensions.json：写入"recommendations"列表，例如["esbenp.prettier-vscode", "ms-python.python"]，新成员打开项目时编辑器会主动提示安装 -
.vscode/tasks.json和.vscode/launch.json：定义构建命令或调试配置，实现“开箱即用”，比如一键启动本地 mock 服务或连接特定数据库 - 所有
.vscode/下的文件都建议提交到 Git（除含密钥等敏感信息的例外），确保团队环境一致
