Python函数注解返回dict时，应返回None还是空字典？

首先明确：返回None会直接违背-> dict的类型注解，因为None的类型是NoneType，不属于dict范畴，类型检查工具（如mypy）会直接报错，也容易让调用方误判返回值类型。具体怎么选，得看场景：

1. 区分两种核心场景 #

场景A：合法输入，但无有效数据可生成字典 #

比如传入两个空列表，逻辑上确实生成不了有内容的字典，但操作本身是合法的。这种情况返回空字典{}更合规：

• 符合类型注解要求
• 调用方无需额外判断，直接用dict的方法（比如items()、get()）不会报错，代码更健壮

场景B：输入不合法/条件不满足，根本无法完成字典生成 #

比如两个列表长度不匹配，没法一一对应生成键值对，这属于操作失败的情况。这时候有两个更合理的选择：

• 优先抛出异常：比如raise ValueError("两个列表长度不匹配，无法生成字典")，直接明确告知错误原因，调用方可以通过try-except捕获处理，比返回None更直观
• 修正类型注解后返回None：如果你想模仿Haskell的Maybe构造器，那就把返回类型改成Optional[dict]（Python 3.10+可用dict | None），明确表示结果可能存在或不存在：

  from typing import Optional
  
  def function(ls1: list, ls2: list) -> Optional[dict]:
      if len(ls1) != len(ls2):
          return None
      di = dict(zip(ls1, ls2))
      return di
  

2. 不要踩的坑 #

绝对不要在标注-> dict的情况下返回None：

• 类型检查工具会报错，破坏代码的类型一致性
• 调用方如果没做if result is not None的判断，后续操作会直接抛出AttributeError或TypeError，增加bug风险

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