【树莓派 5B】Python 版本切换

前言

本文基于树莓派5B 32-bit 树莓派OS，以 Python-3.11.2 降级到 3.9.2 为例，总结了在树莓派上切换 Python 版本的步骤，帮助大家轻松完成 Python 版本的切换。

只需将下载本文中Python的版本号，修改为你想切换的版本号即可

参考资料：
树莓派 python3.9降级为python3.7
莓派上快速安装Python3.6.5

整体思路

系统更新 --> 安装依赖包 --> 下载并编译安装 Python 3.9.2 --> 删除旧的 Python 3 符号链接 --> 创建新的符号链接 --> 验证 Python 版本

具体步骤

1. 系统更新

首先，我们需要确保系统是最新的，以避免因为软件版本差异而导致的兼容性问题。使用以下命令来更新系统

sudo apt-get update
sudo apt-get upgrade -y

• sudo apt-get update：更新软件包列表，确保系统获取到最新的软件包信息。
• sudo apt-get upgrade -y：升级所有已安装的软件包，使系统保持最新状态。

2. 安装 Python 依赖环境

在安装 Python 之前，我们需要安装一些必要的依赖包，确保编译 Python 时不缺少必要的库。

依赖包括编译工具、数据库支持库和压缩文件处理库，确保 Python 的正常编译和运行（弱化版的环境）

sudo apt-get install build-essential libsqlite3-dev sqlite3 bzip2 libbz2-dev

• build-essential：提供了构建软件所需的编译器和其他工具。
• libsqlite3-dev 和 sqlite3：用于 SQLite 数据库支持，这是 Python 常用的数据库模块之一。
• bzip2 和 libbz2-dev：用于处理 .bz2 压缩文件的库，Python 依赖于这些库来解压特定格式的文件。

3. 下载 Python 3.9.2 源代码并解压

我们需要下载 Python 3.9.2 的源代码包，并将其解压缩，以便后续编译安装。

wget https://www.python.org/ftp/python/3.9.2/Python-3.9.2.tgz
tar zxvf Python-3.9.2.tgz

• wget：从指定的 URL 下载 Python 源代码包。
• tar zxvf：解压 .tgz 文件，其中 z 表示解压 gzip 压缩文件，x 表示解档，v 表示显示详细信息，f 指定要处理的文件。

另一种下载 Python 3.9.2 的方法

wget 下载速度可能较慢，可以使用手动拷贝的方法。

1. 在电脑端打开以下网址下载 Python 3.9.2 的压缩包：

   https://www.python.org/ftp/python/3.9.2/Python-3.9.2.tgz

2. 将下载的压缩包拷贝到 U 盘

3. 将 U 盘中的压缩包拷贝到树莓派的 /home/pi 文件夹中

不要忘了，拷贝到树莓派后也要执行解压操作 tar zxvf Python-3.9.2.tgz

4. 安装编译 make

进入 Python 3.9 的源代码目录，并执行配置、编译和安装命令：

cd Python-3.9.2
sudo ./configure && sudo make && sudo make install

• cd Python-3.9.2：进入 Python 源代码目录。
• ./configure：检查系统环境，生成适合当前系统的编译配置文件。
• make：根据配置文件编译 Python 源代码，生成可执行文件。
• sudo make install：将编译生成的 Python 安装到系统中，使其可以全局使用。

ps：
CMake(./configure)：生成编译路线，创建 Makefile 来链接各个文件。规定文件、代码、库直接如何链接
Make：根据生成的路线图（Makefile），跑一遍，编译源代码，生成可执行程序或库文件(已经编译好的二进制文件)
Make install：将已编译好的程序安装到系统目录中，供后续调用。(后续每次使用程序时，不是重新编译，而是执行已经编译好的二进制文件)

可以执行 python3.9 --version 来来检查 Python 3.9.2 是否安装成功

这一步完成后，Python 3.9.2 将被安装到系统中

5. 删除旧版本的符号链接

由于系统原来存在的 python3 符号链接可能指向 Python 3.11，因此我们需要先将其移除：

sudo rm /usr/bin/python3

• sudo rm /usr/bin/python3：删除 /usr/bin/python3 这个符号链接，使得 python3 不再指向旧的 Python 3.11 版本。注意，这只是删除链接，不会删除实际的 Python 3.11 程序。

6. 建立新的符号链接

为了让系统将 python3 和 python 命令指向 Python 3.9，我们需要创建新的符号链接：

sudo ln -s /usr/local/bin/python3.9 /usr/bin/python3
sudo ln -s /usr/bin/python3 /usr/bin/python

这两条命令确保 python3 和 python 都指向 Python 3.9

7. 验证 Python 版本
最后，确认 Python 版本切换是否成功

python3 --version
python --version

常见问题

Python 无法建立与 Python3 的软连接

执行符号链接创建命令时，有时会遇到 python 无法正确链接到 python3 的问题。这可能是由于之前的符号链接未完全移除，或者系统中存在多个 Python 版本导致冲突。

1. 确认旧的符号链接是否已完全删除：

   ls -l /usr/bin/python3
   

   如果链接还存在，使用 sudo rm 彻底删除。

2. 确保 /usr/local/bin/python3.9 路径正确：
   使用以下命令检查是否有可执行文件：

   ls /usr/local/bin/python3.9
   

3. 重新创建符号链接：
   再次执行以下命令来创建新的符号链接：

   sudo ln -s /usr/local/bin/python3.9 /usr/bin/python3
   sudo ln -s /usr/bin/python3 /usr/bin/python