VS Code中flake8不报错是因为未显式启用且未指定路径，需在settings.json中设置"python.linting.flake8Enabled": true并确保flake8安装在当前Python解释器环境；black格式化异常则因未设为默认formatter或配置冲突，须配置"python.formatting.provider": "black"并统一用pyproject.toml管理规则。
vscode里flake8不报错但实际没生效
常见现象是装了 flake8 插件、也配了 "python.linting.enabled": true，可保存后依然没红波浪线。根本原因：VS Code 的 Python 扩展默认只启用 pylint，flake8 必须显式开启且指定路径。
- 确认已全局安装：
pip install flake8（别用--user，否则 VS Code 可能找不到） - 在
settings.json中关闭其他 linter，只留："python.linting.flake8Enabled": true,<br>"python.linting.enabled": true
- 如果用了虚拟环境，必须确保
flake8装在当前选中的 Python 解释器环境下——用Ctrl+Shift+P→Python: Select Interpreter切换后，再pip install flake8 - Windows 用户注意：某些终端里
flake8命令可能被flake8.exe替代，VS Code 会自动处理，但若报command 'flake8' not found，可手动指定："python.linting.flake8Path": "./venv/Scripts/flake8.exe"
black 格式化后代码缩进异常或被忽略
典型表现是按 Shift+Alt+F 没反应，或格式化后 def 缩进变成 2 空格、字符串换行错乱。这不是 black 本身的问题，而是 VS Code 没把它设为默认 formatter，或配置冲突。
- 必须设置：
"python.formatting.provider": "black",<br>"editor.formatOnSave": true
- 确保 black 已安装在当前解释器中：
pip install black（和 flake8 同环境） - black 默认用 4 空格缩进，但如果你项目有
pyproject.toml，它会优先读取其中的[tool.black]配置；若存在line-length = 88但没写skip-string-normalization = false，可能导致 docstring 被意外重排 - 禁用其他 formatter 扩展（比如 “Python Docstring Generator” 或旧版 “Auto PEP8”），它们会抢在 black 前触发格式化
flake8 和 black 冲突导致保存时反复修改
最烦的情况：保存一次，black 把逗号加到末尾，flake8 立刻报 E231 missing whitespace after ','；再保存，black 又删掉逗号……死循环。本质是 black 的默认风格（如逗号结尾）和 flake8 的某些规则（如 E231）逻辑相反。
- 优先让 black 主导风格，flake8 退让：在
pyproject.toml中禁用冲突规则：[tool.flake8]<br>ignore = ["E231", "W503"]
- 不要在
settings.json里用"python.linting.flake8Args"传参，容易漏掉；统一用pyproject.toml管理更可靠 - black 不检查空格、括号间距这类问题，所以保留
E201、E272等仍有意义；重点关掉的是它「自动修正」后必然触发的那几条 - 如果团队用 pre-commit，建议把
black放在flake8前面运行，避免 CI 报错
多工作区下不同项目用不同 black 版本
一个文件夹用 black==22.3.0（支持 --preview），另一个用 24.4.2（默认开启 preview），结果格式化结果不一致，PR 里一堆无关 diff。VS Code 默认只认全局或当前解释器里的 black，不会按文件夹自动切换。
立即学习“Python免费学习笔记（深入）”；
- 每个项目根目录放独立的
pyproject.toml，明确指定版本约束：[build-system]<br>requires = ["setuptools>=45", "wheel", "black==24.4.2"]
- 用
pipx管理多版本 black（比pip install -U black安全）：pipx install black==22.3.0 --suffix=@22，然后在对应项目settings.json里写："python.formatting.blackPath": "./venv/bin/black@22"
- VS Code 的
python.defaultInterpreterPath是工作区级的，但它只影响 Python 运行，不影响 black 路径——black 路径必须单独配
真正麻烦的是 pyproject.toml 里 [tool.black] 和 VS Code 设置同时存在时，black 优先读取 TOML；但 flake8 不一定——它可能读不到子目录里的配置，除非你用 --config 显式传入。这点很容易被忽略。
