Python中符合Pythonic规范的函数参数校验最佳实践是什么？

Python社区核心的编码风格是推崇鸭子类型和EAFP（先请求原谅比先获取许可更容易），你提到的两种方案都不是最优解：

• 第一种硬校验参数必须是list类型，会直接拒绝tuple、生成器等其他可迭代的字符串序列传入，浪费了Python动态类型的灵活性，不符合鸭子类型的设计思路
• 第二种完全依赖调用方保证参数正确性，会导致传入单个字符串时不会抛出明确错误，而是返回一个拆分字符的列表，这种隐性故障很容易流到下游业务才被发现，排查成本极高

更合理的处理逻辑是，只拦截会导致业务逻辑不符合预期的单个字符串输入，同时保留对其他可迭代序列的兼容：

def make_fruits_lower_case(list_of_fruits):
    """将水果名称序列统一转为小写"""
    if isinstance(list_of_fruits, str):
        raise TypeError('list_of_fruits 应为字符串组成的可迭代序列，而非单个字符串')
    return [fruit.lower() for fruit in list_of_fruits]

这个实现既解决了单字符串传入的异常问题，又支持列表、元组等所有符合预期的可迭代序列输入，符合Python社区的编码规范。

实际开发中可以根据函数的使用范围和故障影响程度选择：

• 如果是仅在模块/小团队内部使用、调用链路清晰可控的私有函数：推荐要求调用方自行保证参数正确性，不需要添加额外的校验逻辑，减少冗余代码，提升运行效率
• 如果是对外暴露的公共接口、开源库方法、或者参数错误会导致数据篡改、资金损失等严重故障的核心逻辑：推荐添加清晰的参数校验，且抛出可读性强的错误提示，在调用入口就拦截异常，避免隐性问题扩散
• 做参数校验时不要过度使用类型检查限制输入类型，尽量遵循鸭子类型原则：只要输入对象满足你需要的行为协议（比如可迭代、有lower方法等），就允许传入，不要硬卡具体的类型，最大化发挥动态类型语言的优势

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