VSCode中Black不自动格式化Python的三大主因是：Python解释器路径未与black安装环境对齐、python.formatting.provider未显式设为black、pyproject.toml未置于项目根目录且不含[tool.black]段；三者缺一不可。
VSCode 里 Black 不自动格式化 Python，基本就是解释器没对上、provider 没设对、或 pyproject.toml 放错了位置——三者缺一不可。
Python 解释器路径必须和 black 安装环境一致
VSCode 不会跨环境找 black，它只在你当前选中的 python.defaultInterpreter 对应的环境里执行 python -m black。终端里能跑 black --version，不代表 VSCode 能用。
- 按
Ctrl+Shift+P（Mac 为Cmd+Shift+P），运行Python: Select Interpreter，确认路径指向你装了black的环境（如./venv/bin/python或~/miniconda3/envs/myenv/bin/python） - 在 VSCode 集成终端里运行
python -m black --version，有输出才算真正可用；若报ModuleNotFoundError: No module named 'black'，就立刻在这个环境下重装：pip install black - 用 conda 的话，别只在 base 环境装
black，必须先conda activate myenv再pip install black
settings.json 里必须显式指定 provider 和保存开关
python.formatting.provider 不是可选项，是强制字段。VSCode 默认不设它，也不会自动 fallback 到 black，哪怕你装了插件。
- 打开
Preferences: Open Settings (JSON)，加这三行（别漏掉方括号）： "python.formatting.provider": "black""editor.formatOnSave": true"[python]": { "editor.formatOnSave": true }- 删掉
python.formatting.blackArgs这类冗余配置——除非你真要覆盖pyproject.toml里的设置，否则它大概率被忽略，还容易拼错成python.formatting.blackargs（小写 a）导致静默失效
pyproject.toml 必须在项目根目录且含 [tool.black]
VSCode 的 Python 扩展只认工作区根目录下的 pyproject.toml，且必须包含合法的 [tool.black] 段。写成 .black、black.toml、或放在 src/ 里，它直接无视。
立即学习“Python免费学习笔记（深入）”；
- 最小可用配置示例（存为项目根目录下的
pyproject.toml）： [tool.black] line-length = 88 skip-string-normalization = true include = '\.pyi?$' exclude = ''' /( \.git | __pycache__ | venv )/ '''- 改完配置后，必须执行
Ctrl+Shift+P→Developer: Reload Window，否则旧缓存会让新规则不生效 - 别指望
python.formatting.blackArgs能覆盖line-length或exclude——这些全由pyproject.toml控制，VSCode 只负责调用
格式化失败报 “command 'python.execInTerminal' not found”？那是 blackPath 没配对
这个错误不是 black 崩了，是 VSCode 启动的子进程根本找不到 black 可执行文件。尤其在 pyenv、conda、或 PATH 被定制过的系统上常见。
- 先在终端里运行
which black（macOS/Linux）或where black（Windows），拿到绝对路径（如/Users/me/.pyenv/shims/black） - 在
settings.json中加一行："python.formatting.blackPath": "/absolute/path/to/black" - 注意：路径必须是可执行文件本身，不是 Python 解释器路径；如果用 pyenv，别填
~/.pyenv/shims/python，要填~/.pyenv/shims/black - 填完记得重载窗口，且确保该路径在 VSCode 终端里也能
echo $PATH看到
最常被忽略的是：改了 pyproject.toml 不重载窗口，或者选了解释器但没验证 python -m black 是否真能跑——这两步跳过，其余配置全是白搭。
