推荐用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环境需求，不复杂但容易忽略细节。
