Python返回待处理文件列表的函数无匹配文件时返回None还是空列表更好？

这种场景下返回None没有额外优势，反而属于不符合Python开发惯例的冗余设计，更推荐直接返回空列表。

返回空列表的优势 #

• 符合Python可迭代对象的设计逻辑：调用方无需做任何额外校验，直接执行遍历操作即可，无符合条件文件时for循环会自动跳过，不会抛出任何异常，代码更简洁易维护。
• 对齐Python标准库的设计惯例：比如os.listdir()、glob.glob()这类和文件查询相关的标准库方法，无匹配结果时统一返回空列表，符合所有Python开发者的通用预期，降低协作时的理解成本。

返回None的弊端 #

• 额外增加调用方的心智负担：调用方每次使用返回结果前都必须先做if result is not None的非空校验，一旦漏写直接遍历None会抛出TypeError，反而增加了bug出现的概率。
• 没有额外的信息增益：你提到的场景下只有「扫描完成后无符合条件的文件」这一种空结果场景，返回None不会传递任何额外的状态信息，属于多此一举的判断。

  只有当你需要明确区分「扫描成功无结果」和「扫描异常未执行（比如目录不存在、无权限访问）」两种状态时，才需要做特殊返回设计，且这种场景更推荐用抛出异常的方式处理错误，而非返回None混淆正常和异常状态。

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