对于刚接触 Ubuntu 系统的开发者来说,Python 是必备的编程环境,而 pip 是 Python 官方的包管理工具,用来安装、管理第三方库。
很多新手会困惑:Ubuntu 其实自带 Python! 我们不需要手动下载源码编译,只需要简单几步,就能完成 Python 环境的配置和 pip 安装。本篇教程适配 Ubuntu 18.04/20.04/22.04/24.04 所有主流版本,全程命令行操作,复制粘贴即可完成!
一、前置准备:更新系统软件源
在安装任何软件前,先更新 Ubuntu 的软件源列表,避免安装时出现依赖错误、下载失败等问题。
打开终端(快捷键 Ctrl + Alt + T),执行以下命令:
bash
运行
# 更新软件源索引
sudo apt update
# 升级系统已安装的软件(可选,推荐执行)
sudo apt upgrade -y
输入管理员密码后,等待命令执行完成即可。
二、检查系统自带的 Python 版本
Ubuntu 18.04 及以上版本,默认已经预装 Python3(Python2 早已停止维护,无需安装)。
我们先检查自带的 Python 版本,确认环境存在:
bash
运行
# 查看 Python3 版本
python3 --version
执行后会输出类似结果:
plaintext
Python 3.10.12
✅ 说明 Python 已经预装完成,无需手动安装!
三、安装 pip(Python 包管理工具)
系统自带 Python,但默认没有安装 pip,这是我们需要手动安装的核心工具。
1. 安装 pip3
终端执行命令,安装 Python3 对应的 pip:
bash
运行
sudo apt install python3-pip -y
等待安装完成,全程无需手动确认。
2. 验证 pip 安装成功
安装完成后,检查 pip 版本:
bash
运行
# 检查 pip3 版本
pip3 --version
输出类似结果,代表安装成功:
plaintext
pip 22.0.2 from /usr/lib/python3/dist-packages/pip (python 3.10)
四、可选优化:设置软链接(简化命令)
默认情况下,我们需要输入 python3、pip3 才能调用工具,新手可以设置软链接,直接用 python、pip 命令,更方便:
bash
运行
# 将 python3 链接为 python
sudo ln -s /usr/bin/python3 /usr/bin/python
# 将 pip3 链接为 pip
sudo ln -s /usr/bin/pip3 /usr/bin/pip
设置完成后,直接测试:
bash
运行
python --version
pip --version
和之前的输出一致,说明软链接生效。
五、进阶:配置 pip 国内镜像源(加速下载)
pip 默认使用国外源,下载第三方库速度极慢,甚至会超时。我们配置国内镜像源(清华 / 阿里源),大幅提升下载速度。
方法:永久配置国内源(推荐)
- 在用户目录下创建 pip 配置文件夹:
bash
运行
mkdir ~/.pip
- 创建并编辑配置文件:
bash
运行
nano ~/.pip/pip.conf
- 将以下内容复制粘贴到文件中(清华源,速度最快):
ini
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
- 保存退出:按
Ctrl + O保存,Ctrl + X退出编辑器。
配置完成后,pip 下载第三方库的速度会提升几十倍!
六、测试环境:用 pip 安装第三方库
最后我们测试整个环境是否可用,安装一个常用的 requests 库:
bash
运行
pip install requests
如果安装成功,说明 Python + pip 环境完全配置完毕!
七、新手常见问题排查
问题 1:pip 安装包提示权限错误
原因:直接用系统级 pip 安装库,权限不足。
解决方案:添加 --user 参数,安装到当前用户目录:
bash
运行
pip install requests --user
问题 2:命令 pip 找不到
原因:软链接未设置成功。
解决方案:直接用 pip3 命令代替 pip 即可。
问题 3:软件源安装失败
解决方案:重新执行 sudo apt update,检查网络后重新安装 pip。
总结
- Ubuntu 自带 Python3,无需手动下载安装,直接用就行;
- 一行命令
sudo apt install python3-pip即可安装 pip; - 配置国内源是必做操作,解决 pip 下载慢的问题;
- 软链接可以简化命令,新手推荐设置。
至此,Ubuntu 系统的 Python + pip 环境就完全配置好了,可以开始你的 Python 开发之旅啦!🎉