解决 apt-get install python 报错：Package ‘python’ has no installation candidate

很多小伙伴在 Ubuntu / Debian 系统中执行 apt-get install python 安装 Python 时，会遇到经典的无安装候选报错，本文带大家彻底搞懂报错原因，提供极简可落地的解决方案，一次性解决问题。

一、完整报错信息

Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Package python is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source
However the following packages replace it:
  2to3 python-is-python3

E: Package 'python' has no installation candidate

二、报错核心原因

Ubuntu 20.04、22.04、24.04 及新版 Debian 系统，彻底废弃了 Python2，系统官方软件源中已经移除了python 这个空包。

新版系统默认仅预装/支持Python3，没有原生的 python 命令软链接，因此直接安装 python 会提示无安装候选。

系统报错提示的 python-is-python3 就是官方推荐的兼容解决方案。

三、分步正确安装方案（推荐）

该方案可同时安装 Python3、配置全局 python 命令、配套安装 pip，适配绝大多数开发场景。

1. 更新软件源索引

先同步最新的软件包列表，避免源缓存老旧导致安装失败：

sudo apt update

2. 安装官方 Python3

sudo apt install -y python3

3. 配置 python 命令兼容（关键步骤）

安装兼容包，让终端输入 python 自动指向 python3，适配旧版脚本、开发习惯：

sudo apt install -y python-is-python3

4. 安装 pip 包管理工具

开发必备，同时配置全局 pip 命令：

# 安装pip3
sudo apt install -y python3-pip
# 配置pip全局软链接
sudo ln -s /usr/bin/pip3 /usr/bin/pip

四、一键极速安装脚本

不想分步执行，直接复制一键命令，全套安装+配置完成：

sudo apt update && sudo apt install -y python3 python-is-python3 python3-pip && sudo ln -s /usr/bin/pip3 /usr/bin/pip

五、验证安装是否成功

执行以下命令，查看版本信息，有正常输出即配置成功：

# 查看python版本
python --version
python3 --version

# 查看pip版本
pip --version
pip3 --version

配置成功后，python 和 python3、pip 和 pip3 效果完全一致。

六、关键避坑说明

• 禁止安装 Python2：Python2 早已停止官方维护，存在大量安全漏洞，生产环境、开发环境均不推荐使用。
• 无需手动改环境变量：通过 python-is-python3 配置的软链接，是系统官方标准方案，稳定不冲突。
• 适配旧脚本：很多老旧代码、教程使用 python xxx.py 运行，配置兼容包后可直接运行，无需修改代码。
• 容器环境通用：Docker 内的 Ubuntu/Debian 基础镜像，该报错通用此方案解决。

七、总结

该报错不是源故障、不是系统问题，只是新版 Linux 系统 淘汰 Python2 后的正常现象。核心解决思路就是：安装原生 Python3 + 配置官方兼容软链接，即可完美解决命令不兼容、安装报错的所有问题。