如何在 python 中创建自定义文档字符串？你会直接说__nameofdocstring__ 还是你应该做其他事情？
是否可以为某个.py 文件创建新的文档字符串？我想写__notes__ = "blah blah blah"，但只是说那句话是行不通的。
【问题讨论】：
让我们展示一个多行文档字符串的示例：
def my_function():
"""Do nothing, but document it.
No, really, it doesn't do anything.
"""
pass
让我们看看打印出来会是什么样子
print my_function.__doc__
Do nothing, but document it.
No, really, it doesn't do anything.
以下 Python 文件显示了在 python 中的文档字符串的声明 源文件：
"""
Assuming this is file mymodule.py, then this string, being the
first statement in the file, will become the "mymodule" module's
docstring when the file is imported.
"""
class MyClass(object):
"""The class's docstring"""
def my_method(self):
"""The method's docstring"""
def my_function():
"""The function's docstring"""
以下是展示如何访问文档字符串的交互式会话
>>> import mymodule
>>> help(mymodule)
假设这是文件 mymodule.py 然后这个字符串，作为第一个语句 导入文件时，该文件将成为 mymodule 模块文档字符串。
>>> help(mymodule.MyClass)
The class's docstring
>>> help(mymodule.MyClass.my_method)
The method's docstring
>>> help(mymodule.my_function)
The function's docstring
【讨论】：