推荐用 pyenv 管理多 Python 版本并用 venv 创建项目级虚拟环境：pyenv 实现用户级版本隔离，安装后通过 pyenv install 安装指定版本、pyenv global/local 设置默认或局部版本；venv 则在项目目录中执行 python -m venv .venv 创建独立环境，source .venv/bin/activate 激活，避免依赖冲突。
Linux 系统自带 Python，但版本通常较旧，开发中常需多个 Python 版本共存。直接修改系统 Python 可能引发系统 工具 异常，所以推荐用版本管理工具隔离环境。
用 pyenv 管理多版本 Python
pyenv 是轻量级、用户级的 Python 版本管理器，不依赖 root 权限，安装和切换版本简单直观。
- 安装 pyenv（推荐用 curl 方式）：
curl https://pyenv.run | bash
然后将以下三行加入 ~/.bashrc 或~/.zshrc：
export PYENV_ROOT=”$HOME/.pyenv”
command -v pyenv >/dev/null || export PATH=”$PYENV_ROOT/bin:$PATH”
eval “$(pyenv init -)”
执行source ~/.bashrc（或source ~/.zshrc）生效 - 查看可安装的 Python 版本：
pyenv install –list | grep “^s*[0-9]” - 安装指定版本（如 3.11.9）：
pyenv install 3.11.9 - 设置全局默认版本：
pyenv global 3.11.9
或仅对当前目录生效：
pyenv local 3.10.12
用 venv 创建项目级 虚拟环境
pyenv 解决“版本共存”，venv 解决“项目依赖隔离”。每个项目应配独立虚拟环境，避免包冲突。
- 进入项目目录后，用当前 pyenv 激活的 Python 创建环境：
python -m venv .venv - 激活环境：
source .venv/bin/activate
激活后命令行前缀会显示(.venv) - 退出环境：
deactivate - 推荐在 .gitignore 中加入.venv/，不提交虚拟环境目录
pip 与包管理注意事项
使用 pyenv+venv 后，pip 自动绑定对应 Python 版本，但仍要注意几个常见坑：
立即学习“Python 免费学习笔记（深入）”；
- 确保未激活任何 venv 时运行which pip，应指向~/.pyenv/shims/pip；若指向/usr/bin/pip，说明 pyenv 未生效
- 升级 pip 建议用 python -m pip install –upgrade pip，比直接运行pip install –upgrade pip 更可靠
- 导出依赖用pip freeze > requirements.txt，还原用pip install -r requirements.txt
- 避免用sudo pip，它会污染系统 pip，也绕过 pyenv 控制
常见问题 快速排查
遇到命令找不到、版本不对、pip 报错时，按顺序检查这几项：
- 确认 shell 配置已重载（echo $PYENV_ROOT应有输出）
- 运行 pyenv version 看当前生效版本，pyenv versions看已安装版本
- 检查是否意外激活了 venv（命令行有括号提示），导致 which python 指向错误路径
- 编译安装失败？先装好系统依赖：
Ubuntu/Debian：sudo apt install -y make build-essential libssl-dev libffi-dev python3-dev
CentOS/RHEL：sudo yum groupinstall “Development Tools” && sudo yum install openssl-devel libffi-devel python3-devel
基本上就这些。pyenv + venv 组合足够覆盖日常开发中 95% 的 Python 环境需求，不复杂但容易忽略细节。
