一、检查系统现有 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
- 安装 python 完整依赖
sudo apt install -y python3-dev python3-setuptools build-essential
- 安装 python 3(默认安装最新稳定版)
sudo apt install -y python3
-y 表示自动确认安装,无需手动输入 y;
安装完成后,再次执行 python3 --version 验证是否成功。
- 安装 pip(python 包管理工具,必装)
pip 是安装 python 第三方库的核心工具,安装命令:
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
- 下载 python 3.13.0 源码(官网最新稳定版,可替换为对应版本号)
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
- 配置编译参数(关键:保留系统 python,添加 pip)
# 配置安装路径(默认 /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 版本
- 创建软链接(将 3.13 加入系统命令)
# 为 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 是优先级,数值越高,默认选中的概率越大。
- 确认默认版本(可选)
如果系统有多个 python 版本,执行以下命令手动选择 3.13:
# 配置 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 脚本
先移除导致冲突的旧文件,避免干扰:
备份旧的 pip3 脚本(防止误删) sudo mv /usr/bin/pip3 /usr/bin/pip3.bak # 清理可能的残留软链接 sudo rm -f /usr/local/bin/pip3
- 重新创建 pip3 软链接(指向 python 3.13 的 pip3.13)
直接将 pip3 硬链接到 python 3.13 的 pip3.13,绕过 update-alternatives 的残留问题:
# 创建新的 pip3 软链接,指向 python 3.13 的 pip3.13 sudo ln -s /usr/local/python3.13/bin/pip3.13 /usr/bin/pip3
- 验证修复效果
执行以下命令,确认 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
总结
到此这篇关于ubuntu下载安装python并设置默认python版本的文章就介绍到这了,更多相关ubuntu下载安装python设置默认内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论