pandas.diff方法轴向行为不一致是否属于Bug？

首先定义示例DataFrame：

import pandas as pd
df = pd.DataFrame({'col': [True, False]})

两种操作的不同表现 #

• 对单列Series执行diff()：
  运行代码df['col'].diff()，结果正常返回：

  0     NaN
  1    True
  Name: col, dtype: object
  

  这里pandas将布尔Series的 dtype 转为了object，减法操作实际是把布尔值隐式转为数值（True=1，False=0）计算后，再将非零结果转为布尔值，因此能正常执行。

• 对转置后的DataFrame执行diff(axis=1)：
  运行代码df.T.diff(axis=1)时直接报错：

  numpy boolean subtract, the - operator, is not supported, use the bitwise_xor, the ^ operator, or the logical_xor function instead.
  转置后的DataFrame保持了原布尔列的bool dtype，此时diff操作底层会调用numpy的数组运算，而numpy不支持布尔值的减法操作（布尔值的"差"逻辑应该用异或实现），因此抛出错误。

结论 #

这不属于Bug，是两种操作场景下pandas处理布尔数据的逻辑差异导致的：

• Series的diff会将布尔值转为object类型绕开numpy的布尔运算限制；
• DataFrame的diff（尤其是转置后横向计算时）直接使用numpy原生的布尔数组处理，遵循numpy的运算规则。

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