当前位置：首页 > news >正文

ubuntu 24 安装 python3.x 教程

news 来源：原创 2025/8/18 13:20:30

注意事项

一、安装不同 Python 版本

1. 安装依赖

2. 下载 Python 源码

3. 解压并编译安装

二、管理多个 Python 版本

1. 查看已安装的 Python 版本

2. 配置环境变量

3. 使用 update-alternatives 管理 Python 版本

三、使用虚拟环境为项目指定特定 Python 版本

1. 使用 venv 创建虚拟环境

2. 激活虚拟环境

3. 在虚拟环境中安装依赖

4. 退出虚拟环境

四、注意事项

五、（可选）使用 Poetry 管理虚拟环境并指定 Python 版本（使用 pip 安装 Poetry）

1. 使用 pip 安装 Poetry

2. 在创建虚拟环境时指定 Python 版本

3. 激活虚拟环境

4. 安装依赖

5. 退出虚拟环境

额外提示

注意事项

Ubuntu 24 系统已预装 Python 3.12，在大多数常规场景下，该版本足以满足使用需求，因此通常无需额外安装其他 Python 版本。

需要特别注意的是，Ubuntu 系统的部分核心组件和默认命令依赖于系统自带的 Python 3.12 版本。随意更改系统默认的 Python 版本，极有可能导致这些依赖 Python 的系统命令无法正常运行，严重时甚至会影响系统的稳定性和正常使用。例如，apt 作为 Ubuntu 重要的包管理工具，其正常运行依赖于特定版本的 Python 环境，若更改默认 Python 版本与 apt 依赖不兼容，就会致使 apt 无法正常工作。所以，若非有特殊的项目需求，建议尽量使用系统默认的 Python 3.12 版本；若确实需要使用其他版本，建议通过虚拟环境的方式来实现，避免对系统默认 Python 环境造成影响。

sudo update-alternatives --display python3

我此时已经安装了两个版本的python

一、安装不同 Python 版本

1. 安装依赖

安装编译 Python 所需的依赖库，确保后续编译过程顺利进行。在终端中执行以下命令：

sudo apt update
sudo apt install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev wget

2. 下载 Python 源码

点我去python的版本归档

借助 wget 命令从 Python 官方网站下载所需的 Python 版本源码包。为了加快下载速度，可使用国内的镜像源，例如清华大学的 Python 镜像源。

以 Python 3.10.11 为例：

wget https://mirrors.tuna.tsinghua.edu.cn/python/3.10.11/Python-3.10.11.tgz

3. 解压并编译安装

下载完成后，对源码包进行解压，然后进行编译和安装操作。

# 解压文件
tar -zxvf Python-3.10.11.tgz
# 进入解压后的目录
cd Python-3.10.11
# 配置编译选项，--prefix 指定安装路径
./configure --prefix=/usr/local/python3.10.11 --enable-optimizations
# 编译，使用 -j 选项利用多核 CPU 加速编译
make -j$(nproc)
# 安装
sudo make altinstall

这里使用 altinstall 而不是 install，是为了避免覆盖系统默认的 Python 版本。

二、管理多个 Python 版本

1. 查看已安装的 Python 版本

安装完成后，可通过以下命令查看已安装的 Python 版本：

ls /usr/bin | grep python

2. 配置环境变量

为方便使用不同版本的 Python，需要将其可执行文件路径添加到环境变量中。编辑 ~/.bashrc 文件：

nano ~/.bashrc

在文件末尾添加以下内容（以 Python 3.10.11 为例）：

export PATH="/usr/local/python3.10.11/bin:$PATH"

保存并退出文件，然后使配置生效：

source ~/.bashrc

3. 使用 update-alternatives 管理 Python 版本

update-alternatives 是 Ubuntu 系统中用于管理多版本软件的工具。可以通过它来查看和切换系统默认使用的 Python 版本。

查看 Python 3 替代项信息：

sudo update-alternatives --display python3

执行该命令后，会显示系统中所有 Python 3 版本的替代项信息，包括每个版本的路径、优先级等。示例输出如下：

从输出中可以看到每个 Python 版本的优先级，优先级越高，在自动模式下越优先被使用。

手动切换 Python 3 版本：
如果需要手动切换系统默认使用的 Python 3 版本，可以执行以下命令：

sudo update-alternatives --config python3

执行该命令后，会列出所有可用的 Python 3 版本，你可以输入对应的编号来选择要使用的版本。

三、使用虚拟环境为项目指定特定 Python 版本

1. 使用 venv 创建虚拟环境

venv 是 Python 自带的虚拟环境管理工具。以使用 Python 3.10.11 创建虚拟环境为例：

/usr/local/python3.10.11/bin/python3 -m venv my_project_env

