You need to enable JavaScript to run this app. Jupyter Notebook pandas导入报错:无法导入np_version_under1p17
优惠活动
大模型
产品
解决方案
定价
更多

Jupyter Notebook pandas导入报错:无法导入np_version_under1p17

报错对应排查解决方案

这个报错的核心是pandas安装文件半损坏、pandas与numpy版本适配断层导致的,之前的重装、全局升级操作没解决,本质是没有清理旧pandas的残留文件、全局升级过程打乱了包版本对应关系。

分步修复流程

  • 第一步:彻底清除pandas残留损坏文件
    打开Anaconda Prompt,进入运行Jupyter的对应环境(base环境直接执行,虚拟环境先执行conda activate 你的环境名激活),依次执行以下卸载命令:
    pip uninstall pandas -y
    conda remove pandas --force
    
    很多人卸载pandas只执行pip uninstall命令,其实Anaconda环境下经常会同时存在pip和conda安装的两份pandas,不强制卸干净的话留着旧文件,重装多少次都会报错。执行完命令后,手动打开路径C:\Users\你的用户名\anaconda3\Lib\site-packages,删除所有带pandas前缀的文件夹、pandas相关的.egg-info缓存文件——只要有残留的旧pandas文件,就算重装新版本,Python还是会优先加载损坏的旧模块。
  • 第二步:确认当前numpy版本,做版本匹配
    在当前环境的Python交互界面执行代码,查看numpy实际版本:
    import numpy
    print(numpy.__version__)
    
    从报错栈能看出来,你本地的pandas加载逻辑是旧版1.1.x的代码(旧版才会从pandas.compat.numpy里导入np_version_under1p17这类兼容判断属性),但pandas.compat模块下的文件是新版1.3+的内容(新版pandas已经删掉了这两个兼容属性),属于典型的安装包半新半旧的损坏状态。
    版本适配规则:
    • 若numpy版本≥1.24,选择pandas≥2.0的版本搭配,不会出现兼容报错
    • 若numpy版本在1.21~1.23区间,选择pandas=1.5.3搭配,完全兼容你写的所有导入代码
  • 第三步:定向重装适配版本的pandas
    不要执行conda update --all这类全局升级命令——这类命令很容易打乱其他科学计算包的版本适配关系,直接定向安装匹配版本即可,比如对应numpy 1.24+的环境执行:
    conda install pandas=2.1.4
    # 若conda源下载慢,可换pip安装,强制全新下载避免加载本地损坏的安装缓存
    pip install pandas==2.1.4 --force-reinstall --no-cache-dir
    
  • 第四步:验证导入路径是否正常
    安装完成后,完全关闭之前的Jupyter窗口,重新启动后在新单元格执行以下代码,确认pandas加载路径正确:
    import pandas
    print(pandas.__version__)
    print(pandas.__file__)
    
    如果能正常输出版本号,且路径指向刚才重装的site-packages目录,再运行你最初的整套导入代码即可正常执行。

常见踩坑点:如果执行完上面的步骤还是报同样的错,说明旧的pandas残留路径被加入了系统的Python搜索路径,这时候可以在notebook最开头执行代码清理无效路径:

import sys
# 过滤掉包含旧pandas残留文件的搜索路径
sys.path = [path for path in sys.path if "pandas/compat" not in path or path.startswith("C:/Users/你的用户名/anaconda3/Lib/site-packages/pandas")]

内容的提问来源于stack exchange,提问作者Shivam Bhateja

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 09:45:01