Ubuntu/Debian Linux下使用apt安装Python 3和pip

云舒
云舒
发布时间:2026-11-21| 9人浏览过
原创

在Ubuntu和Debian Linux系统中使用apt包管理器安装Python 3、pip以及虚拟环境管理工具的完整实用指南,包含安装步骤、版本验证、PEP 668机制解析与常见问题排查。

在基于 Debian 的 Linux 发行版中,通过系统自带的高级软件包工具(APT)安装 Python 3 和 pip 是最稳定且与系统底层依赖完全兼容的途径。只需更新本地软件源索引,执行标准包管理命令安装 python3、python3-pip 以及配套的 python3-venv,即可快速完成运行环境的就绪配置。

一、理解 apt 管理的系统 Python 架构

Ubuntu 与 Debian 操作系统在底层系统运维、网络管理与安装程序中重度依赖 Python 3。当我们在这些系统中使用 apt 安装 Python 时,实际上接入的是发行版维护团队经过全面兼容性测试与安全性补丁维护的软件栈。

与自行下载源码编译或使用第三方脚本安装不同,apt 会自动处理依赖层级关系,将解释器可执行文件置于 /usr/bin/python3,将标准库与系统级第三方扩展分别存放于 /usr/lib/python3/ 和 /usr/lib/python3/dist-packages/。这种机制确保了操作系统自身关键服务(如 cloud-init、ufw、软件更新器等)的稳定运作。

Ubuntu/Debian Linux下使用apt安装Python 3和pip
图 1:apt 软件源分发的 Python 架构与运行隔离边界

二、安装步骤与完整操作演示

在终端中执行安装操作时,必须严格按照“更新索引、执行安装、确认版本、建立隔离”的标准顺序进行。这不仅能避免因本地缓存过期引发的 404 找不到软件包错误,还能确保获取到当前发行版软件源中最稳定的补丁版本。

步骤 1:更新本地 apt 软件源索引

在安装新软件包前,首先请求镜像源更新本地包元数据信息:

sudo apt update

输出示例(节选):

Hit:1 http://archive.ubuntu.com/ubuntu jammy InRelease
Get:2 http://archive.ubuntu.com/ubuntu jammy-updates InRelease [115 kB]
Get:3 http://security.ubuntu.com/ubuntu jammy-security InRelease [110 kB]
Reading package lists... Done
Building dependency tree... Done
All packages are up to date.

步骤 2:安装 Python 3、pip 与 venv 模块

在 Debian/Ubuntu 体系下,Python 解释器、pip 包管理器以及虚拟环境模块是分包打包的。推荐在一行命令中同时指定安装这三个核心包:

sudo apt install python3 python3-pip python3-venv -y

参数解释:

  • python3:安装 Python 3 的基础核心解释器及常用标准库。
  • python3-pip:安装对应的 pip3 命令行工具及依赖组件。
  • python3-venv:安装标准库虚拟环境构建模块(在现代发行版中至关重要)。
  • -y:在安装确认提示中自动回答 yes,方便无人值守或自动化运维。

步骤 3:验证安装结果与版本信息

安装完成后,直接调用对应二进制程序的版本参数检查是否成功安装并正常输出:

python3 --version
pip3 --version

输出示例:

$ python3 --version
Python 3.10.12

$ pip3 --version
pip 22.0.2 from /usr/lib/python3/dist-packages/pip (python 3.10)

如果能正确看到版本号以及 pip 的安装物理路径,说明解释器和包管理工具均已正确加载到系统 PATH 路径中。

Ubuntu/Debian Linux下使用apt安装Python 3和pip
图 2:从安装到准备工程虚拟环境的五步标准流水线

三、现代 Linux 下的 pip 规范与 PEP 668 解析

许多初次在较新版本系统(如 Ubuntu 23.04/24.04 LTS、Debian 12 Bookworm)上使用 pip 的开发者,直接运行 pip3 install requests 时会遭遇以下报错:

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.

这是 Python 官方实施的 PEP 668 规范。在过去,直接执行 sudo pip3 install 会将第三方包写入 /usr/local/lib/python3.x/dist-packages/,这极易覆盖系统自带的核心模块版本,导致后续 apt upgrade 崩溃或系统依赖失效。PEP 668 通过在系统目录放置 EXTERNALLY-MANAGED 标记文件,主动保护系统环境。

官方推荐的解决途径:使用虚拟环境(venv)

要安装业务开发所需的 Python 第三方模块,正规做法是为每个项目创建独立的隔离环境:

# 1. 进入工作目录并创建名为 .venv 的虚拟环境
cd ~/my_project
python3 -m venv .venv

# 2. 激活虚拟环境
source .venv/bin/activate

# 3. 在虚拟环境中自由使用 pip 安装第三方库(无需 sudo)
pip install requests numpy

# 4. 退出当前虚拟环境
deactivate

在虚拟环境被激活后,终端提示符前会带有 (.venv) 标识。此时调用的 pip 和 python 均直接指向当前目录下的沙箱,无论安装、升级还是卸载任何库,都绝对不会对操作系统产生任何副作用。

Ubuntu/Debian Linux下使用apt安装Python 3和pip
图 3:PEP 668 环境管控与虚拟环境工程方案对比

四、常见问题排查与维护注意事项

在日常使用与维护过程中,有若干与 apt 和 Python 相关的典型现象需要特别注意:

1. 终端输入 python 提示命令未找到(Command not found)

Ubuntu 和 Debian 自版本演进中移除了对旧版 Python 2 的默认软链接。安装 python3 后,系统默认只注册了 python3 命令。如果希望输入 python 时自动指向 python3,可以安装官方别名桥接包:

sudo apt install python-is-python3

该包会在 /usr/bin/python 建立指向 /usr/bin/python3 的符号链接,无需自行手动修改软链接,规范且能被包管理器正常记录跟踪。

2. 全局命令行工具的替代方案:pipx

如果希望安装的是如 black、flake8、ansible 等命令行工具,且希望在任何终端路径都能直接运行该命令,可以使用专门为 CLI 工具设计的隔离包管理器 pipx:

# 安装 pipx
sudo apt install pipx
pipx ensurepath

# 之后无需激活虚拟环境,工具会自动安装在独立沙箱并暴露全局命令
pipx install black

高危提醒:绝对不要执行 sudo apt remove python3

在 Debian 和 Ubuntu 操作系统中,桌面环境、包管理器前端、网络配置脚本等核心组件均绑定了系统自带的 python3。强行卸载 python3 会触发连带的级联删除(Cascading Removal),导致桌面系统崩溃或服务器网络断连。如果需要特定版本的 Python,建议使用 pyenv 或 Docker 容器,切勿改动系统底层的默认 Python。

Ubuntu/Debian Linux下使用apt安装Python 3和pip
图 4:Ubuntu/Debian 体系下 Python 运行时与包管理实践总结

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。