Black和Flake8在VS Code中需分别启用、路径对齐、规则让渡：flake8须设python.linting.flake8Enabled和lintOnSave为true，black须设python.formatting.provider为"black"，冲突时优先用pyproject.toml禁用flake8冲突规则如E231、W503。
Black 和 Flake8 在 VS Code 里不是“装了就能用”，而是必须各自明确启用、路径对齐、规则让渡，否则保存时互相打架，或者干脆静音。
为什么保存后没反应，也不报错
最常见的情况是：flake8 没真正启用，或 black 没被设为默认 formatter。
-
python.linting.enabled和python.linting.flake8Enabled都得是true，缺一不可 -
python.formatting.provider必须设为"black"，否则按Shift+Alt+F或保存时触发的是默认（可能是 autopep8 或未配置） -
python.linting.lintOnSave默认是false，不打开它，改完代码保存也不会扫出 E501、F401 这类错误 - 改完设置后，不用重启 VS Code，但要关掉当前 .py 文件再重新打开，语言服务器才读新配置
flake8 报错但 black 格式化后又变红波浪线
这是规则冲突的典型表现，比如 black 自动加尾逗号，而 flake8 的 E231 规则要求逗号后必须有空格——但 black 偏不加。
- 优先让 black 主导风格，flake8 退让：在项目根目录的
pyproject.toml中禁用冲突项 - 例如写：
[tool.flake8] ignore = "E231, W503" select = "C,E,F,W,B"
- 别在
settings.json里硬调python.linting.flake8Args，容易和 toml 冲突；统一用 toml 管理更稳 - 如果某行真要绕过检查，末尾加
# noqa: E231，不是# noqa
black 格式化缩进错乱或不生效
不是 black 坏了，而是 VS Code 没找到它，或环境没对上。
- 确认
black装在当前选中的 Python 解释器环境里：终端运行pip list | grep black，且解释器路径和左下角显示一致 -
python.formatting.blackPath一般不用填，除非报command 'python.execInTerminal' not found；这时填绝对路径，比如"./venv/Scripts/black.exe"（Windows）或"./venv/bin/black"（macOS/Linux） - black 默认用 4 空格，但若
pyproject.toml里写了line-length = 88却没配skip-string-normalization = false，docstring 可能被意外重排 - 禁用其他 formatter 扩展，比如 “Auto PEP8”、“Python Docstring Generator”，它们会抢在 black 前执行
pyproject.toml 放哪才管用
VS Code 只认工作区（workspace）根目录下的 pyproject.toml，放错一层就等于没写。
- 打开文件夹后，资源管理器里看到的最外层目录就是根目录；
pyproject.toml和.vscode/settings.json应该平级 - 文件名必须是
pyproject.toml，不是setup.cfg或.flake8（后者虽可识别，但规则写法不同，易出错） - 格式必须合法：方括号开头，键值对用
=，字符串值加引号，忽略项用英文逗号分隔，如ignore = "E203, W503" - 改完 toml 后，同样要关闭再重开 .py 文件，VS Code 不会热加载
真正卡住人的地方，往往不是不会配，而是没意识到 VS Code 的 linting 和 formatting 是两个独立开关，且都依赖当前解释器环境是否干净、路径是否绝对、配置文件是否在正确层级——少一个条件，整套规范就静音。
