Ubuntu 20.04 踩坑记：PaddlePaddle 3.2 安装配置与避坑指南

内容摘要：Ubuntu 20.04 踩坑记：PaddlePaddle 3.2 安装配置与避坑指南,

在 Ubuntu 20.04 上安装飞桨 PaddlePaddle 3.2，看似简单，实则隐藏着不少坑。很多开发者在配置环境时遇到各种各样的问题，导致无法顺利进行深度学习开发。本文将详细记录我在 Ubuntu 20.04 环境下安装 PaddlePaddle 3.2 时遇到的问题，并提供相应的解决方案，希望能帮助大家少走弯路。

1. CUDA 版本兼容性问题

PaddlePaddle 对 CUDA 和 cuDNN 的版本有严格的要求。如果 CUDA 版本不兼容，可能会导致 PaddlePaddle 无法正常运行，甚至直接报错。例如，报错信息可能包含 ImportError: libcudart.so.xxx: cannot open shared object file: No such file or directory。这种情况通常是 CUDA 版本与 PaddlePaddle 版本不匹配导致的。

解决方案：

• 首先，确定你安装的 PaddlePaddle 版本所支持的 CUDA 和 cuDNN 版本。可以参考 PaddlePaddle 官方文档，或者在安装时查看相关提示信息。

• 如果 CUDA 版本不正确，需要卸载旧版本的 CUDA，并安装 PaddlePaddle 所支持的版本。卸载 CUDA 可以使用以下命令：

  

  sudo apt-get purge cuda* # 卸载所有 cuda 相关包
  sudo apt-get autoremove  # 移除不需要的依赖包
  sudo rm -rf /usr/local/cuda* # 删除 cuda 目录
  

• 然后，按照 PaddlePaddle 官方文档的指引安装正确的 CUDA 和 cuDNN 版本。注意，在安装过程中，需要正确配置环境变量，例如：

  export PATH=/usr/local/cuda-11.2/bin${PATH:+:${PATH}} # CUDA 安装路径，根据实际情况修改
  export LD_LIBRARY_PATH=/usr/local/cuda-11.2/lib64${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}} # CUDA 库路径，根据实际情况修改
  export CUDNN_LIBRARY=/usr/local/cuda-11.2/lib64 # cuDNN 库路径，根据实际情况修改
  

  这些环境变量需要添加到 ~/.bashrc 文件中，并执行 source ~/.bashrc 命令使其生效。

2. Python 版本问题

PaddlePaddle 需要 Python 3.7 或更高版本。如果 Python 版本过低，可能会导致安装失败或者运行出错。

解决方案：

• 如果你的 Ubuntu 系统中 Python 版本过低，可以使用 apt 命令安装 Python 3.7 或更高版本：

  sudo apt update # 更新 apt 源
  sudo apt install python3.8 # 安装 python3.8，可以根据需要选择其他版本
  

• 安装完成后，可以使用 python3 --version 命令检查 Python 版本是否正确。

• 另外，建议使用虚拟环境来管理 Python 包，避免不同项目之间的依赖冲突。可以使用 venv 或 conda 创建虚拟环境。

3. PaddlePaddle 安装失败问题

在某些情况下，使用 pip 安装 PaddlePaddle 可能会失败，可能是由于网络问题、依赖冲突等原因。

解决方案：

• 使用国内镜像源可以提高 pip 安装速度，例如：

  pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple # 使用清华大学镜像源
  

  或者配置 pip 默认使用国内镜像源：

  pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple # 设置清华大学镜像源为默认源
  

• 如果遇到依赖冲突，可以使用 pip 的 --no-deps 参数跳过依赖检查，或者手动解决依赖冲突。

  

• 还可以尝试使用 conda 安装 PaddlePaddle，conda 可以更好地管理依赖关系。

4. GPU 驱动问题

如果你的机器上配备了 NVIDIA GPU，并且希望使用 GPU 加速 PaddlePaddle 的训练，那么需要正确安装 NVIDIA 驱动。

解决方案：

• 可以从 NVIDIA 官网下载最新的 NVIDIA 驱动，并按照官方文档的指引进行安装。安装完成后，可以使用 nvidia-smi 命令检查驱动是否安装成功。
• 如果使用的是 Ubuntu 官方源提供的驱动，可能会遇到一些兼容性问题。建议使用 NVIDIA 官方提供的驱动。

5. 实战避坑经验总结

• 仔细阅读官方文档： 在安装 PaddlePaddle 之前，一定要仔细阅读官方文档，了解 PaddlePaddle 的版本要求、安装步骤、配置方法等。
• 使用虚拟环境： 使用虚拟环境可以避免不同项目之间的依赖冲突，保证项目的稳定性。
• 选择合适的镜像源： 使用国内镜像源可以提高 pip 安装速度，避免因网络问题导致安装失败。
• 关注错误信息： 在安装和运行过程中，要仔细关注错误信息，根据错误信息进行排查和解决。
• 善用搜索引擎： 如果遇到问题，可以尝试在搜索引擎上搜索相关信息，通常可以找到解决方案。

希望以上经验能够帮助大家顺利在 Ubuntu 20.04 上安装和使用飞桨 PaddlePaddle 3.2，并在深度学习领域取得更大的成就。