如何解决Python运行脚本时出现的ModuleNotFoundError: No module named 'web3'报错？

云上老周

2026-4-27

解决ModuleNotFoundError: No module named 'web3'问题

看起来你的问题很明确——你的Python运行环境里还没有安装web3这个第三方库，虽然你在代码里写了导入语句，但环境找不到对应的包，所以抛出了这个错误。下面是具体的解决步骤：

第一步：确认当前Python环境的pip路径
先运行这条命令，确保你用的pip和运行脚本的Python是同一个环境：
```
python3 -m pip --version
```
输出里会显示pip对应的Python安装路径，要和你运行python3 main.py的那个Python路径一致。
第二步：安装web3库
直接用下面的命令把web3安装到当前Python3的环境里：
```
python3 -m pip install web3
```
不要直接用pip install web3，因为系统里可能有多个Python版本，这样能确保包装到你需要的环境中。
如果使用了虚拟环境
如果你给项目创建了虚拟环境（比如项目里有venv文件夹），要先激活虚拟环境再安装：
```
.\venv\Scripts\Activate.ps1
```
激活后命令行开头会出现(venv)的标识，再运行上面的pip install web3命令。
验证安装是否成功
安装完成后，运行这条命令测试：
```
python3 -c "import web3; print(web3.__version__)"
```
如果能正常打印出web3的版本号，说明安装成功了，这时候再运行你的main.py脚本就不会报这个错误了。