本文详解如何使用 Pandas 为 DataFrame 动态添加新列，并依据某列（如 Name）的值精准映射并填充对应数值，涵盖字典映射、.loc 赋值及常见错误规避方法。
本文详解如何使用 pandas 为 dataframe 动态添加新列，并依据某列（如 `name`）的值精准映射并填充对应数值，涵盖字典映射、`.loc` 赋值及常见错误规避方法。
在数据处理中，常需基于已有列的值（如产品名称）批量生成新列（如价格、权重、分类 ID）。若直接使用 df.loc[condition, 'NewCol'] = value 报错 'int' object has no attribute 'loc'，通常是因为 df 变量被意外覆盖为整数（例如误写 df = 100 后又调用 df.loc[…]），而非 Pandas DataFrame 对象。以下提供安全、高效、可扩展的三种主流实现方式：
✅ 方法一：使用 .map()（推荐｜最简洁、自动处理缺失值）
适用于一对一映射关系，支持 NaN 保留，代码清晰且性能优异：
import pandas as pd
df = pd.DataFrame({
'Name': ['Product 1', 'Product 2', 'Product 5', 'Product 3'],
'Col1': ['x', 'y', 'y', 'z'],
'Col2': ['xx', 'yy', 'y', 'zz']
})
# 定义映射字典（键为 Name 值，值为 Col3 目标值）
mapping_dict = {
'Product 1': 100,
'Product 2': 40,
'Product 3': 250,
'Product 5': 1000
}
# 直接创建新列 Col3，未匹配项自动为 NaN
df['Col3'] = df['Name'].map(mapping_dict)
print(df)输出：
Name Col1 Col2 Col3 0 Product 1 x xx 100.0 1 Product 2 y yy 40.0 2 Product 5 y y 1000.0 3 Product 3 z zz 250.0
⚠️ 注意：.map() 对未在字典中出现的 Name 值返回 NaN（float 类型）。如需默认值（如 0），可链式调用 .fillna(0)；若需保持整数类型，最后加 .astype('Int64')（支持空值的整数类型）。
✅ 方法二：使用 .loc 批量赋值（适合少量固定条件）
仅当映射规则极少（如 ≤3 条）且需显式控制时使用。务必确保 df 是 DataFrame 实例：
# ✅ 正确用法（先创建空列，再按条件赋值）
df['Col3'] = None # 初始化为 object 或 np.nan
df.loc[df['Name'] == 'Product 1', 'Col3'] = 100
df.loc[df['Name'] == 'Product 5', 'Col3'] = 1000
# ✅ 更高效：一次性赋多个条件（使用 isin + numpy.where）
import numpy as np
conditions = df['Name'].isin(['Product 1', 'Product 5'])
df.loc[conditions, 'Col3'] = np.where(
df.loc[conditions, 'Name'] == 'Product 1',
100,
1000
)✅ 方法三：使用 pd.merge()（适合映射表独立存在）
当映射关系存储在另一个 DataFrame 或 CSV 中时，推荐此方式，语义明确、易于维护：
# 映射表（可从文件读取）
mapping_df = pd.DataFrame({
'Name': ['Product 1', 'Product 2', 'Product 3', 'Product 5'],
'Col3': [100, 40, 250, 1000]
})
df = df.merge(mapping_df, on='Name', how='left') # 左连接，保留原表所有行? 关键总结
- ❌ 避免 df = ... 覆盖原始 DataFrame 变量，导致后续 .loc 报错；
- ✅ 优先使用 .map()：简洁、健壮、自动处理缺失值；
- ✅ 新列类型默认为 float（因含 NaN），需整数时用 astype('Int64')；
- ✅ 大规模映射建议将字典存为外部 JSON/CSV，提升可维护性；
- ✅ 使用 df.info() 和 df.dtypes 快速验证 df 类型与列数据类型。
掌握这三种方法，即可灵活应对各类“按行值添加匹配列”的实际需求。
