“expected 2”错误本质是解包时左右元素数量不匹配，常见于split未限分隔次数、遍历字典漏.items()、函数返回值未校验、csv行格式异常等场景，需从数据源头排查。
为什么 unpack 时会报 “expected 2”？
这个错误本质是 Python 在解包（unpack）时发现右边的可迭代对象元素个数 ≠ 左边变量个数。比如你写了 a, b = some_iterable，但 some_iterable 实际有 3 个或更多元素，或者只有 1 个，Python 就会抛出 ValueError: too many values to unpack (expected 2)。
常见触发场景包括：用 str.split() 没指定 maxsplit、遍历字典没加 .items()、读取 CSV 行后直接解包、函数返回值与接收变量不匹配。
检查 str.split() 返回值长度是否稳定
str.split() 默认按空白分割所有位置，遇到含多个空格、制表符或连续分隔符的字符串时，极易返回超过 2 个元素。例如 "a b c".split() 得到 ["a", "b", "c"]，解包给两个变量就崩。
- 用
maxsplit=1强制最多切一刀：key, value = line.strip().split(":", maxsplit=1) - 先检查长度再解包：
parts = line.split(); if len(parts) >= 2: a, b = parts[0], parts[1] - 用
partition()更安全（总返回三元组）：left, sep, right = line.partition(":")，即使没找到冒号，sep是空字符串，right也是空字符串，不会报错
遍历字典时别漏掉 .items()
直接 for k, v in my_dict: 是错的——这其实是在遍历 key，每次只得到一个字符串或数字，Python 试图把它解包成 k, v 两个变量，自然失败。
- 正确写法是加
.items()：for k, v in my_dict.items(): - 如果只需要 key 和 index，用
enumerate(my_dict)；如果只要 value，用my_dict.values() - 不确定结构时，先打印
list(my_dict)或list(my_dict.items())看真实产出
处理函数返回值前先确认返回类型
很多函数（如 re.match().groups()、os.path.split()、自定义返回元组的函数）可能返回 None 或长度不定的元组。直接解包 a, b = func() 非常危险。
- 加
if判断：res = re.search(r"(\w+):(\d+)", s); if res: a, b = res.groups() - 用星号表达式兜底：
a, b, *rest = func_returning_3_or_more()，但要注意语义是否合理 - 明确要求固定长度：用
assert len(result) == 2+ 自定义错误信息，比让 ValueError 冒泡更易定位问题源头
最常被忽略的是：错误可能不在解包那行，而在上游数据生成逻辑里——比如文件某一行格式异常、API 返回字段缺失、正则没匹配上却仍尝试解包 None。务必从数据源头加日志或断点验证。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
