LoongLee's blog

pyenv使用指南

pyenv使用指南

来源

原始文档: pyenv_use.md

核心内容

pyenv 是 Python 版本管理工具,允许在同一系统中安装和切换多个 Python 版本。

安装脚本

#!/bin/bash
# 安装 pyenv
curl https://pyenv.run | bash

# 配置环境变量
export PYENV_ROOT="$HOME/.pyenv"
 -d $PYENV_ROOT/bin  && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - bash)"
eval "$(pyenv virtualenv-init -)"

配置会自动添加到 ~/.bashrc 或 ~/.zshrc。

版本管理

# 查看当前版本
pyenv version

# 查看所有已安装版本
pyenv versions

# 查看可安装版本列表
pyenv install --list

# 安装指定版本
pyenv install 3.11.11
pyenv install 3.10.16
pyenv install 3.8.10

# 卸载指定版本
pyenv uninstall 3.x

版本切换

# 全局默认版本
pyenv global 3.10.16
pyenv global system

# 当前目录版本(写入 .python-version)
pyenv local 3.6.15

# 当前 shell 会话版本
pyenv shell 3.10.16
pyenv shell --unset  # 取消

# 查看 Python 路径
pyenv which python

虚拟环境

# 创建虚拟环境
pyenv virtualenv 3.8.10 yolov5-env

# 激活虚拟环境
pyenv activate voice2text_env

# 在 shell 中激活
pyenv shell yolov5-env

# 退出虚拟环境
pyenv shell --unset

# 删除虚拟环境
pyenv virtualenv-delete my-env

pip 使用

# 导出依赖
pip freeze > requirements.txt

# 使用清华镜像安装
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name

关键要点

  • pyenv global 设置系统默认 Python 版本
  • pyenv local 在当前目录创建 .python-version 文件
  • pyenv shell 仅对当前终端会话生效
  • 虚拟环境名称可自定义,与 Python 版本解耦

相关实体

  • pyenv - Python 版本管理器
  • Python - Python 编程语言
  • 虚拟环境 - Python 虚拟环境
  • pip - Python 包管理器