Ubuntu 24.04 安装与配置 pyenv

Date: 2026/1/24

---

Q:

ubuntu 24.04 安装pyenv

A:

Ubuntu 24.04 安装与配置 pyenv

1) 安装依赖

sudo apt update
sudo apt install -y git curl make build-essential \
  libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev \
  libffi-dev liblzma-dev tk-dev xz-utils \
  ca-certificates

可选（有些 Python 版本/模块可能用到）：

sudo apt install -y llvm libncursesw5-dev

---

2) 安装 pyenv

推荐用官方安装脚本（会安装到 ~/.pyenv）：

curl -fsSL https://pyenv.run | bash

---

3) 配置 Shell 环境（关键）

按你使用的 shell 选择其一。

A. 使用 bash（Ubuntu 默认常见）

把下面内容追加到 ~/.bashrc：

cat >> ~/.bashrc <<'EOF'

# pyenv
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - bash)"
EOF

然后加载配置：

source ~/.bashrc

B. 使用 zsh

追加到 ~/.zshrc：

cat >> ~/.zshrc <<'EOF'

# pyenv
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - zsh)"
EOF

然后加载：

source ~/.zshrc

---

4) 验证安装

pyenv --version

---

5) 安装 Python（示例）

查看可安装版本：

pyenv install --list

安装一个版本（示例 3.12.2）：

pyenv install 3.12.2

设置全局默认：

pyenv global 3.12.2

验证当前 Python：

python -V
which python

---

6) 常用命令速查

• 查看已安装版本：

  pyenv versions

• 当前生效版本：

  pyenv version

• 仅对当前目录生效（生成 .python-version）：

  pyenv local 3.12.2

---

常见问题

pyenv: python: command not found 或版本切换不生效

通常是 shell 初始化没生效：

1. 确认 ~/.bashrc / ~/.zshrc 里已加入 PYENV_ROOT、PATH、pyenv init

2. 重新打开终端或 source ~/.bashrc

3. 确认：

   echo $PATH | tr ':' '\n' | head

   应该能看到 ~/.pyenv/bin 相关路径

---