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版本了。

冰舟分类信息系统
冰舟分类信息系统

冰舟分类信息系统说明:本次更新修改了部分错误,增加了自定义标签管理,这个版本后所有页面均可调用一个标签,大大的提升了效率使用前请先 运行 install.asp 文件进行安装程序!!安装时请填写好 ACCESS文件目录以及ACCESS文件名,请确保填写的信息与FTP上的完全吻合,否则会出错!!安装玩后请,务必删除 install.asp 文件! 本2.1版本含有强大的模板编辑功能,且初始模板均为D

下载
  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版本的要求。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

746

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

634

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

758

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1261

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

705

2023.08.11

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

10

2026.01.12

热门下载

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

精品课程

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

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

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

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