Pandas 1.4.4与1.5.0版本pd.Series索引行为变更咨询

问题复现代码 #

test = pd.Series({True: 0, False: 0})

Pandas 1.4.4 执行结果 #

print(test[0])

0

Pandas 1.5.0 执行结果 #

print(test[True])

KeyError: 0

问题描述 #

我发现Pandas 1.4.4与1.5.0版本中pd.Series的索引行为存在差异，无法找到该变更的相关说明，请问具体发生了什么变更？

变更解析 #

这个差异源于Pandas 1.5.0对布尔索引与位置索引优先级的明确调整，核心是消除了整数与布尔值之间的隐式转换歧义：

• 1.4.4及更早版本：当Series索引为布尔类型时，[]操作符会优先将整数索引器隐式转换为布尔值（0→False、非0→True），按标签匹配取值。因此test[0]等价于test[False]，返回对应值0；直接传入布尔值test[True]也能正常匹配标签取值。
• 1.5.0及后续版本：[]操作符严格区分索引器类型与索引类型的对应关系：
  1. 传入整数时，触发位置索引（等同于.iloc的行为），test[0]取位置0的元素（对应标签True的0），test[1]取位置1的元素（对应标签False的0）。
  2. 传入单个布尔值时，不再当作标签索引，而是被识别为布尔掩码处理。但单个布尔值无法匹配Series长度，进而触发KeyError（本质是强制要求开发者明确区分标签/位置索引的使用场景）。

跨版本兼容的正确用法 #

为避免版本差异问题，建议明确使用索引器方法：

• 按标签取值：使用.loc，如test.loc[True]、test.loc[False]
• 按位置取值：使用.iloc，如test.iloc[0]、test.iloc[1]

内容的提问来源于stack exchange，提问作者GyeongHyeonLee