如何确保不遗忘函数输入输出类型？记不住参数返回值是否正常及能否改善？

针对遗忘函数输入输出类型的问题，可以试试这些实用方法：

• 用语言原生的类型标注：比如Python的类型提示、TypeScript的类型定义，直接把参数和返回值类型写在函数签名里，比如def process_data(raw: list[dict]) -> tuple[list, dict]:，一眼就能看懂类型信息。
• 写结构化的文档字符串：给每个自定义函数添加规范的docstring，明确参数的类型、含义，以及返回值的类型和说明。比如Google风格的docstring：

def filter_valid_users(users: list[dict]) -> list[dict]:
    """过滤出状态为活跃的用户列表
    Args:
        users (list[dict]): 包含所有用户信息的列表，每个元素是包含`status`键的字典
    Returns:
        list[dict]: 仅包含活跃用户的列表
    """
    return [u for u in users if u.get('status') == 'active']

• 利用IDE的实时提示：主流IDE（VS Code、PyCharm等）都支持悬停查看函数的类型和文档，不用手动翻找，把光标放在函数调用处就能快速获取信息。
• 整理关键函数清单：阅读代码时，把高频使用或逻辑复杂的自定义函数单独记录下来，比如用一个本地的markdown文件，列清楚函数名、输入参数（类型+含义）、返回值（类型+含义），方便快速查阅。
• 用工具生成静态文档：如果代码量较大，可以用Sphinx、pdoc这类工具，自动把函数的类型标注和docstring转换成可浏览的HTML文档，随时可以检索。

这种情况完全正常，尤其是面对陌生的代码库时，几百行代码+大量自定义函数，大脑不可能一次性记住所有细节，遗忘是必然的。

多阅读代码肯定会有改善：

• 随着对代码的业务逻辑、结构框架越来越熟悉，你会自然记住高频使用的函数的输入输出；
• 读多了之后，你会更容易通过函数名、调用上下文推断出函数的作用和类型（比如parse_json这类函数，输入大概率是字符串，输出是字典）；
• 反复接触相同的函数模式，会形成肌肉记忆，后续再遇到类似的自定义函数，能更快理解它的输入输出逻辑。

内容的提问来源于stack exchange，提问作者Yanbing