python 中 方法的参数 提示

在 Python 中，可以使用文档字符串（docstring）来为方法提供参数提示。文档字符串是方法的第一行，用三重引号包裹起来的字符串，例如：

def greet(name: str) -> str:
    """
    Greet someone by their name.

    :param name: the name of the person to greet
    :type name: str
    :return: the greeting message
    :rtype: str
    """
    return f"Hello, {name}!"

在这个例子中，`greet` 方法的参数 `name` 被注释为 `str` 类型，而返回值也被注释为 `str` 类型。这些注释可以被 IDE 或文档生成工具识别，以提供更好的代码提示和文档生成。