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 初始化没生效:

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

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

  3. 确认:

    bash 复制代码
    echo $PATH | tr ':' '\n' | head

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


相关推荐
谙弆悕博士9 分钟前
多智能体架构详解:层级树状架构(分级主从型)
运维·架构·大模型·agent·多智能体·langgraph·层级树状
戊本菌41 分钟前
进程(三)进程优先级:谁先上 CPU
linux·c语言·硬件架构
学无止境小袁同学1 小时前
Google ADK 学习指南
python·llm·agent·多agent·google adk·llmagent·agent cli
aningx2 小时前
Arch 系用 greetd 实现开机自动进 Plasma Wayland,注销自动回桌面
linux
郝学胜-神的一滴2 小时前
Effective Python 条款35:用类封装替代生成器异常注入
开发语言·人工智能·python·金融·pandas·scikit-learn·matplotlib
江无行者2 小时前
Linux 服务器 top 命令详解
linux
LK_072 小时前
【力扣】142. 环形链表 II |Python
python·leetcode·链表
wuyk5552 小时前
Python办公自动化-第02讲-Excel文件认知与四大库选型
开发语言·python·excel
HMS工业网络2 小时前
工业远程访问的五项安全部署原则
运维·服务器·安全