ValueError 本质是数据不符合预期
Python 报 ValueError，不是语法错，也不是找不到对象，而是函数或操作“看不惯”你给的数据——类型对，但值不合适。比如 int("abc") 不报 TypeError（字符串能转 int 是合法操作），但会报 ValueError，因为 "abc" 这个值无法解析为整数。
常见触发场景与应对方法
字符串转数字失败
- 原因：含空格、不可见字符、字母、符号，或为空字符串
- 解决：用 .strip() 清空格；用 try/except 捕获；检查是否为空再转
- 示例：int(" 123 ") → OK，但 int("12.5") → ValueError（需用 float）
数值范围越界
- 如 math.sqrt(-1)、math.log(0)、int("999999999999999999999999999999", base=2)（超精度）
- 解决：提前判断输入符号或大小；用 cmath 替代 math 处理复数结果；限制输入长度或范围
序列操作索引/切片异常
- list.index(x) 找不到 x；str.format() 占位符数量与参数不匹配；datetime.strptime() 时间字符串格式不符
- 解决：查前先用 in 判断；用 str.format_map(dict) 避免键缺失；用 dateutil.parser.parse() 更容错地解析时间
调试小技巧
- 打印出错变量的 repr() 而非 str()，看清是否有隐藏字符（如 '\u200b' 零宽空格）
- 在报错行前加 print(type(x), repr(x)) 快速定位问题值
- 对用户输入，统一做 .strip() 和非空校验，再进转换逻辑
- 使用 ast.literal_eval() 替代 eval() 安全解析字符串形式的容器（如 "[1,2,3]"）
