Python ValueError 常见场景与修复指南
发布时间：2026-10-16| 6人浏览过
本文深入解析 Python 中 ValueError 异常的三种典型场景：将非数字字符串转为整数、直接遍历字典键值对导致的解包错误，以及在二进制模式下读取文件时指定编码参数。通过具体代码示例与规避方案，帮助开发者快速定位并修复此类类型或参数不匹配引发的运行时错误。
Python 异常 ValueError
ValueError: invalid literal for int() with base 10: '*'
当尝试将包含非数字字符或与数值无关类型的字符串强制转换为整数时，Python 解释器会抛出此异常。
>>> int("99 years ago.")
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ValueError: invalid literal for int() with base 10: '99 years ago.'规避方法：确保传递给 int 函数的参数是合法的数字字符串。int 函数使用传送门：Python中的int函数使用
ValueError: too many values to unpack (expected 2)
在遍历字典时，若尝试直接对字典对象进行解包以同时获取键和值，会触发该错误。
>>> demo = {"China": "Beijing", "Japan": "Tokyo"}
>>> for k, v in demo:
... print(k, v)
...
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ValueError: too many values to unpack (expected 2)Python 规定字典的直接迭代仅返回键（key），因此上述直接遍历方式在语法逻辑上是错误的。
规避方法
方法一：通过字典的键索引方式同时获取对应的值。
>>> demo = {"China": "Beijing", "Japan": "Tokyo"}
>>> for key in demo:
... print(key, demo[key])
...
China Beijing
Japan Tokyo方法二：利用字典的 items 方法获取键值对视图。
>>> demo = {"China": "Beijing", "Japan": "Tokyo", "the United States": "Washington D.C."}
>>> for key, value in demo.items():
... print(key, value)
...
China Beijing
Japan Tokyo
the United States Washington D.C.
ValueError: binary mode doesn't take an encoding argument在尝试以二进制模式打开并读取文件时，若同时指定了编码方式（encoding 参数），会引发此异常。
>>> with open("protoc-gen-go", "rb+", encoding="utf-8") as file:
... data = file.read()
...
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ValueError: binary mode doesn't take an encoding argument规避方法：在二进制模式（如 'rb', 'wb', 'rb+'）下打开文件时，请勿使用 encoding 关键字。
>>> with open("protoc-gen-go", "rb+") as file:
... data = file.read(10)
...
>>> data
b'\xcf\xfa\xed\xfe\x07\x00\x00\x01\x03\x00'以上为个人经验，希望能给大家一个参考，也希望大家多多支持本站。
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
