Ubuntu 系统安装 Python 与 pip 超详细教程(新手友好)

14次阅读
没有评论

对于刚接触 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)

四、可选优化:设置软链接(简化命令)

默认情况下,我们需要输入 python3pip3 才能调用工具,新手可以设置软链接,直接用 pythonpip 命令,更方便:

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 默认使用国外源,下载第三方库速度极慢,甚至会超时。我们配置国内镜像源(清华 / 阿里源),大幅提升下载速度。

方法:永久配置国内源(推荐)

  1. 在用户目录下创建 pip 配置文件夹:

bash

运行

mkdir ~/.pip
  1. 创建并编辑配置文件:

bash

运行

nano ~/.pip/pip.conf
  1. 将以下内容复制粘贴到文件中(清华源,速度最快):

ini

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
  1. 保存退出:按 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。


总结

  1. Ubuntu 自带 Python3,无需手动下载安装,直接用就行;
  2. 一行命令 sudo apt install python3-pip 即可安装 pip;
  3. 配置国内源是必做操作,解决 pip 下载慢的问题;
  4. 软链接可以简化命令,新手推荐设置。

至此,Ubuntu 系统的 Python + pip 环境就完全配置好了,可以开始你的 Python 开发之旅啦!🎉

正文完
可以使用微信扫码关注公众号(ID:xzluomor)
post-qrcode
 0
评论(没有评论)
验证码