python - PEP-526 与类变量的文档字符串不兼容？

Question

如果我使用 PEP-526 作为类级变量，我必须将它们记录在类的文档字符串中，在这种情况下，我需要选择我最喜欢的方式来执行此操作。

Python 3.6.4 pylint==1.8.4

class Joe(object):
  counter: int = 0
  """This is a counter"""

pylint 说(正确，无论变量是否分配给):

W: 3, 2: String statement has no effect (pointless-string-statement)

Answer 1

并不是 PEP 526 与文档字符串不兼容；而是 PEP 526 与文档字符串不兼容。这是 Pylint 不明白你做了什么。等待更新。

一些工具支持类变量的文档字符串概念，但它从来都不是 Python 本身的一部分，并且 PEP 526 不会改变任何事情。