Python函数无返回对象时应抛异常还是返回Py_RETURN_NONE？

核心判断原则来自Python之禅的明确优于隐式，两种方案的适用场景完全由你对外暴露的函数契约决定： #

什么时候返回None是合理的 #

当你的函数是查找/尝试读取语义时——也就是调用方在调用前就明确知道“目标可能不存在”，会主动处理未命中的分支，返回None是完全符合规范的，参考标准库dict.get()、re.match()的设计逻辑。
注意两个约束：

• 必须在函数文档字符串里明确标注「未找到目标时返回None」，不要让调用方猜
• 只能在“确实没有匹配对象”这一个场景返回None，文件读取失败、格式损坏、参数非法等其他错误场景必须单独处理，绝对不能所有错误都统一返回None

什么时候必须抛出异常 #

当你的函数是加载/获取必填对象语义时——也就是函数的承诺是“传入合法参数、文件格式正常的前提下，一定返回目标对象”，那找不到目标就属于违反契约的错误，必须抛出异常，绝对不能返回None把错误排查成本甩给调用方。

异常类型选择建议 #

按语义优先级选：

• 公开给第三方使用的库，优先自定义语义明确的异常类，比如继承内置Exception实现ObjectNotFoundError、InvalidFileContentError，调用方可以精准捕获，不会和其他内置异常混淆
• 如果不想自定义异常，目标不存在是调用方传入的标识非法导致的，用内置ValueError即可，语义是“参数类型正确但取值不合法”
• 如果目标不存在是文件本身结构损坏、不符合格式规范导致的，也可以用ValueError，或者自定义格式错误类
• 禁止直接抛泛化的Exception、BaseException，也不要用过于模糊的LookupError

反模式提醒：最糟糕的设计是无差别返回None——不管是参数错、文件坏、对象不存在全返回None，调用方拿到None根本无法区分具体原因，后续调试成本极高。

快速判断小技巧 #

站在调用方视角判断：

• 如果调用方大概率会写res = your_func(); if res is None: ...的分支专门处理未命中逻辑，就返回None
• 如果调用方正常逻辑下会直接使用返回值（比如res = your_func(); res.do_something()），未找到属于需要中断处理的错误，就抛异常

示例代码 #

# 查找语义：允许未命中，返回None
def try_get_object(file_path: str, obj_id: str):
    """尝试从指定文件读取对应ID的对象
    返回: 匹配的对象实例，无匹配时返回None
    抛出: FileNotFoundError 文件路径不存在
          ValueError 文件格式损坏无法解析
    """
    # 具体实现逻辑
    for obj in parse_all_objects(file_path):
        if obj.id == obj_id:
            return obj
    return None

# 加载语义：对象必须存在，否则抛异常
class ObjectNotFoundError(Exception):
    """文件中未找到指定ID对象的自定义异常"""
    pass

def load_object(file_path: str, obj_id: str):
    """从指定文件加载指定ID的对象，对象必须存在
    返回: 匹配的对象实例
    抛出: ObjectNotFoundError 无匹配ID的对象
          FileNotFoundError 文件路径不存在
          ValueError 文件格式损坏无法解析
    """
    res = try_get_object(file_path, obj_id)
    if res is None:
        raise ObjectNotFoundError(f"Object with id {obj_id} not exist in {file_path}")
    return res

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