按照PEP8规范 __init__方法是否必须添加返回值类型注解？

先纠正一个规范来源的小误区：要求__init__返回值注解为None的规则最早出自PEP 484（类型提示规范），后续被纳入PEP 8的代码风格要求中。

以下针对你的两个疑问分别说明：

1. 是否需要强制遵守该要求 #

• 运行层面完全没有强制约束：Python解释器本身不会校验任何类型注解的有效性，就算你给__init__标注了其他返回类型，代码也可以正常运行。
• 规范/工具层面是否强制取决于项目场景：
  • 如果项目开启了mypy、pyright等类型检查工具的默认/严格模式，该规则是强制要求的，缺省会直接抛出类型错误。
  • 如果项目明确要求代码风格遵循PEP 8/PEP 484，就必须遵守该要求。
  • 如果是无统一规范约束的个人小项目，可以根据自己的开发习惯选择。

2. 省略__init__的返回注解会不会显得代码不规范 #

• 如果项目其他所有方法都补全了类型注解，唯独缺了__init__的返回注解，确实会出现风格不一致的问题，熟悉Python类型规范的开发者看到会觉得代码严谨度不足。
• 目前绝大多数Python自动格式化、代码审计工具都会把__init__缺少返回注解列为风格问题，也会自动提示补全。
• 从可读性角度来说，加上-> None也能让刚接触代码的人更明确该方法没有返回值，反而能提升代码可读性。

通用建议：除非有特殊的场景理由，否则直接加上-> None即可，补充成本极低，也符合绝大多数Python项目的通用规范。

内容的提问来源于stack exchange，提问作者Mike