insert用于在DataFrame指定位置插入新列，参数loc为插入后列的整数索引（0起始），column为列名，value为等长数据；loc超限则追加末尾，重名列报错，不支持链式调用。
insert函数的基本用法和位置参数含义
insert 是 pandas.DataFrame 的原地修改方法，用来在指定列索引位置插入新列。它的核心参数是 loc（整数位置，从 0 开始）、column（新列名）和 value（标量、列表、Series 或数组）。注意：loc 指的是“插入后新列所在的位置”，不是“插到第几列右边”——比如 loc=0 表示新列成为第一列，loc=1 表示成为第二列，以此类推。
-
loc超出当前列数（如 DataFrame 有 3 列，loc=5）会被自动截断为len(df.columns)，即追加到末尾 -
value长度必须与 DataFrame 行数一致，否则抛出ValueError: Length of values does not match length of index - 如果
column名已存在，insert不会覆盖，而是直接报错：ValueError: cannot insert xxx, already exists
常见错误：用错 loc 导致列顺序混乱
很多人误以为 loc=2 是“插到第 2 列之后”，结果发现新列出现在第 3 位但原有列顺序被挤乱。其实 loc 就是目标下标：插入前所有列索引为 [0, 1, 2]，执行 df.insert(loc=2, column='new', value=...) 后，列索引变成 [0, 1, 2, 3]，其中 2 是新列，原索引 2 及之后的列全部 +1。
- 想插到最前面？用
loc=0 - 想插到最后？用
loc=len(df.columns)（推荐），而不是-1（-1会被当作倒数第一位置，即len-1，不是末尾） - 动态计算位置时，别用
df.columns.get_loc('ref_col') + 1然后直接传给loc——要先确认该列是否存在，且+1后没超限
insert vs 直接赋值（df['col'] = ...）的区别
直接赋值（如 df['new_col'] = [...] ）总是把列加在最后，无法控制顺序；而 insert 是唯一能精确指定列位置的内置方法。性能上，insert 是原地操作，不返回新 DataFrame，也没有拷贝开销；但要注意它不支持链式调用（因为返回 None）。
- 需要保持列顺序整洁（如把 ID、时间戳、特征、标签分组排列）？必须用
insert - 批量插入多列？不能一次
insert多个，得循环调用；每调用一次，后续列位置都会变，所以建议从右往左插（高loc值优先），避免位置偏移 - 如果 value 是
pd.Series，其 index 必须与df.index对齐，否则缺失值会填NaN，且不会报错——容易埋隐患
实际例子：在特定列后插入计算列
假设你有一个 DataFrame，想在 'price' 列后立即插入 'price_taxed'，且确保它紧邻 'price'：
立即学习“Python免费学习笔记（深入）”；
import pandas as pd
df = pd.DataFrame({'id': [1, 2], 'name': ['a', 'b'], 'price': [100, 200]})
# 先获取 price 的位置，再+1作为插入点
pos = df.columns.get_loc('price') + 1
df.insert(loc=pos, column='price_taxed', value=df['price'] * 1.08)
# 结果列顺序：id, name, price, price_taxed这里关键点是：不能写 df.insert(...).assign(...)（因为 insert 返回 None），也不能依赖列名顺序做 loc 计算而不检查是否存在——get_loc 在列不存在时会抛 KeyError，得提前处理。
真正麻烦的不是语法，而是插入逻辑嵌套在条件分支或循环里时，loc 值容易因前面的 insert 调用而失效。这种时候，宁可先收集所有要插的列和位置，再按 loc 降序统一插入。
