You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用Python安装Web3.py失败,如何解决Python版本不兼容报错?

如何修复安装Web3.py时的Python版本错误?

这个问题的核心原因很清晰——你当前使用的Python 2.7.18版本不符合Web3.py的要求,而且Python 2.7早在2020年就停止官方维护了,现在几乎所有主流Python包都不再支持它,这就是报错的关键所在。

下面是具体的修复步骤:

  • 升级Python到兼容版本
    Web3.py 4.8.1要求Python版本在>=3.5.3,<4范围内,推荐安装Python 3.6~3.9(这些版本对Web3.py的兼容性更稳定)。安装完成后,先确认系统默认的Python和pip指向新版本:

    python --version
    pip --version
    

    如果输出还是Python 2.x,说明系统里同时存在两个版本,你需要用python3和pip3来调用Python 3的工具。

  • 使用正确的命令安装Web3.py
    确认Python版本符合要求后,直接执行安装命令:

    pip install web3
    

    若系统中Python 2和3共存,改用:

    pip3 install web3
    
  • (推荐)用虚拟环境隔离项目依赖
    为了避免不同项目的依赖冲突,建议给Web3项目单独创建虚拟环境:

    # 创建虚拟环境(Python 3)
    python3 -m venv web3-project-env
    # Linux/macOS下激活环境
    source web3-project-env/bin/activate
    # Windows下激活环境
    web3-project-env\Scripts\activate
    # 激活后执行安装
    pip install web3
    

另外补充一句:那个弃用警告是在提醒你Python 2.7已经完全过时,不仅Web3.py,后续你安装其他新包都会遇到类似的版本问题,升级到Python 3是从根本上解决这类问题的办法。

内容的提问来源于stack exchange,提问作者S. N

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.04.29 18:23:13