函数返回多个值时应用tuple而非list,因逗号分隔返回值本质是tuple;None需显式写出;大数据用yield生成器;错误应抛异常而非返回状态码。
函数返回多个值时,别用 list 而要用 tuple
Python 中用逗号分隔多个返回值(如
)实际返回的是 tuple,不是 list。这是语言特性,但很多人误以为是“语法糖”,后续却用
或
去操作它,立刻报
。
真正需要可变容器时才显式构造 list;否则保持 tuple 更安全、更轻量,也暗示“这组值不应被修改”:
None 返回值要显式写出,别依赖隐式返回
函数末尾无
语句时,Python 自动补
。但这会让调用方难以区分“逻辑未覆盖”和“明确无结果”。尤其在条件分支中,漏写
容易引发静默 bug:
立即学习
“
Python免费学习笔记(深入)
”;
比如函数本应返回
,但某个分支忘了
,调用方拿到
后做算术运算直接抛
类型提示(
)和静态检查工具(如 mypy)会报错
建议所有分支都显式返回,或在函数末尾加兜底
并配类型注解:
大对象返回前考虑 yield 或生成器
当函数要返回大量数据(如读取数万行 CSV、遍历深层嵌套结构),一次性构造 list 会吃光内存。此时应改用
返回生成器:
php版微信js-sdk支付接口类
php版微信js-sdk支付接口类
下载
不是“优化技巧”,而是内存模型的根本切换:从“全量加载”变为“按需产出”
调用方用
或
按需消费,不强制展开
若下游必须用 list(比如传给 pandas),再显式转换,责任清晰
示例:过滤大文件中的有效行
避免在返回值里塞
状态码
或错误信息
像
这类“胖返回值”看似统一,实则破坏 Python 的错误处理契约:异常该抛就抛,成功就干净返回业务数据。
调用方必须每处都检查
,容易遗漏,且无法用
统一捕获
类型提示难写(
),mypy 支持弱
和
标准库
、主流框架(requests、sqlite3)风格冲突,增加协作成本
正确做法:成功路径直接返回核心数据;失败路径抛出带语义的异常(如
、自定义
),必要时在异常对象上挂附加信息:
返回值越单一、越符合直觉,调用方就越不容易写出防御性垃圾代码。真正难处理的,从来不是返回什么,而是没想清楚“什么算成功、什么算失败”。
return a, b, c.append().sort()AttributeError: 'tuple' object has no attribute 'append'def get_user_info():
return "alice", 28, "engineer" # ← 返回 tuple,解包自然:name, age, role = get_user_info()
❌ 错误假设它是 list
result = get_user_info()
result.append("remote") # TypeError!
✅ 正确做法:按需转 list
result_list = list(get_user_info()) + ["remote"]
returnreturn NonereturnintreturnNoneTypeError: unsupported operand type(s) for +: 'int' and 'NoneType'-> intreturn Nonedef find_first_even(numbers: list[int]) -> int | None:
for n in numbers:
if n % 2 == 0:
return n
return None # ← 明确写出,不省略yieldyieldfor item in func()list(func())def read_valid_lines(filepath: str) -> Generator[str, None, None]:
with open(filepath) as f:
for line in f:
stripped = line.strip()
if stripped and not stripped.startswith("#"):
yield stripped # ← 不构建大 list
✅ 内存友好
for line in read_valid_lines("huge.log"):
process(line)
❌ 避免这样
all_lines = list(read_valid_lines("huge.log")) # 可能 OOM
return {"success": True, "data": ..., "error": None}resp["success"]try/exceptUnion[SuccessResp, ErrorResp]ValueErrorParseErrorclass ValidationError(Exception):
def __init__(self, field: str, message: str):
self.field = field
self.message = message
super().__init__(f"{field}: {message}")
def parse_config(config_str: str) -> dict:
try:
return json.loads(config_str)
except json.JSONDecodeError as e:
raise ValidationError("config_json", f"invalid syntax at line {e.lineno}")