my_project_env 是虚拟环境的名称，可根据实际情况修改。

2. 激活虚拟环境

source my_project_env/bin/activate

激活后，终端提示符前会显示虚拟环境的名称。

3. 在虚拟环境中安装依赖

在激活的虚拟环境中，可以使用 pip 安装项目所需的依赖：

pip install package_name

4. 退出虚拟环境

当项目使用完毕后，可使用以下命令退出虚拟环境：

deactivate

四、注意事项

避免覆盖系统默认 Python：使用 altinstall 安装 Python 版本，防止替换系统默认的 Python 版本，以免影响系统的正常运行。
镜像源的使用：在下载 Python 源码包和使用 pip 安装依赖时，可使用国内的镜像源，如清华大学、阿里云等，以提高下载速度。例如，使用清华大学的 pip 镜像源：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name

虚拟环境的管理：为每个项目创建独立的虚拟环境，避免不同项目之间的依赖冲突。

通过以上步骤，可以在中国网络环境下方便地安装多个 Python 版本，同时让系统继续使用默认版本，项目使用特定版本。

五、（可选）使用 Poetry 管理虚拟环境并指定 Python 版本（使用 pip 安装 Poetry）

1. 使用 pip 安装 Poetry

Poetry 是一个强大的 Python 依赖管理和打包工具，同时也能出色地管理虚拟环境。你可以使用 pip 来安装它，为确保安装的是用户级别的 Poetry，避免权限问题，可执行以下命令：

pip install --user poetry

以下步骤参考你前面有没有执行这个

安装完成后，要将 Poetry 的可执行文件路径添加到环境变量里。编辑 ~/.bashrc 文件：
nano ~/.bashrc
在文件末尾添加如下内容：
export PATH="$HOME/.local/bin:$PATH"
保存并退出文件，接着让配置生效：
source ~/.bashrc

2. 在创建虚拟环境时指定 Python 版本

要是你还未用 Poetry 为项目创建过虚拟环境，可使用 poetry env use 命令来指定 Python 版本并创建虚拟环境。

步骤

确认可用的 Python 版本路径
先找到你想要使用的 Python 版本的可执行文件路径。可以通过 which 命令来查看特定版本 Python 的路径，例如查看 Python 3.10 的路径：

which python3

通常输出可能类似 /usr/local/bin/python3.10 。

使用 poetry env use 命令创建虚拟环境
使用上一步获取的 Python 可执行文件路径来创建虚拟环境，示例如下：

poetry env use /usr/local/bin/python3

执行该命令后，Poetry 会依据指定的 Python 版本创建一个新的虚拟环境。

3. 激活虚拟环境

Poetry 会自动为项目创建虚拟环境，你可以使用以下命令激活该虚拟环境：

poetry shell

激活之后，终端提示符前会显示虚拟环境的名称。

4. 安装依赖

在激活的虚拟环境中，你可以使用 Poetry 安装项目所需的依赖。例如，安装 requests 库：

poetry add requests

Poetry 会自动管理依赖的版本，并且将其记录在 pyproject.toml 和 poetry.lock 文件中。

5. 退出虚拟环境

当项目使用完毕后，可使用以下命令退出虚拟环境：

exit

额外提示

更新 Poetry：若要更新已安装的 Poetry 版本，可执行 pip install --user --upgrade poetry 命令。
配置镜像源：在国内网络环境下，为提升依赖下载速度，你可以配置 Poetry 使用国内镜像源。例如，配置为阿里云镜像源：

poetry config repositories.aliyun https://mirrors.aliyun.com/pypi/simple/
poetry config installer.max-workers 10
poetry config virtualenvs.in-project true

上述命令依次完成了镜像源的配置、设置最大下载线程数以及让虚拟环境在项目目录内创建。

注意事项

一、安装不同 Python 版本

1. 安装依赖

2. 下载 Python 源码

3. 解压并编译安装

二、管理多个 Python 版本

1. 查看已安装的 Python 版本

2. 配置环境变量

3. 使用 update-alternatives​ 管理 Python 版本

三、使用虚拟环境为项目指定特定 Python 版本

1. 使用 venv​ 创建虚拟环境

2. 激活虚拟环境

3. 在虚拟环境中安装依赖

4. 退出虚拟环境

四、注意事项

五、（可选）使用 Poetry 管理虚拟环境并指定 Python 版本（使用 pip 安装 Poetry）

1. 使用 pip 安装 Poetry

2. 在创建虚拟环境时指定 Python 版本

3. 激活虚拟环境

4. 安装依赖

5. 退出虚拟环境

额外提示

相关文章：

3. 使用 update-alternatives 管理 Python 版本

1. 使用 venv 创建虚拟环境