python - 我怎样才能告诉 PyCharm 参数应该是什么类型？

Question

当涉及构造函数、赋值和方法调用时，PyCharm IDE 非常擅长分析我的源代码并确定每个变量应该是什么类型。我喜欢它正确的时候，因为它给了我很好的代码完成和参数信息，如果我尝试访问一个不存在的属性，它会给我警告。
但是说到参数，它什么都不知道。代码完成下拉菜单无法显示任何内容，因为它们不知道参数的类型。代码分析无法查找警告。

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age

peasant = Person("Dennis", 37)
# PyCharm knows that the "peasant" variable is of type Person
peasant.dig_filth()   # shows warning -- Person doesn't have a dig_filth method

class King:
    def repress(self, peasant):
        # PyCharm has no idea what type the "peasant" parameter should be
        peasant.knock_over()   # no warning even though knock_over doesn't exist

King().repress(peasant)
# Even if I call the method once with a Person instance, PyCharm doesn't
# consider that to mean that the "peasant" parameter should always be a Person

这在一定程度上是有意义的。其他调用站点可以为该参数传递任何内容。但是如果我的方法需要一个类型的参数，比如说， pygame.Surface ，我希望能够以某种方式向 PyCharm 表明这一点，以便它可以向我显示所有 Surface的属性在其代码完成下拉列表中，并在调用错误方法时突出显示警告，等等。
有没有办法可以给 PyCharm 一个提示，然后说“psst，这个参数应该是 X 类型”？ (或者，本着动态语言的精神，“这个参数应该像 X 一样嘎嘎叫”？我可以接受。)

编辑: CrazyCoder 的回答，如下，可以解决问题。对于像我这样想要快速总结的新人，这里是:

class King:
    def repress(self, peasant):
        """
        Exploit the workers by hanging on to outdated imperialist dogma which
        perpetuates the economic and social differences in our society.

        @type peasant: Person
        @param peasant: Person to repress.
        """
        peasant.knock_over()   # Shows a warning. And there was much rejoicing.

相关部分是 @type peasant: Person文档字符串的行。
如果您还转到"file">“设置”>“Python 集成工具”并将“文档字符串格式”设置为“Epytext”，则 PyCharm 的 View > 快速文档查找将漂亮地打印参数信息，而不仅仅是按原样打印所有 @ 行。

Answer 1

是的，您可以对方法及其参数使用特殊的文档格式，以便 PyCharm 可以知道类型。最近的 PyCharm 版本 supports most common doc formats .

例如，PyCharm 从 @param style comments 中提取类型.

另见 reStructuredText和 docstring conventions (PEP 257)。

另一种选择是 Python 3 注释。

请refer to the PyCharm documentation section了解更多详情和 sample 。