Python3.9.6环境pip安装web3py提示VC++依赖错误如何解决

问题根本原因 #

本次报错是web3的依赖库bitarray安装失败触发的，该库部分功能由C语言实现，安装时要么直接下载对应Python版本的预编译wheel包，要么需要本地有完整的C编译环境才能从源码编译安装。你虽然已经安装了Visual C 2014相关组件，但出现识别失败的常见原因如下：

• 安装的是VC运行时库而非编译工具：大部分用户误装的Microsoft Visual C Redistributable仅支持运行已编译的C程序，编译Python扩展需要的是包含MSVC编译器、Windows SDK、头文件在内的完整C生成工具
• 编译工具组件安装不全：即使安装了C生成工具，若未勾选「桌面开发用C」工作负载下的核心组件，也无法满足编译要求
• 环境变量未生效：安装完编译工具后没有重启终端或系统，导致pip无法读取到编译器的路径配置
• 包管理工具版本过旧：旧版本的pip、setuptools无法识别对应Python3.9.6的预编译bitarray包，会自动触发源码编译流程

解决方案 #

按优先级依次尝试：

1. 优先安装预编译版本的bitarray，跳过编译流程
   执行命令：

pip install --only-binary :all: bitarray

待bitarray安装完成后，再执行pip install web3即可
2. 升级基础包管理组件
旧版本的包管理工具可能无法匹配预编译包规则，先执行升级：

pip install --upgrade pip setuptools wheel

升级完成后再尝试安装web3
3. 补全C编译环境
如果确实需要从源码编译，打开Visual Studio Installer，修改已安装的生成工具，勾选「使用C的桌面开发」工作负载，安装所有默认子组件后重启电脑，再执行安装操作

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