Linux系统安装Python3及多版本切换环境管理

大雪君_4844

大雪君_4844

2026-04-15

1032人浏览

原创

直接修改/usr/bin/python软链接风险极高,易导致apt等系统工具异常;推荐用update-alternatives系统级管理或pyenv用户级管理,确保python与pip路径一致。

linux系统安装python3及多版本切换环境管理

直接改 /usr/bin/python 软链接风险极高

很多新手会用 sudo rm /usr/bin/python && sudo ln -s /usr/bin/python3.10 /usr/bin/python 这种方式“切换默认 Python”,结果导致 apt、dnf 甚至桌面环境部分组件异常——因为这些系统工具内部硬依赖 python3 或特定版本,但不依赖 python 命令本身。一旦你把 /usr/bin/python 指向一个非系统预装版本(比如自己编译的 3.12),而该版本缺少 distutils 或未安装 python3-distutils 包,apt install 就会报 ModuleNotFoundError: No module named 'distutils.util'。

真正安全的做法是:只让项目或用户层控制解释器,系统级命令保持原样。除非你明确知道哪些服务调用了 python 并已验证兼容性,否则别碰这个软链接。

update-alternatives 是最轻量的系统级切换方案

它不修改任何文件,只是在 /usr/bin/python 和多个候选路径之间建立可配置的符号映射,适合运维人员或需临时切全局默认的场景。

  • 先注册所有可用版本(注意优先级数字越大越优先):
    sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 1
    sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 2
    sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.12 3
  • 交互式切换:
    sudo update-alternatives --config python,输入编号即可
  • 验证是否生效:
    python --version 和 readlink -f $(which python) 必须一致
  • 注意:如果某版本是 make altinstall 安装到 /opt/python312/bin/python3.12,必须用完整路径注册,不能只写 python3.12

pyenv 适合开发者按项目隔离 Python 版本

它不改系统任何路径,所有版本装在用户目录(如 $HOME/.pyenv/versions/),通过 shell 函数动态插入 PATH 前置位。这是目前 Linux 下最主流、最可靠的多版本管理方式。

Python Testing
Python Testing

Python 测试速查:运行 pytest、使用 mock/patch、参数化、fixtures、异步、覆盖率测试。

下载

常见踩坑点:

  • 安装后忘记在 ~/.bashrc 或 ~/.zshrc 中添加 eval "$(pyenv init -)",导致命令不可用
  • 用 pyenv install 3.12.3 失败,大概率缺编译依赖——Ubuntu/Debian 需 libffi-dev,CentOS/RHEL 需 libffi-devel,漏一个都会卡在 configure: error: no acceptable C compiler found in $PATH 或 ModuleNotFoundError: _ctypes
  • pyenv global 3.12.3 后 python --version 不变?执行 hash -r 清掉 shell 命令缓存再试
  • 项目根目录下运行 pyenv local 3.8.10,进入该目录后自动生效;但若目录里有 .python-version 文件被 Git 忽略,协作时别人就看不到这个约束

虚拟环境必须和 Python 版本管理解耦使用

venv 本身不管理解释器版本,它只基于当前激活的 python 创建隔离空间。所以你得先确定底层解释器是谁,再建环境。

  • 想用 Python 3.10 创建虚拟环境:
    /usr/bin/python3.10 -m venv myproject-env,而不是 python3 -m venv(后者取决于 python3 指向谁)
  • 用 pyenv 时,推荐配合 pyenv-virtualenv 插件:
    pyenv virtualenv 3.10.6 myproject-310,然后 pyenv local myproject-310
  • 不要在系统 Python(如 /usr/bin/python3.8)上直接 pip install --user 大量包,容易污染系统 site-packages,引发权限或升级冲突

最关键的细节:无论用哪种方式切换,pip 命令必须和 python 对齐。检查 python -m pip --version 输出的 Python 路径,必须和 which python 一致——这是唯一能确认环境没“错位”的方法。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

2590

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

5963

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

7502

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

3667

16

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

909

5

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.25

2520

5

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

5419

9

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2023.07.06

1640

6

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

2023.07.24

954

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习