【问题标题】:Is it obligatory to do annotation for __init__?是否必须为 __init__ 做注释?
【发布时间】:2021-11-10 18:00:16
【问题描述】:

PEP8 声明返回__init__ 的注解必须是None。我有义务在代码风格方面这样做吗?如果我到处做注释,省略__init__,我的代码会不会看起来有问题?

【问题讨论】:

    标签: python annotations type-hinting pep8 python-typing


    【解决方案1】:

    来自PEP 484 - Type Hints,在基本原理和目标部分下,非目标小节内容如下:

    还应该强调的是,Python 仍将是一种动态类型语言,作者不希望强制类型提示,即使按照惯例也是如此。

    如果您不想包含注释,则不必包含注释。也就是说,如果您打算在任何地方都包含注释,则为 __init__ 省略它们可能看起来不合适。

    来自PEP 8的介绍,

    [...] 与本样式指南保持一致很重要。项目内部的一致性更为重要。一个模块或功能内的一致性是最重要的。

    【讨论】:

    • 转述。没关系。但要与你自己和已经存在的代码保持一致。
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2018-06-27
    • 1970-01-01
    • 1970-01-01
    • 2021-06-11
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多