Ubuntu 20.04 飞桨 Paddle 3.2 安装踩坑与优化指南

内容摘要：Ubuntu 20.04 飞桨 Paddle 3.2 安装踩坑与优化指南,

最近需要在 Ubuntu 20.04 环境下安装飞桨 Paddle 3.2，在实际操作过程中遇到了一些问题。为了帮助大家避免踩坑，本文将详细记录我的解决过程，并提供一些安装优化建议。

环境准备

首先，确保你的 Ubuntu 20.04 系统已经安装了必要的依赖包。

确认 Python 版本

飞桨 Paddle 通常需要 Python 3.7 或更高版本。可以通过以下命令检查 Python 版本：

python3 --version

如果 Python 版本过低，需要进行升级。可以使用 apt 包管理器安装 Python 3.7 或 3.8：

sudo apt update
sudo apt install python3.8 python3-pip # 安装 python3.8 和 pip
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1 # 设置 python3 默认版本
python3 --version # 再次验证

安装 pip

确保 pip 已正确安装并更新到最新版本：

sudo apt install python3-pip
pip3 install --upgrade pip

安装飞桨 Paddle 3.2

官方推荐使用 pip 安装飞桨 Paddle。

CPU 版本安装

如果不需要 GPU 支持，可以直接安装 CPU 版本：

pip3 install paddlepaddle==3.2 -i https://mirror.baidu.com/pypi/simple

国内用户建议使用百度镜像源，可以加快下载速度。类似于使用阿里云或者清华的镜像源。

GPU 版本安装（CUDA）

如果要使用 GPU 版本，需要确保已经安装了 NVIDIA 驱动、CUDA 和 cuDNN。 这是安装飞桨 Paddle 的一个非常常见的踩坑点。

安装 NVIDIA 驱动

可以从 NVIDIA 官网下载对应 Ubuntu 20.04 的驱动，或者使用 apt 安装：

sudo apt update
sudo apt install nvidia-driver-510 # 示例，根据你的显卡型号选择合适的驱动版本
nvidia-smi # 验证驱动是否安装成功

安装 CUDA 和 cuDNN

从 NVIDIA 官网下载 CUDA Toolkit 和 cuDNN，并按照官方文档进行安装。安装过程中，注意配置环境变量。

通常需要设置以下环境变量：

export CUDA_HOME=/usr/local/cuda
export LD_LIBRARY_PATH=$CUDA_HOME/lib64:$LD_LIBRARY_PATH
export PATH=$CUDA_HOME/bin:$PATH

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

安装 GPU 版本 Paddle

安装 GPU 版本的飞桨 Paddle：

pip3 install paddlepaddle-gpu==3.2 -i https://mirror.baidu.com/pypi/simple

验证安装

安装完成后，可以通过以下代码验证是否安装成功：

import paddle

paddle.utils.run_check()

如果输出 Running verify PaddlePaddle program successfully!，则表示安装成功。

常见问题与解决方案

问题 1：ImportError: libcudart.so.11.0: cannot open shared object file

原因： CUDA 库路径未正确配置。

解决方案： 检查 LD_LIBRARY_PATH 环境变量是否包含 CUDA 库路径，并确保 CUDA 版本与 Paddle 版本兼容。

问题 2：安装 Paddle 时出现依赖冲突

原因： 系统中已安装的其他软件包与 Paddle 的依赖冲突。

解决方案： 尝试使用 venv 创建一个独立的 Python 虚拟环境，并在虚拟环境中安装 Paddle。 这也是我个人非常推荐的做法，避免系统环境污染。

python3 -m venv myenv
source myenv/bin/activate
pip3 install paddlepaddle==3.2 -i https://mirror.baidu.com/pypi/simple # 或 paddlepaddle-gpu

问题 3：GPU 运行速度慢

原因： 可能没有正确使用 GPU，或者 GPU 驱动版本过低。

解决方案： 检查 CUDA、cuDNN 和 NVIDIA 驱动版本是否匹配，并确保 Paddle 可以检测到 GPU 设备。可以尝试更新驱动到最新版本。

优化建议

• 使用国内镜像源： 可以显著提高下载速度。
• 使用虚拟环境： 避免依赖冲突。
• 及时更新依赖包： 保持环境的最新状态。

希望本文能帮助你顺利在 Ubuntu 20.04 上安装飞桨 Paddle 3.2。 祝大家顺利！