文档字符串存根，Python 我学习Python，因为我认为它是一个很棒的、强大的语言，比如C++、Perl或C，但同时也非常简单。我正在使用JetBrains的Pycharm，当我定义一个函数时，它会要求我添加一个文档字符串存根，当我单击“是”时，它会添加如下内容： """ """ def otherFunction(h, w): """ """ hello = h world = w full_word = h + ' ' + w return full_word

函数的完整代码如下所示：

"""

"""

def otherFunction(h, w):
    """

    """
    hello = h
    world = w
    full_word = h + ' ' + w

    return full_word

---

我想知道这些符号是什么意思，谢谢。

它们被称为“docstrings”，并提供Python的内联文档。概述了它们，并提供了一些示例。

是python中跨多行字符串的转义序列

---

当放在函数或类声明后面时，它们提供所述函数/类的文档，称为docstrings，三重引号表示多行字符串。你可以在里面放任何文字来描述函数。甚至可以从程序本身访问：

def thirdFunction():
    """
    All it does is printing its own docstring.
    Really.
    """
    print(thirdFunction.__doc__)

---

您还可以将它们分配给变量！换行符包括：

>>>multi_line_str=第一行。 ... 第二行。 ... 第三行。 >>>打印多行 第一行。 第二行。 第三行。 理论上，一个简单的字符串也可以用作docstring。即使您自己为换行符添加了多行字符：

>>> def somefunc():
...     'Single quote docstring line one.\nAnd line two!''
...     pass
...
>>> help(somefunc)
Help on function somefunc in module __main__:

somefunc()
    Single quote docstring line one.
    And line two!

但是三重引号。。。实际上，三重双引号是一种标准惯例！在这也

---

只是为了完整

所以，docstring就像是函数的注释，它说明了函数的功能是什么？o、 确切地说，请参阅as bkconrad发布的更多信息info@AndresOrozco：您会注意到，如果在交互式解释器中键入函数的helpnameOfYourFunction，它将打印出函数的名称以及您在定义正下方的三重引号中放置的任何内容。它还将对所有python的内置函数执行此操作，并利用docstring。所以当程序运行时你看不到它？你可以，这就是_doc___属性的作用。尝试在引号中添加一些文本，并在执行的代码中添加print语句。另外，如果你在Python3上，语法将是printotherFunction.\uuu doc\uuuu。我有类似的东西，但我有一个错误AtributeError:'str'对象没有属性'doc'，这是因为你实际上在那里调用函数并向它传递参数，所以它会被计算并用返回值替换。这就是你现在需要的；请注意，在我的示例中，函数名后面没有括号。您不想调用该函数，只需引用其属性即可。还要注意双下划线。我会更新一下答案。哦，我现在明白了。。。我不需要参数，因为我只想调用属性，好的，谢谢。事实上，三引号字符串只是多行字符串文本。Docstrings可以是任何字符串文字，它必须是代码块中的第一项。