Linux Python环境配置教学_Linux多版本Python管理方法

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Linux Python环境配置教学_Linux多版本Python管理方法

2025-12-12

浏览次数：次

返回列表

推荐用pyenv管理多Python版本并用venv创建项目级虚拟环境：pyenv实现用户级版本隔离，安装后通过pyenv install安装指定版本、pyenv global/local设置默认或局部版本；venv则在项目目录中执行python -m venv .venv创建独立环境，source .venv/bin/activate激活，避免依赖冲突。

linux python环境配置教学_linux多版本python管理方法

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版本，但仍要注意几个常见坑：

Codeium

一个免费的AI代码自动完成和搜索工具

345 查看详情 Codeium

确保未激活任何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