必须用pyenv隔离版本——它不修改系统Python，所有版本都装在用户目录下，切换时只改当前shell的PATH；需先安装编译依赖，再用curl或git安装pyenv，配置环境变量后即可安装并切换3.8、3.11、3.12等多版本。
在统信UOS上需要为不同项目分别使用Python 3.8、3.11和3.12，又不想破坏系统自带的Python 3.10环境，就必须用pyenv隔离版本——它不修改系统Python，所有版本都装在用户目录下，切换时只改当前shell的PATH。
安装pyenv依赖工具
先装齐编译Python源码必需的底层组件，缺一个后续编译就会卡在configure或make阶段：
执行sudo apt update → sudo apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libgdbm-dev libnss3-dev libffi-dev libxz-dev。
其中libffi-dev和libssl-dev最容易被漏掉，不装它们，后面安装3.11+版本时会报“_ctypes module not built”或“No module named _ssl”错误。
下载并安装pyenv
方法一：用官方安装脚本（推荐）
运行curl https://pyenv.run | bash，等待下载完成并自动执行安装逻辑。
这一步会在$HOME/.pyenv创建目录，并把pyenv代码拉到里面。
方法二：手动克隆（适合网络受限环境）
执行git clone https://github.com/pyenv/pyenv.git ~/.pyenv。
注意：必须用https协议，用git@地址会因SSH密钥缺失失败。
配置shell环境变量
第一步：向~/.bashrc追加三行初始化代码echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrcecho 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrcecho 'eval "$(pyenv init -)"' >> ~/.bashrc
第二步：立即加载新配置source ~/.bashrc
【必须执行这一步，否则终端里找不到pyenv命令】
第三步：验证是否生效
输入pyenv --version，应输出类似pyenv 2.4.12的版本号；若提示“command not found”，说明source没成功或.bashrc路径不对。
安装指定Python版本
① 查看可安装列表：pyenv install --list | grep "^[0-9]\+\.[0-9]\+\.[0-9]\+$" | tail -n 10（只显示最新10个稳定版）
② 安装Python 3.12.3：pyenv install 3.12.3，全程自动下载、解压、configure、make、install，约需6–12分钟。
③ 设为当前shell默认版本：pyenv shell 3.12.3，此后该终端中python --version就返回3.12.3。
④ 若想设为全局默认（所有新终端都用这个）：pyenv global 3.12.3。
⑤ 验证效果：python --version 和 which python 应指向$HOME/.pyenv/versions/3.12.3/bin/python。
配置国内镜像加速下载
pyenv默认从python.org下载源码包，国内直连常超时失败。执行以下命令启用清华镜像：export PYTHON_BUILD_MIRROR_URL=https://mirrors.tuna.tsinghua.edu.cn/python/
然后把它写进~/.bashrc永久生效：echo 'export PYTHON_BUILD_MIRROR_URL=https://mirrors.tuna.tsinghua.edu.cn/python/' >> ~/.bashrcsource ~/.bashrc。
下次运行pyenv install 3.11.9时，就会自动从清华镜像站拉取Python-3.11.9.tgz，速度提升5倍以上。
