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 偏不加。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 优先让 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 是两个独立开关，且都依赖当前解释器环境是否干净、路径是否绝对、配置文件是否在正确层级——少一个条件，整套规范就静音。