0

0

Ubuntu系统下pyenv的安装与Python版本管理教程

心靈之曲

心靈之曲

发布时间:2025-07-21 16:38:01

|

695人浏览过

|

来源于php中文网

原创

Ubuntu系统下pyenv的安装与Python版本管理教程

本教程旨在解决Ubuntu系统中pyenv命令未找到的问题,详细指导用户如何正确安装pyenv及其依赖,配置shell环境,并利用pyenv高效管理和切换多个Python版本,特别是如何安装和设置为默认Python 3.8,确保开发环境的灵活性与稳定性。

理解“命令未找到”错误

当您在尝试配置pyenv环境变量(如export pyenv_root和export path)并执行eval "$(pyenv init --path)"时遇到“command 'pyenv' not found”的错误,这通常意味着pyenv工具本身尚未安装在您的系统上。那些环境变量的配置和eval命令的执行,都是在pyenv成功安装后,用于将其集成到您的shell环境中。因此,首要任务是完成pyenv的实际安装过程。

安装pyenv

pyenv的安装可以通过其官方提供的安装脚本来简化。在执行安装脚本之前,请确保您的系统已安装curl工具,curl用于从网络下载文件。

  1. 检查并安装curl 大多数Ubuntu系统默认已安装curl。如果未安装,您可以使用以下命令进行安装:

    sudo apt-get update
    sudo apt-get install -y curl
  2. 执行pyenv安装脚本 使用curl下载并运行pyenv的自动安装脚本。这个脚本会负责下载pyenv及其依赖到您的用户目录下(通常是~/.pyenv)。

    curl https://pyenv.run | bash

    执行此命令后,脚本会打印出一些后续的配置说明,请务必仔细阅读。这些说明通常包括将pyenv相关的环境变量添加到您的shell配置文件中。

配置Shell环境

pyenv安装完成后,您需要将其路径添加到系统的环境变量中,并初始化pyenv,以便您的shell能够识别并使用pyenv命令。这些配置通常需要添加到您的shell启动文件,例如Bash用户的~/.bashrc或Zsh用户的~/.zshrc。

  1. 编辑Shell配置文件 打开您的shell配置文件(以~/.bashrc为例):

    nano ~/.bashrc
    # 或者使用您喜欢的文本编辑器,如 vim ~/.bashrc
  2. 添加pyenv配置行 在文件的末尾添加以下几行:

    export PYENV_ROOT="$HOME/.pyenv"
    export PATH="$PYENV_ROOT/bin:$PATH"
    eval "$(pyenv init --path)"
    • export PYENV_ROOT="$HOME/.pyenv":定义pyenv的安装根目录。
    • export PATH="$PYENV_ROOT/bin:$PATH":将pyenv的可执行文件路径添加到您的系统PATH中,这样您就可以直接在命令行中运行pyenv命令。
    • eval "$(pyenv init --path)":初始化pyenv,将其集成到您的shell中,使其能够正确地管理Python版本。
  3. 使配置生效 保存并关闭文件后,您需要重新加载shell配置文件,或者关闭并重新打开终端,以使更改生效:

    source ~/.bashrc
    # 如果您使用的是zsh,则为 source ~/.zshrc

    此时,您应该可以成功执行pyenv命令,例如运行pyenv versions来查看已安装的Python版本。

    立即学习Python免费学习笔记(深入)”;

使用pyenv管理Python版本

pyenv安装并配置完成后,您就可以利用它来安装和管理多个Python版本了。

MusicLM
MusicLM

谷歌平台的AI作曲工具,用文字生成音乐

下载
  1. 安装特定Python版本 要安装您需要的Python版本,例如Python 3.8,可以使用pyenv install命令:

    pyenv install 3.8

    这个过程可能需要一些时间,因为pyenv会下载Python源代码并进行编译。

  2. 查看已安装的Python版本 安装完成后,您可以使用pyenv versions命令查看所有由pyenv管理的Python版本:

    pyenv versions

    输出会列出所有版本,当前激活的版本会有一个星号标记。

  3. 设置全局Python版本 如果您希望将某个Python版本设置为系统默认的全局版本,可以使用pyenv global命令:

    pyenv global 3.8

    执行此命令后,无论您在哪个目录下,默认使用的Python版本都将是3.8。

  4. 设置局部Python版本(可选) 在特定的项目目录下,您可能希望使用不同于全局设置的Python版本。这时可以使用pyenv local命令:

    cd your_project_directory
    pyenv local 3.8

    这会在当前目录下创建一个.python-version文件,指定该目录及其子目录使用的Python版本。

注意事项与总结

  • 安装顺序至关重要:务必先执行pyenv的安装脚本,然后再配置shell环境变量并进行初始化。颠倒顺序会导致“命令未找到”错误。
  • Shell配置生效:在修改了~/.bashrc或~/.zshrc等配置文件后,必须通过source命令重新加载配置或重启终端,才能使更改生效。
  • Python版本管理:pyenv提供了一种非侵入式的Python版本管理方式,它不会干扰系统自带的Python版本,而是将不同版本的Python安装到用户目录下,并通过修改PATH环境变量来切换。
  • 依赖问题:在某些情况下,pyenv install命令可能会因为缺少编译Python所需的系统依赖而失败。如果遇到此类问题,请查阅pyenv的官方GitHub仓库或相关社区文档,了解如何安装这些依赖。

通过遵循本教程的步骤,您应该能够成功在Ubuntu系统上安装和配置pyenv,并灵活地管理您的Python开发环境,满足不同项目对Python版本的要求。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

455

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

183

2023.10.30

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

4448

2026.01.21

常见的linux系统有哪些
常见的linux系统有哪些

linux系统有Ubuntu、Fedora、CentOS、Debian、openSUSE、Arch Linux、Gentoo、Slackware、Linux Mint、Kali Linux。更多关于linux系统的文章详情请阅读本专题下面的文章。php中文网欢迎大家前来学习。

858

2023.10.27

ubunt上安装和配置vnc
ubunt上安装和配置vnc

安装方法:安装VNC服务器、启动VNC服务器、设置VNC密码等等。想了解更多ubuntu的相关内容,可以阅读本专题下面的文章。

431

2023.12.28

ubuntu启动黑屏解决方法
ubuntu启动黑屏解决方法

ubuntu启动黑屏解决方法:检查是否是电源问题、检查内存是否接触不良、检查显卡问题等。想了解更多ubuntu的相关内容,可以阅读本专题下面的文章。

675

2023.12.28

为什么ubuntu有网络连接但不能上网
为什么ubuntu有网络连接但不能上网

ubuntu有网络连接但不能上网的原因:1、dns配置问题;2、代理服务器设置问题;3、网络防火墙设置问题;4、路由器或调制解调器设置问题;5、网络驱动程序问题;6、网络配置文件问题;7、其他问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

478

2024.09.05

ubuntu安装golang
ubuntu安装golang

本专题整合了ubuntu安装golang所有方法汇总,阅读下面的文章了解更多详细操作。

113

2025.12.13

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

69

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号