Black格式化工具对异常类中docstring与pass语句间空行的处理变化

Black作为Python代码格式化工具，在最新版本25.1.0中对异常类中的docstring与pass语句之间的空行处理做出了重要调整。这项变更属于Black 2025稳定版样式更新的一部分，体现了工具对代码风格一致性的进一步优化。

在旧版本（如24.10.0）中，Black对于单引号docstring的识别存在缺陷，导致以下代码不会被添加空行：

class ModelError(Exception):
    "说明文档"
    pass

而在25.1.0版本中，Black现在能够正确识别所有形式的docstring（包括单引号、双引号和三引号），并统一在docstring与后续语句（如pass）之间添加空行。这一变更使得代码风格更加统一，因为此前Black已经对三引号docstring采用了相同的处理方式。

对于开发者而言，这项变更意味着：

1. 代码格式化结果将更加一致，不再因docstring的引号形式不同而产生差异
2. 遵循了Python社区广泛接受的docstring与代码体之间留空的编码风格
3. 如果不需要空行，建议直接移除pass语句，因为它在仅包含docstring的异常类中是冗余的

这项改进展示了Black工具对细节的持续优化，也提醒开发者关注工具版本升级可能带来的细微风格变化。对于团队项目，建议在升级Black版本后统一重新格式化代码库，以避免混合不同风格的代码。