Flake8和Black需显式启用、路径对齐、环境一致：flake8须设"python.linting.flake8Enabled":true并装在当前解释器环境，black须设"python.formatting.provider":"black"且禁用冲突扩展，冲突规则应通过pyproject.toml统一忽略。
Flake8 和 Black 不是开箱即用的——必须显式启用、路径对齐、环境一致，否则 VS Code 里根本看不到波浪线或格式化没反应。
flake8 在 VS Code 里不报错？检查这三件事
常见现象是装了 flake8、也勾了 linting 开关，但保存后毫无提示。根本原因不是插件没装，而是 VS Code 的 Python 扩展默认只认 pylint。
- 确认
flake8安装在当前选中的 Python 解释器环境里：用Ctrl+Shift+P→Python: Select Interpreter切换到项目虚拟环境，再运行pip install flake8 - 在
settings.json中关闭其他 linter，只留这两项："python.linting.flake8Enabled": true和"python.linting.enabled": true - Windows 用户若遇到
command 'flake8' not found，手动指定路径："python.linting.flake8Path": "./venv/Scripts/flake8.exe"（路径按你实际虚拟环境调整）
black 格式化失效或缩进错乱？关键在 provider 和配置优先级
按 Shift+Alt+F 没反应，或格式化后 def 缩进变 2 空格、docstring 被重排，说明 VS Code 没把 black 当成主力 formatter，或者被其他工具劫持了。
- 必须设置：
"python.formatting.provider": "black"，且确保"editor.formatOnSave": true -
black默认读pyproject.toml里的[tool.black]配置；如果项目有该文件，line-length或skip-string-normalization = false缺失，会导致 docstring 异常 - 禁用冲突扩展，比如 “Auto PEP8”、“Python Docstring Generator”，它们会在
black前触发格式化
flake8 和 black 冲突导致保存时反复修改？这是规则打架
最典型的是：保存一次，black 加了结尾逗号，flake8 立刻报 E231 missing whitespace after ','；再保存，black 又删掉逗号……死循环。
立即学习“Python免费学习笔记（深入）”；
- 这不是 bug，是设计差异：
black默认加逗号，flake8的E231规则要求逗号后必须有空格 - 解决方法是在
.flake8中忽略冲突项：ignore = E231，或更稳妥地加extend-ignore = E203, W503（这两项常与black的换行和逗号策略冲突） - 推荐统一用
pyproject.toml管理：[flake8]和[tool.black]同文件下，避免配置分散
真正容易被忽略的是环境隔离问题：flake8 和 black 必须和项目 Python 解释器完全一致，不能一个在全局 pip 装、一个在 venv 里装，VS Code 不会自动跨环境找命令。
