Python3虚拟环境构建

在 Linux 开发环境中，直接使用系统自带的 Python（System Python）是一项禁忌——这极易导致系统依赖冲突。

为了实现开发环境的隔离，miniconda 和 pyenv 是目前最为主流的两套方案。

一、 方案选择：我该用哪一个？

二、 方案一：Miniconda（快速、强大、全能）

Miniconda 是 Anaconda 的轻量化版本，仅包含 Conda 包管理器和 Python，非常适合空间有限但需要强大依赖管理的环境。

1. 安装步骤

1
2
3
4
5
6
7
8

# 更新系统
sudo apt update && sudo apt upgrade -y

# 下载安装脚本
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

# 执行安装
bash Miniconda3-latest-Linux-x86_64.sh

提示：安装过程中建议在 Do you wish the installer to initialize Miniconda3 by running conda init? 处输入 yes。

将conda添加到系统路径：export PATH=/root/miniconda3/bin:$PATH

2. 核心操作

• 创建环境：conda create -n myenv python=3.12
• 激活环境：conda activate myenv
• 退出环境：conda deactivate
• 删除环境：conda remove -n myenv --all

3. 路径查找

Conda 的环境路径非常统一，通常位于用户目录下的 envs 文件夹内。

• 查看环境列表及路径：conda env list

• 查找解释器路径：

  激活环境后执行 which python，通常路径为：

  ~/miniconda3/envs/myenv/bin/python

三、 方案二：pyenv（优雅、多版本、原生）

pyenv 让你可以在同一台机器上安装多个 Python 版本（如 3.8.10, 3.11.2），并根据项目需求随时切换。

1. 安装编译依赖

由于 pyenv 会从源码编译 Python，请务必先安装以下依赖：

1
2
3
4

sudo apt update
sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

2. 安装 pyenv

1

curl https://pyenv.run | bash

配置环境变量：将以下代码添加到 ~/.bashrc 或者 ~/.zshrc 末尾：

1
2
3

export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

执行 source ~/.bashrc 或者 source ~/.zshrc 使其生效。

3. 使用技巧与路径查询

• 安装指定版本：`pyenv install 3.12.12

• 查看已安装版本：pyenv versions

• 查找解释器绝对路径：

  使用 pyenv which python

  例如，3.11.5 版本的路径通常位于：

  /home/用户名/.pyenv/versions/3.11.5/bin/python

4. 配合 venv 使用（最佳实践）

进入项目目录后：

1
2
3

pyenv local 3.11.5          # 锁定项目 Python 版本
python -m venv .venv        # 创建项目内虚拟环境
source .venv/bin/activate    # 激活

此时，pip 和 python 的路径均位于项目下的 .venv/bin/ 目录内。

四、 总结：如何快速定位 Python 解释器？

无论你使用哪种方案，如果你需要在 IDE（如 VS Code）中手动指定路径，可以使用以下“万能命令”：

1
2

# 在当前激活的环境下运行，直接输出解释器绝对路径
python -c "import sys; print(sys.executable)"

路径速查表