scipy.stats.permutation_test是否存在？调用报错原因是什么？

根据SciPy官方文档记载，scipy.stats模块下提供有permutation_test置换检验函数，在Jupyter Notebook中按常规方式调用该函数时，触发如下报错：

AttributeError: module 'scipy.stats' has no attribute 'permutation_test'

遍历scipy.stats的全量属性列表也未找到permutation_test，对应疑问点：

• scipy中是否真实存在permutation_test模块？
• 该问题是否为Anaconda发行版的版本适配问题？

调用时使用的测试代码如下：

import numpy as np
import scipy.stats as sps

def stat_q25(x, y):
    return np.quantile(x, 0.25) - np.quantile(y, 0.25)

test_q25 = sps.permutation_test(data = (x, y), statistic = stat_q25, alternative = 'greater')

scipy.stats.permutation_test为SciPy官方真实内置函数，报错和Anaconda发行版本身无特殊适配冲突，核心原因是安装的SciPy版本过低：

• 该函数在SciPy 1.8.0版本才正式加入公共API，所有1.8.0以下版本的scipy.stats模块都没有这个属性，调用就会触发上述属性不存在的报错。
• 长期未更新的Anaconda环境默认预装的SciPy版本普遍低于1.8.0，是触发该问题的最常见场景。

排查&修复步骤 #

1. 先确认当前环境安装的SciPy版本，在Notebook单元格中执行：

import scipy
print(scipy.__version__)

如果输出的版本号低于1.8.0，即可确认是版本问题。
2. 退出Notebook，在对应环境的终端执行升级命令：

# 用pip升级
pip install -U scipy
# 用conda升级
conda upgrade scipy

3. 升级完成后重启Jupyter Notebook内核，重新导入scipy即可正常调用permutation_test。

提示：如果本地有多个Python/conda虚拟环境，务必确认升级操作是在你运行Notebook使用的那个环境中执行，避免装错环境导致升级后依然找不到函数。

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