格式化：Black、isort

在团队协作中，代码风格不统一是低效沟通的重要源头——花在争论“单引号还是双引号”上的时间，本可用于解决真正的业务问题。Python 社区推崇“自动格式化，零争议”的理念，其中的代表工具就是 Black 和 isort。

Black：不妥协的代码格式化器

Black 的口号是“你不必纠结于哪种风格更好，Black 替你决定”。它强制性极强，几乎没有可配置项（除了行宽），目的是彻底消除风格争议。

它能做什么？

• 统一引号：默认将字符串统一为双引号，除非包含双引号自动转回单引号。
• 统一缩进：4 空格，坚决不用 Tab。
• 自动换行：当代码超过设定长度（默认 88 字符），智能地拆成多行并保持可读性。
• 规范空格与括号：去除多余空白，统一逗号后空格，规范函数参数与列表排布。

怎么用？

# 安装
pip install black

# 格式化单个文件
black my_script.py

# 格式化整个项目
black .

# 检查哪些文件会被修改但不真实修改（CI 中用）
black --check .

集成到 VS Code、PyCharm 中后，可以设置保存文件时自动执行格式化，真正实现“写完即整洁”。

实际价值：代码审查时完全省去风格挑错，Git 提交 diff 清晰，新人加入项目无需学习团队约定。

isort：导入语句排序工具

isort 专注解决一个看似细小但极其烦人的问题——import 语句混乱。当文件头部塞满标准库、第三方库、本地模块的 import，且顺序随机时，阅读和维护都很痛苦。

它能做什么？

• 自动将 import 分成三段并排序：

1. 标准库
2. 第三方库
3. 本地/项目内部模块

• 段与段之间空行隔开，每段内按字母顺序排列。
• 同时处理 from ... import ... 和普通 import，合并同一模块的 import。

怎么用？

# 安装
pip install isort

# 格式化单个文件
isort my_script.py

# 格式化整个项目
isort .

# 检查模式（CI 中判断是否合规）
isort --check-only .

同样可集成到编辑器保存动作中。

实际价值：import 区域不再是“拼凑出的垃圾堆”，而成为一眼能看清依赖关系的清晰列表，也便于检查是否有未使用的导入。

两者协同的最佳实践：先用 isort 整理 import，再用 Black 格式化代码主体，最后配合 flake8 检查逻辑错误。这三者无缝衔接，构成了多数 Python 项目的代码质量“自动流水线”。