文章目录
- 一、检查系统现有 Python 版本
- 二、安装官方源的 Python
- 三、Python官网下载安装指定版本 Python（如 3.13）
-
- 1. 更新软件源
- 2. 安装编译必需的依赖
- 3. 下载并编译安装 Python 3.13
- 4. 验证安装结果
- 5. 设置 3.13 为系统默认 Python 版本
- 6. 最终验证
- 四、常见问题解决
一、检查系统现有 Python 版本
首先打开终端（快捷键 Ctrl+Alt+T），执行以下命令查看已安装的 Python 版本：
python3 –version
如果输出 Python 3.x.x（如 3.8、3.10），说明已预装 Python 3； 如果提示 command not found，则需要手动安装。
二、安装官方源的 Python
Ubuntu 官方软件源包含稳定版 Python，安装步骤如下：
sudo apt update
sudo apt install -y python3-dev python3-setuptools build-essential
sudo apt install -y python3
-y 表示自动确认安装，无需手动输入 y； 安装完成后，再次执行 python3 –version 验证是否成功。
sudo apt install -y python3-pip
验证 pip：
pip3 –version
三、Python官网下载安装指定版本 Python（如 3.13）
如果需要特定版本（比如项目要求 3.11），可通过 deadsnakes 第三方源安装（安全可靠）：
1. 更新软件源
sudo apt update
2. 安装编译必需的依赖
sudo apt install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev wget libbz2-dev
3. 下载并编译安装 Python 3.13
cd /tmp
wget https://www.python.org/ftp/python/3.13.0/Python-3.13.0.tgz
如果下载慢，可替换为国内镜像（如清华源）：
wget https://mirrors.tuna.tsinghua.edu.cn/python/3.13.0/Python-3.13.0.tgz
tar -xf Python-3.13.0.tgz
cd Python-3.13.0
# 配置安装路径（默认 /usr/local/python3.13），并启用 pip
./configure –enable-optimizations –prefix=/usr/local/python3.13
–enable-optimizations：优化 Python 性能（编译稍慢，但运行更快）； –prefix：指定安装目录，避免覆盖系统自带 Python。
# 编译（-j 后接 CPU 核心数，比如 4，加快编译速度）
make -j $(nproc)
# 安装（不会替换系统 Python）
sudo make altinstall
用 altinstall 而非 install：避免覆盖系统默认的 python3 命令，防止系统依赖出错。
4. 验证安装结果
# 检查 3.13 版本
/usr/local/python3.13/bin/python3.13 –version
# 检查 3.13 的 pip
/usr/local/python3.13/bin/pip3.13 –version
如果输出 Python 3.13.0 和 pip 版本，说明安装成功。
5. 设置 3.13 为系统默认 Python 版本
# 为 python3 命令创建软链接（指向 3.13）
sudo update-alternatives –install /usr/bin/python3 python3 /usr/local/python3.13/bin/python3.13 100
# 为 pip3 命令创建软链接
sudo update-alternatives –install /usr/bin/pip3 pip3 /usr/local/python3.13/bin/pip3.13 100
100 是优先级，数值越高，默认选中的概率越大。
# 配置 python3 默认版本
sudo update-alternatives –config python3
# 配置 pip3 默认版本
sudo update-alternatives –config pip3
执行后会列出所有 Python 版本，输入 3.13 对应的编号，按回车即可。
6. 最终验证
# 查看默认 Python 3 版本
python3 –version # 应输出 Python 3.13.0
# 查看默认 pip3 版本
pip3 –version # 应关联到 Python 3.13
# 测试运行
python3 -c "print('Python 3.13 已设为默认版本！')"
四、常见问题解决
pip3版本错误：
pip3 –version
Traceback (most recent call last):
File "/usr/bin/pip3", line 6, in <module>
from pkg_resources import load_entry_point
ModuleNotFoundError: No module named 'pkg_resources'
备份旧的 pip3 脚本（防止误删）
sudo mv /usr/bin/pip3 /usr/bin/pip3.bak
# 清理可能的残留软链接
sudo rm -f /usr/local/bin/pip3
# 创建新的 pip3 软链接，指向 Python 3.13 的 pip3.13
sudo ln -s /usr/local/python3.13/bin/pip3.13 /usr/bin/pip3
# 检查 pip3 版本（应关联到 Python 3.13）
pip3 –version
正常输出示例：
pip 24.2 from /usr/local/python3.13/lib/python3.13/site-packages/pip (python 3.13)
如果仍有小问题（比如提示 pip 需要升级），执行：
# 升级 pip3 到最新版本
pip3 install –upgrade pip
