结论是:别碰系统自带的python3,用pyenv管理3.6和3.10最稳、最干净、维护成本最低;它通过私有目录安装、shell函数劫持和项目级.version文件实现精准隔离,不修改系统路径,配合pyenv-virtualenv可彻底解决包污染,systemd服务需硬编码绝对路径锁定解释器。

直接说结论:别碰系统自带的 python3,用 pyenv 管理 3.6 和 3.10 是最稳、最干净、后续维护成本最低的方式。手动改 PATH 或重命名 python3.6/python3.10 可行但极易出错,尤其在云服务器这种无人值守环境里,一次 PATH 写错或脚本硬编码引用了错误路径,就可能让定时任务或 systemd 服务静默失败。
为什么 pyenv 比 update-alternatives 更适合云服务器
云服务器上跑的是长期驻留的服务(比如用 systemd 启动的 Flask API),不是你本地终端里临时切版本写 demo。update-alternatives 修改的是全局 /usr/bin/python3 符号链接,所有用户、所有服务都共享这一个“开关”——一旦你为调试临时切到 3.6,systemd 里依赖 3.10 的服务下次 reload 就可能启动失败,且日志里只报 ModuleNotFoundError,根本看不出是 Python 版本错了。
pyenv 则完全不碰系统路径:
- 它把每个版本装在 $HOME/.pyenv/versions/3.6.15 和 $HOME/.pyenv/versions/3.10.12 这类私有目录下
- 通过 shell 函数劫持 python 命令,按当前目录的 .python-version 文件或 PYENV_VERSION 环境变量决定调用哪个解释器
- 所有服务如果明确指定绝对路径(如 /home/ubuntu/.pyenv/versions/3.10.12/bin/python)就能彻底锁定版本,不受任何全局切换干扰
安装 pyenv 时必须装全的依赖项
Ubuntu 默认镜像(尤其是阿里云/腾讯云精简版)常缺编译 Python 所需的头文件和库,导致 pyenv install 3.6.15 报错“ssl module not found”或“sqlite3 module is not installed”。这不是 pyenv 的 bug,是系统缺包:
-
libssl-dev:否则_ssl模块编译失败,pip 无法联网 -
libsqlite3-dev:否则sqlite3模块缺失,Django/Flask 初始化数据库会崩 -
libbz2-dev和liblzma-dev:影响tarfile、zipfile等标准库功能 -
zlib1g-dev:压缩相关模块基础依赖
一次性装齐(别跳过):sudo apt update && sudo apt install -y make build-essential libssl-dev libsqlite3-dev libbz2-dev liblzma-dev zlib1g-dev libreadline-dev libncurses5-dev wget curl
创建项目级隔离环境,避免 pip 包污染
很多人以为装好两个版本就完事了,结果发现 pip install requests 装到哪去了根本不确定。关键点在于:pyenv 本身不解决 pip 隔离,必须配合 pyenv-virtualenv 插件。
操作流程:
- 先安装插件:git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
- 重启 shell 或执行 source ~/.bashrc
- 分别为两个版本建虚拟环境:
pyenv virtualenv 3.6.15 myproject-py36
pyenv virtualenv 3.10.12 myproject-py310
- 进入项目目录后,用 pyenv local myproject-py36 即可自动激活对应环境,此时 python 和 pip 都指向该虚拟环境内的副本,site-packages 完全独立
注意:pyenv virtualenv 创建的环境是基于 pyenv 安装的 Python 解释器,不是系统 Python,所以不会和 /usr/bin/python3 产生任何冲突。
systemd 服务中固定 Python 版本的写法
云服务器上用 systemd 管服务时,绝不能写 ExecStart=/usr/bin/python app.py 这种依赖全局 PATH 的命令。正确做法是写死绝对路径:
假设你的 Flask 应用放在 /opt/myapp,且用的是 pyenv 安装的 3.10.12:
ExecStart=/home/ubuntu/.pyenv/versions/3.10.12/bin/python /opt/myapp/app.py
这样即使你某天误删了 ~/.pyenv 下的 3.6,3.10 的服务依然照常运行。同理,Pip 安装也应使用该路径下的 pip:/home/ubuntu/.pyenv/versions/3.10.12/bin/pip install -r /opt/myapp/requirements.txt
真正的麻烦往往不在安装时,而在某个凌晨三点,你收到告警说 API 返回 500,登录一看发现是 ImportError: cannot import name 'dataclass' from 'typing'——这说明服务偷偷跑到了 3.6 上。根源就是没锁死解释器路径。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











