在 Python 中，文档字符串（或简称 docstring）是一种特殊的字符串，它们出现在模块、类、函数或方法的第一个语句中。文档字符串的主要目的是作为函数、类、方法或模块的说明文档，并使用约定的格式来描述。

文档字符串以三个双引号（”””）开始和结束，这意味着它可以包含多行文本。例如，以下是一个函数的示例文档字符串：

def greet(name):
    """
    This function takes a name as an argument and greets the person with their name.
    
    Args:
    name (str): The name of the person to greet.
    
    Returns:
    str: The greeting message.
    """
    return f"Hello, {name}!"

文档字符串中常见的约定包括描述函数的功能，以及函数的输入和输出参数。这些信息可以使用 Python 的内置函数 help() 来查看，例如：

>>> help(greet)
Help on function greet in module __main__:

greet(name)
    This function takes a name as an argument and greets the person with their name.
    
    Args:
    name (str): The name of the person to greet.
    
    Returns:
    str: The greeting message.

文档字符串还可以使用 Python 的内置文档生成工具，如 Sphinx，生成完整的 API 文档。

文档字符串的格式并不是强制的，但是遵循一些通用的格式约定可以使文档更具可读性和可维护性。

通常，文档字符串的第一行是简短的描述，应该能够在一行内完成。如果需要进一步描述，可以使用多行文本。

在文档字符串中还可以使用特殊的标记来描述函数的输入和输出参数。例如，常用的标记包括：

• Args：用于描述函数的输入参数。
• Returns：用于描述函数的输出参数。
• Raises：用于描述函数可能引发的异常。

例如：

def add(x, y):
    """
    This function adds two numbers and returns the result.
    
    Args:
    x (int): The first number.
    y (int): The second number.
    
    Returns:
    int: The sum of x and y.
    """
    return x + y

总结一下，Python 文档字符串是一种特殊的字符串，它们出现在模块、类、函数或方法的第一个语句中。文档字符串的主要作用包括：

• 作为函数、类、方法或模块的说明文档，使用约定的格式描述这些对象的功能。
• 使用 Python 的内置函数 help() 来查看函数、类、方法或模块的信息。
• 使用 Python 的内置文档生成工具，如 Sphinx，生成完整的 API 文档。

文档字符串的格式并不是强制的，但是遵循一些通用的格式约定可以使文档更具可读性和可维护性。常用的标记包括 Args、Returns 和 Raises。