| 默认行宽 | 88 字符 |
|---|---|
| 定位 | 减少风格讨论，统一 diff |
| 配置 | [tool.black] in pyproject.toml |
常用命令
常用命令
black .
black --check . # CI 只检查不修改
black --diff src/ # 查看将要修改的差异magic trailing comma 可强制 Black 展开多行，是少数可用的控制手段。
Black：不妥协的格式化器
Black 以统一为目标的 Python 格式化器：默认行宽 88，几乎不接受风格选项，用自动化结束风格争论，配置写入 pyproject.toml。
易错点
- 本地不格式化、只靠 CI 检查：每轮都要返工一次
- 与其它格式化器同时启用：格式互相覆盖，diff 持续抖动
数据来源与参考
- Black 官方文档（black.readthedocs.io）