Ubuntu下安装tensorflow-gpu报错：python setup.py egg_info执行失败

架构老林

2026-7-29

解决Ubuntu下安装tensorflow-gpu时python setup.py egg_info报错的方法

检查Python版本兼容性
TensorFlow GPU对Python版本有严格要求，比如TensorFlow 2.x系列大多支持Python 3.7-3.10（不同版本略有差异）。先执行python --version或python3 --version确认版本是否匹配目标TensorFlow版本要求。如果不兼容，用pyenv或conda创建对应版本的虚拟环境，示例：
```
pyenv install 3.9.16
pyenv local 3.9.16
```
更换TensorFlow版本或使用官方推荐命令
旧版tensorflow-gpu包已被废弃，现在统一使用tensorflow包（环境配置正确时会自动启用GPU支持）。试试安装指定稳定版本：
```
pip install tensorflow==2.15.0
```
若坚持使用旧版tensorflow-gpu，需指定兼容版本，比如给Python 3.8安装2.6.0版本：
```
pip install tensorflow-gpu==2.6.0
```
升级pip并清理缓存
过时的pip可能引发此类问题，先升级：
```
pip install --upgrade pip
```
再清理pip缓存，避免损坏的缓存文件干扰安装：
```
pip cache purge
```
补全系统依赖
Ubuntu下安装TensorFlow GPU需要CUDA和cuDNN支持，确保安装了与TensorFlow版本匹配的CUDA Toolkit和cuDNN（比如TensorFlow 2.15对应CUDA 12.2、cuDNN 8.9）。同时安装基础系统依赖：
```
sudo apt-get install build-essential libssl-dev libffi-dev python3-dev
```
用虚拟环境隔离安装
全局环境的依赖冲突很常见，用venv创建干净的虚拟环境再尝试：
```
python3 -m venv tf_env
source tf_env/bin/activate
pip install tensorflow
```