很多小伙伴在 Ubuntu/Debian 系统中,直接使用 apt-get install python3.10 安装 Python3.10 时,会遇到如下经典报错,导致安装失败:
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
E: Unable to locate package python3.10
E: Couldn't find any package by glob 'python3.10'
E: Couldn't find any package by regex 'python3.10'
本文将深度剖析报错原因,提供Ubuntu 快捷安装和Debian 通用源码安装两种方案,同时汇总常见踩坑问题,一站式解决 Python3.10 安装难题。
一、报错核心原因
该报错本质是系统默认软件源无 Python3.10 安装包,具体分为3种情况:
- 系统版本过低:Ubuntu20.04及以下、Debian10 官方原生源不自带 Python3.10
- 缺少第三方源:官方默认源仅收录系统适配的Python版本,高版本Python需借助专属PPA源
- 镜像源限制:阿里、清华等国内镜像源,不会同步Python多版本第三方仓库
二、Ubuntu 系统快速解决方案(推荐)
Ubuntu 系统可通过 deadsnakes 官方PPA源 快速安装任意版本Python,无需编译,操作简单、稳定高效。
1. 安装依赖工具
先安装PPA源添加所需的依赖组件:
apt update && apt install -y software-properties-common
2. 添加Python专属PPA源
add-apt-repository ppa:deadsnakes/ppa
3. 更新软件缓存
添加源后必须更新缓存,系统才能识别Python3.10安装包:
apt update
4. 安装Python3.10及配套工具
安装完整运行环境,包含开发依赖、分发工具,避免后续模块报错:
apt install -y python3.10 python3.10-dev python3.10-distutils
5. 单独安装Python3.10专属pip
通过官方脚本安装对应版本pip,保证依赖安装适配:
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3.10 get-pip.py
Ubuntu一键安装脚本
懒人专属,一键执行全部安装步骤:
apt update && apt install -y software-properties-common && add-apt-repository ppa:deadsnakes/ppa -y && apt update && apt install -y python3.10 python3.10-dev python3.10-distutils
三、Debian 系统解决方案(无PPA支持)
Debian 系统不支持PPA源,且原生系统无Python3.10版本(Debian11最高3.9、Debian12最高3.11),只能通过源码编译安装,适配所有Debian版本。
1. 安装编译依赖
apt update
apt install -y build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev
2. 下载Python3.10源码包
wget https://www.python.org/ftp/python/3.10.15/Python-3.10.15.tgz
3. 解压并进入目录
tar -xf Python-3.10.15.tgz
cd Python-3.10.15
4. 编译&安装
./configure --enable-optimizations
make -j$(nproc)
make altinstall
重要提示:务必使用
altinstall而非install,不会覆盖系统默认Python版本,避免系统命令、工具崩溃!
四、高频踩坑问题修复
1. add-apt-repository 命令不存在
缺少源管理工具,执行以下命令安装即可:
apt install software-properties-common
2. 添加PPA后update报GPG密钥错误
密钥失效导致源验证失败,重新导入密钥:
apt-key adv --keyserver keyserver.ubuntu.com --recv-keys F23C5A6CF475977595C89F51BA6932366A755776
五、版本使用说明(避坑建议)
安装完成后,不要直接修改系统默认python3软链接,会导致系统异常。
直接指定版本调用即可,完美多版本共存:
# 查看Python3.10版本
python3.10 --version
# 使用对应版本pip
pip3.10 --version
六、总结
1. Ubuntu系统优先使用 deadsnakes PPA源,一键安装、简单高效;
2. Debian系统只能通过源码编译安装,禁止替换系统默认Python;
3. 国内镜像源无法解决该问题,必须手动添加Python专属第三方源;
4. 多版本Python建议独立调用,保证系统稳定性。