Ubuntu 24.04 安装与配置 pyenv

Date: 2026/1/24

Q:

ubuntu 24.04 安装pyenv

A:

Ubuntu 24.04 安装与配置 `pyenv`

1) 安装依赖

bash 复制代码

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 版本/模块可能用到）：

bash 复制代码

sudo apt install -y llvm libncursesw5-dev

2) 安装 pyenv

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

bash 复制代码

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

3) 配置 Shell 环境（关键）

按你使用的 shell 选择其一。

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

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

bash 复制代码

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

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

然后加载配置：

bash 复制代码

source ~/.bashrc

B. 使用 zsh

追加到 ~/.zshrc：

bash 复制代码

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

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

然后加载：

bash 复制代码

source ~/.zshrc

4) 验证安装

bash 复制代码

pyenv --version

5) 安装 Python（示例）

查看可安装版本：

bash 复制代码

pyenv install --list

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

bash 复制代码

pyenv install 3.12.2

设置全局默认：

bash 复制代码

pyenv global 3.12.2

验证当前 Python：

bash 复制代码

python -V
which python

6) 常用命令速查

查看已安装版本：
bash 复制代码
```
pyenv versions
```
当前生效版本：
bash 复制代码
```
pyenv version
```
仅对当前目录生效（生成 .python-version）：
bash 复制代码
```
pyenv local 3.12.2
```

常见问题

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

通常是 shell 初始化没生效：

确认 ~/.bashrc / ~/.zshrc 里已加入 PYENV_ROOT、PATH、pyenv init
重新打开终端或 source ~/.bashrc
确认：
bash 复制代码
```
echo $PATH | tr ':' '\n' | head
```
应该能看到 ~/.pyenv/bin 相关路径

Ubuntu 24.04 安装与配置 pyenv

Q:

A:

Ubuntu 24.04 安装与配置 pyenv

1) 安装依赖

2) 安装 pyenv

3) 配置 Shell 环境（关键）

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

B. 使用 zsh

4) 验证安装

5) 安装 Python（示例）

6) 常用命令速查

常见问题

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

Ubuntu 24.04 安装与配置 `pyenv`

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