vscode项目级配置默认生效，但需以文件夹形式打开项目且.settings.json置于根目录.vscode下；否则将按用户>默认优先级回退，导致项目配置不生效。
项目级配置不是“额外功能”，而是 VSCode 正常工作的默认层级之一；没配对位置，settings.json 就不会生效。
为什么全局设置在项目里不生效
VSCode 配置有明确优先级：语言特定 > 工作区（即项目）> 用户 > 默认。你在用户级 settings.json 里写了 "editor.tabSize": 2，但当前项目根目录下有 .vscode/settings.json 且里面写了 "editor.tabSize": 4，那编辑器一定用 4——不是它“忽略”你，是它严格按规则走。
- 工作区配置只在打开该文件夹（或工作区文件
.code-workspace）时加载，关掉这个窗口，配置就失效 - 如果用
File > Open Folder打开项目，VSCode 自动识别并启用.vscode/settings.json；但用File > Open直接打开单个文件，则不会触发工作区配置 -
.vscode文件夹必须放在项目**根目录**，嵌套子目录里的同名文件不会被识别
.vscode/settings.json 该写什么
项目级配置的核心原则是：只放和这个项目强相关的、可能与其他项目冲突的设置。比如 Python 解释器路径、ESLint 配置开关、Prettier 是否启用——这些都不该塞进用户级配置。
- 绝对不要写
"editor.fontFamily"或"workbench.colorTheme"这类纯个人偏好的项，它们属于用户层 - 推荐显式声明语言专属设置，例如：
"[typescript]": { "editor.defaultFormatter": "esbenp.pretterr-vscode" } - 路径类配置必须用相对路径或环境变量，比如
"python.defaultInterpreterPath": "./venv/bin/python"，避免写死绝对路径 - 若项目需禁用某插件（如禁用 Prettier 在 Markdown 文件中格式化），用
"markdown.format.enable": false
多项目共存时的常见冲突点
当你同时打开多个文件夹（Multi-root Workspace），VSCode 会合并所有 .vscode/settings.json，但同名键以“最后加载的项目”为准——这容易导致不可预期的行为。
- 检查是否误启用了
"eslint.format.enable": true而项目本身没配 ESLint，结果保存时报错ESLint: No ESLint configuration found - 不同项目用了不同缩进风格（2 vs 4），但共享一个工作区后，
editor.detectIndentation可能被覆盖，导致新文件不按预期缩进 - 终端默认 profile 写在用户级，但某个项目需要特定 shell 启动参数（如
zsh -l -i），就得在该项目.vscode/settings.json里补全"terminal.integrated.profiles.linux"定义
怎么验证项目配置真正在跑
别靠“感觉”，直接看 VSCode 底部状态栏最右侧：那里会显示当前生效的缩进、换行符、编码格式。如果显示的是 LF 和 Tab Size: 4，但你的 .vscode/settings.json 里写的是 "editor.insertSpaces": true, "editor.tabSize": 2，说明配置根本没加载成功。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签页，搜索settings，能看到实际合并后的配置树 - 右键资源管理器顶部的文件夹名 → “Reopen Folder in Workspace”，可强制刷新工作区配置
- 如果改了
.vscode/settings.json没反应，先确认文件编码是 UTF-8，且 JSON 语法合法（VSCode 不报错，但会静默跳过整段）
最容易被忽略的其实是工作区配置的“边界感”：它只管这个文件夹下的文件，不管子模块、符号链接指向的外部路径，也不管你用命令行在哪个目录启动 VSCode —— 启动路径和工作区路径是两回事，搞混这点，配置就永远像在打游击。
