本文详解如何基于数值范围为 DataFrame 新增分类列，重点解决 ValueError: The truth value of a Series is ambiguous 错误，并推荐使用 np.select 等向量化方法替代低效的 apply + iterrows。
本文详解如何基于数值范围为 dataframe 新增分类列，重点解决 `valueerror: the truth value of a series is ambiguous` 错误，并推荐使用 `np.select` 等向量化方法替代低效的 `apply` + `iterrows`。
在 Pandas 中，为 DataFrame 添加基于条件的新列（如根据价格区间标注“Low”/“Average”/“High”）是常见需求，但初学者常因误用标量逻辑操作而触发 ValueError: The truth value of a Series is ambiguous。该错误的根本原因在于：你在函数内部直接对整个 Series（如 df['Price'] <= 15000）使用了 if 语句——而 if 要求布尔标量值，Pandas Series 的布尔比较结果却是布尔 Series，Python 无法判定其“真值”，故报错。
原代码存在多重问题：
- my_function 接收的是单个 price_label 值（由 .apply() 逐元素传入），但函数体内却错误地访问了整个 df['Price']；
- for index, line in df.iterrows(): 在 .apply() 内部循环全表，完全违背向量化设计初衷，导致性能灾难；
- 条件分支未覆盖所有情况（如 Price == 15000 时逻辑冗余），且返回逻辑与 apply 的逐元素调用机制不匹配。
✅ 正确做法是：让函数只处理单个输入值，并确保逻辑清晰、无副作用。例如：
def price_category(price):
if price <= 15000:
return "Low"
elif price <= 38000: # 等价于 15000 < price <= 38000
return "Average"
else:
return "High"
df['Price Label'] = df['Price'].apply(price_category)但更推荐 向量化方案 —— 它无需 Python 循环，底层由 NumPy/C 优化，速度提升可达数千倍。np.select 是处理多条件分箱的理想工具：
import pandas as pd
import numpy as np
# 示例数据
df = pd.DataFrame({'Price': [10000, 20000, 40000, 12000, 35000]})
# 定义条件列表（按优先级顺序）和对应取值
condlist = [
df['Price'] <= 15000, # 条件1：低价
df['Price'] <= 38000 # 条件2：中价（隐含 >15000）
]
choicelist = ['Low', 'Average']
# 应用规则，default 指定不满足任一条件时的默认值
df['Price Label'] = np.select(condlist, choicelist, default='High')输出结果：
Price Price Label 0 10000 Low 1 20000 Average 2 40000 High 3 12000 Low 4 35000 Average
? 关键要点：
- condlist 中的条件按从左到右顺序匹配，首个为 True 的条件决定结果，因此需注意条件顺序（如先写 <=15000，再写 <=38000）；
- choicelist 长度必须与 condlist 一致；
- default 参数必不可少，用于兜底未被任何条件覆盖的值（如 Price > 38000）；
- 性能对比鲜明：对百万行数据，np.select 仅需约 47μs，而 df['Price'].apply(...) 高达 210ms —— 慢 4400 倍以上。
此外，Pandas 原生的 pd.cut 或 pd.qcut 也适用于等宽/等频分箱场景；若需复用逻辑，可封装为 lambda 或独立函数，但务必坚持“输入单值 → 输出单值”的契约。避免在向量化上下文中混用 DataFrame 全局操作，这是写出健壮、高效 Pandas 代码的核心原则。
