必须提交.pylintrc、pyproject.toml（或.flake8）和.vscode/settings.json三个配置文件，才能实现团队代码风格统一；仅靠.vscode/settings.json无法定义规则细节，且易因插件版本、python环境或路径配置差异导致行为不一致。
直接在 VSCode 里点设置开关，没法让团队代码风格真正统一——规则必须写进可提交的配置文件，且工具链要对齐。
为什么 .vscode/settings.json 单独存在没用
它只能控制“谁来格式化”和“什么时候触发”，但不定义“怎么算对”。比如 "editor.formatOnSave": true 开了，如果没配 .prettierrc 或 pylintrc，VSCode 根本不知道该把 print( "hello" ) 改成 print("hello") 还是保持原样。
- 不同人装的插件版本可能不一致：
esbenp.prettier-vscodev12 默认关分号，v11 可能开，导致保存后格式来回跳 -
.vscode/settings.json里写死路径（如"python.defaultInterpreterPath"）或个人偏好（如"files.autoSave"），会破坏跨环境一致性 - 终端里运行
flake8报错但编辑器不标红？说明python.linting.flake8Enabled没生效，或flake8没被正确识别为项目依赖
必须提交到 Git 的三个核心文件
它们构成“打开项目就自动按同一套规则跑”的最小闭环：
-
.pylintrc：定义检查逻辑，比如禁用missing-docstring、设max-line-length=88 -
.flake8或setup.cfg（推荐后者）：声明风格约束，ignore=E203,W503是常见绕过项 -
.vscode/settings.json：只保留三类内容："python.linting.enabled": true、"python.linting.flake8Enabled": true、"editor.formatOnSave": true
注意：.vscode/settings.json 里不要出现 "python.formatting.provider": "black" 这类字段——它属于项目级行为，应由 pyproject.toml 或 setup.cfg 控制，否则和 CI 中的 black --check 行为不一致。
如何验证 linting 真正生效
别只看编辑器有没有红线，要确认终端命令和编辑器行为一致：
- 运行
python -m flake8 --config=.flake8 src/，结果应和 VSCode 里标黄/红线的位置完全一致 - 删掉
.flake8，再运行上面命令——如果还报错，说明 VSCode 正在读别的配置（比如用户级~/.config/flake8），得加--isolated强制只读项目内配置 - 改一行代码，保存后观察：是否触发了 lint + 是否自动修复（若配了
"editor.codeActionsOnSave": {"source.fixAll": true}） - 检查状态栏右下角：Python 解释器路径是否指向项目
venv，不是全局python3——否则flake8可能根本没装进当前环境
容易被忽略的兼容性细节
很多团队卡在“别人能用，我本地不行”，问题常出在工具链加载顺序和 Python 环境隔离上：
-
flake8和pylint不能共存于同一保存动作：VSCode 不支持同时启用python.linting.flake8Enabled和python.linting.pylintEnabled，会冲突；选一个为主，另一个用 pre-commit 补充 -
pyproject.toml优先级高于.flake8：如果项目用了 Poetry 或 modern Python 工具链，[tool.flake8]段落会覆盖.flake8，此时.vscode/settings.json必须确保读的是pyproject.toml - Windows 用户注意换行符：
.editorconfig里必须明确写end_of_line = lf，否则git diff会因CRLF误报格式差异
最麻烦的其实是 Python 解释器绑定——VSCode 的 Python 扩展会缓存 interpreter 路径，切换 venv 后必须手动按 Ctrl+Shift+P → “Python: Select Interpreter” 重新选，否则所有 linting 都在旧环境里跑。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
