idxmax() 返回标签而非数字索引，因它默认定位最大值所在行/列的索引标签；若需位置序号，应使用 argmax() 配合 iloc 或 np.nanargmax()。
为什么 idxmax() 返回的不是数字索引而是标签
因为 idxmax() 默认返回的是行（或列）的「标签」，不是位置序号。你用 df.index 看到的是 RangeIndex，但只要中间删过行、设过自定义索引，或者读取 CSV 时用了 index_col，idxmax() 就会返回那个标签值，比如 '2023-05' 或 'B'，而不是 3。
实操建议：
- 确认目标列是否含
NaN——idxmax()会跳过NaN，若全为NaN则报ValueError: No valid index - 要位置序号？改用
df['col'].values.argmax()（注意：这不跳过NaN，需先dropna()或用np.nanargmax()） - 多维结构（如
Series或DataFrame）行为不同：DataFrame.idxmax()默认按列算，返回每列最大值的行标签；加axis=1才按行算
idxmax() 在 DataFrame 上直接调用的陷阱
直接写 df.idxmax() 得到的是一个 Series，索引是列名，值是每列最大值所在的行标签。这不是你想要的“整表最大值所在行”——它不比较跨列大小，只在每列内部找。
常见错误现象：想定位整个 DataFrame 中数值最大的那一行，结果得到一堆不同行的标签，甚至类型都不一致（比如一列是字符串索引，一列是整数）。
立即学习“Python免费学习笔记（深入）”；
实操建议：
- 要整表最大值的行标签？先用
df.values.max()找出最大值，再用df.stack().idxmax()（返回(row_label, col_name)元组） - 更稳的做法：用
df.unstack().idxmax()，或转长格式后处理 - 如果只关心某几列，先
df[['a', 'b', 'c']].idxmax(axis=0)，再人工比对结果
处理重复最大值时 idxmax() 怎么选
idxmax() 永远只返回第一个匹配项的标签，不管后面还有几个一样大的值。它不提供“全部位置”或“随机一个”的选项。
使用场景：做数据清洗时，你可能需要知道所有峰值位置，比如监控指标突增的全部时间点。
实操建议：
- 要全部位置？用布尔索引：
df[df['col'] == df['col'].max()].index.tolist() - 要最后一个？用
df['col'][::-1].idxmax()（注意索引顺序反转后标签不变，但逻辑上取的是倒序第一个） - 性能影响：多次调用
.max()和布尔索引比单次idxmax()略慢，但差异通常可忽略；大数据量下可先缓存max_val = df['col'].max()
和 argmax() 混用导致类型错误
有人把 numpy.argmax() 和 pandas.idxmax() 当成等价替换，结果在带非数字索引的 DataFrame 上出错：argmax() 返回整数位置，但用它去索引 df.loc[...] 会触发 KeyError，因为 loc 要标签，iloc 才要位置。
典型错误信息：KeyError: 5（其实第 5 行标签是 'X99'）
实操建议：
- 统一风格：全用 pandas 方法（
idxmax()+loc）或全用 numpy 底层（argmax()+iloc） - 混用时务必校验：
df.iloc[df['col'].values.argmax()]是安全的；df.loc[df['col'].values.argmax()]很可能崩 - 兼容性提醒：
idxmax(skipna=False)在旧版 pandas（TypeError 就得升级或改用dropna().idxmax()
