Pycharm **kwargs 自动完成

Question

您好我正在尝试使用 **kwargs 使 pycharm 的自动完成工作。 为此，我使用 epytext 语法编写了一个文档字符串，该语法可以使用@keyword p:声明关键字参数，但它不起作用。

有人知道修复它的方法吗？

PS 我在 PyCharm 设置中更改了文档字符串格式。

Answer 1

如果关键字参数是提前知道的（并且你想要一个文档字符串来解释它们），那么它们应该明确地列在函数参数中。 然后可以使用普通的@param和@type语法来描述每一个。 @keywords用于描述在开发时未知的其余关键字参数。

例如：

class SomeClass:
  def __init__(self, some_kw=None, some_kw_1=None, **other_kwargs):
    """
    @param some_kw: A known-at-dev-time keyword argument
    @type some_kw: str
    @param some_kw_1: Another known-at-dev-time keyword argument
    @type some_kw_1: str
    @keyword other_kwargs: More kwargs that will be set on the instance
    """
    self.some_kw = some_kw
    self.some_kw_1 = some_kw_1
    for k, v in other_kwargs:
        setattr(self, k, v)

an_instance = SomeClass(some_kw="hello", other_kw="world")
print an_instance.some_kw
print an_instance.some_kw_1
print an_instance.other_kw

输出

> "hello"
> None
> "world"