VSCode怎么配置Black代码格式化(Python)-VSCode-PHP中文网

VSCode中Black不自动格式化Python的三大主因是：Python解释器路径未与black安装环境对齐、python.formatting.provider未显式设为black、pyproject.toml未置于项目根目录且不含[tool.black]段；三者缺一不可。

vscode怎么配置black代码格式化(python)

VSCode 里 Black 不自动格式化 Python，基本就是解释器没对上、provider 没设对、或 pyproject.toml 放错了位置——三者缺一不可。

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

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）导致静默失效

VSCode 的 Python 扩展只认工作区根目录下的 pyproject.toml，且必须包含合法的 [tool.black] 段。写成 .black、black.toml、或放在 src/ 里，它直接无视。

Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。

下载

[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 只负责调用

这个错误不是 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 看到