咨询Numpy ndarray向量运算支持的合法操作符完整列表

一、支持的逐元素运算操作符列表 #

NumPy 对 ndarray 重载了以下操作符，用于实现逐元素向量运算：

算术运算操作符 #

• +：逐元素加法（等价于 np.add()）
• -：逐元素减法（等价于 np.subtract()）
• *：逐元素乘法（等价于 np.multiply()）
• /：逐元素浮点数除法（等价于 np.divide()）
• //：逐元素整数除法（等价于 np.floor_divide()）
• %：逐元素取余（等价于 np.mod()）
• **：逐元素幂运算（等价于 np.power()）

比较运算操作符 #

• ==：逐元素相等判断（等价于 np.equal()）
• !=：逐元素不等判断（等价于 np.not_equal()）
• <：逐元素小于判断（等价于 np.less()）
• >：逐元素大于判断（等价于 np.greater()）
• <=：逐元素小于等于判断（等价于 np.less_equal()）
• >=：逐元素大于等于判断（等价于 np.greater_equal()）

逻辑运算操作符（注意：非Python原生逻辑符） #

• |：逐元素逻辑或（等价于 np.logical_or()）
• &：逐元素逻辑与（等价于 np.logical_and()）
• ^：逐元素逻辑异或（等价于 np.logical_xor()）
• ~：逐元素逻辑非（等价于 np.logical_not()）

二、or操作符报错的原因及解决方法 #

Python 原生的 or/and/not 是针对单个布尔值的逻辑判断，无法直接作用于多元素 ndarray。当你对 ndarray 使用 or 时，Python 会尝试将整个数组转换为单个布尔值——但多元素数组的"真假"是模糊的（无法确定是要求所有元素为真，还是至少一个元素为真），因此会抛出如下错误：

ValueError: The truth value of an array with more than one element is ambiguous. Use a.any() or a.all()

要实现逐元素逻辑或运算，需使用 NumPy 重载的 | 操作符，或对应的 np.logical_or() 函数：

示例代码 #

import numpy as np

arr = np.array([[True, False, True], [False, True, False]])
arr2 = np.array([[True, True, True], [False, False, False]])

# 方式1：使用|操作符
result = arr | arr2
print(result)
# 输出：
# [[ True  True  True]
#  [False  True False]]

# 方式2：使用np.logical_or()函数
result = np.logical_or(arr, arr2)
print(result)
# 输出与上述一致

三、官方文档核心内容整理 #

NumPy 官方文档明确规定：

Python 原生布尔逻辑操作符 and、or、not 不支持 ndarray 的逐元素逻辑运算，因为这些操作符会尝试将整个数组评估为单个布尔值，导致歧义。
针对 ndarray 的逐元素逻辑运算，必须使用重载的位操作符（|/&/^/~）或对应的 NumPy 逻辑函数。

同时，所有算术、比较操作符均支持逐元素运算，其行为与对应的 NumPy 函数完全一致。

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