VS Code工作区设置优先级高于全局设置，应将项目专属配置（如Python解释器路径、格式化规则）写入项目根目录的.vscode/settings.json并提交Git；全局settings.json仅用于个人通用偏好，避免路径硬编码导致跨项目冲突。
直接在项目根目录建 .vscode/settings.json，VS Code 就会自动按项目加载它——这是唯一可靠、可 Git 提交、且不干扰其他项目的做法。
为什么不能改用户级 settings.json？
改全局 settings.json（比如 $HOME/.config/Code/User/settings.json）会让所有项目共用一套配置。比如你给 A 项目设了 "python.defaultInterpreterPath": "./venv/bin/python"，结果 B 项目没这个路径，调试直接报错 Command 'python' not found；更麻烦的是，团队成员拉代码后根本不知道要手动配什么，协作成本陡增。
.vscode/settings.json 必须满足的三个硬条件
工作区配置不是写完就生效，它有明确的加载前提：
- 必须以文件夹形式打开项目：用
code /path/to/my-project或 VS Code 内 File → Open Folder…，状态栏显示 Folder: my-project 才算成功 -
.vscode/settings.json文件名必须全小写，大小写错误（如Settings.json或.VSCode）会导致 VS Code 完全忽略 - JSON 格式必须合法：少个逗号、多层引号嵌套错误、注释（
//）都会让整个文件静默失效——VS Code 不报错，但配置不生效
Python 项目最常配的几项实操建议
不是所有设置都适合放工作区，下面这些是高频、安全、且对协作友好的典型项：
立即学习“Python免费学习笔记（深入）”；
-
"python.defaultInterpreterPath"：务必用相对路径，比如"${workspaceFolder}/.venv/bin/python"（Linux/macOS）或"${workspaceFolder}/.venv/Scripts/python.exe"（Windows），避免硬编码绝对路径 -
"python.linting.pylintArgs"：直接内联规则，例如["--disable=C0114,C0115", "--max-line-length=88"]，比单独维护.pylintrc更轻量、更易追踪 -
"python.analysis.extraPaths"：当项目有本地模块或子包无法跳转时，填入源码路径，如["src", "lib"]，而不是把整个虚拟环境路径塞进去 -
"[python]"块里的格式化开关：比如"editor.formatOnSave": true和"editor.codeActionsOnSave": {"source.organizeImports": "explicit"}，这类语言专属设置支持工作区覆盖
真正容易被忽略的点是：VS Code 并不“理解” Python 项目结构，它只认 .vscode/settings.json 是否存在、是否合法、是否在正确路径下。哪怕你装了 Pylance、Black、Pylint，只要这个文件没被识别，所有配置都等于没写。
