Mac安装pyenv踩过的坑

最新推荐文章于 2025-10-21 13:05:08 发布

原创最新推荐文章于 2025-10-21 13:05:08 发布 · 3k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#python #pyenv #mac

python 同时被 2 个专栏收录

15 篇文章

订阅专栏

mac

5 篇文章

订阅专栏

本文详细介绍了使用Pyenv管理Python版本时可能遇到的问题及解决方案，包括如何正确安装和配置Pyenv，解决镜像源下载速度慢的问题，以及如何处理zipimport.ZipImportError等错误。同时，还提供了配置依赖和加速国内下载的方法。

部署运行你感兴趣的模型镜像

优点不多说了，坑如下：

使用pyenv来管理，实际上这个玩意有个不足之处是：（参考这个）

Pyenv只会管理通过Pyenv安装的Python版本，你自己在Python官网上下载的直接安装的Pyenv并不能被管理！！！同样除了系统默认的python包外，其他直接安装的python包是识别不出来的，即使用brew安装的也识别不出来。

Git地址：https://github.com/pyenv/pyenv

Mac安装可以直接用Homebrew：

brew install pyenv

常用命令：

pyenv version  # 当前的Python版本
这是个坑：会显示：system (set by /root/.pyenv/version)  # system表示系统安装的版本
pyenv versions  # 所有的Python版本（不在pyenv中安装的不会显示）
pyenv install --list  # 可安装的Python列表
pyenv install 3.7.2  # 安装指定的Python版本
pyenv global 3.7.2  # 指定全局版本（设定完这个，然后去终端输入python或python3依旧是系统版本python3.7.2则没有该命令，应该说该命令只在pyenv环境下生效）
pyenv uninstall 3.7.2  # 删除指定的Python版本

pyenv install 3.7.2 坑：

镜像源下载Python太慢：

参考这里，这个讲的原理我喜欢：

其实呢， Pyenv 下载各种 Python 的二进制程序包，都是会首先放到自己的这个 ~/.pyenv/cache 目录下面的。在需要下载什么文件之前， Pyenv 会先到这个目录找以前是否下载过了，如果已经下载好就直接使用这个目录里面对应的文件。

没有cache目录，mkdir一个即可。然后把不管你从什么途径下载的Python安装包放进去即可，就省的换国内镜像源了，源码安装包后缀要.tar.xz格式的。

pyenv install 3.7.2坑：

zipimport.ZipImportError: can't decompress data; zlib not available

系统需要安装的依赖：

brew install zlib
brew install sqlite  # 若依旧报错，其他依赖根据log信息自行安装

安装完依赖依旧有坑：

要配置相应的配置文件：

参考这里，我的是~/.zshrc文件

vim ~/.zshrc

# For compilers to find  xxx  you may need to set:
export LDFLAGS="${LDFLAGS} -L/usr/local/opt/zlib/lib"
export CPPFLAGS="${CPPFLAGS} -I/usr/local/opt/zlib/include"
export LDFLAGS="${LDFLAGS} -L/usr/local/opt/sqlite/lib"
export CPPFLAGS="${CPPFLAGS} -I/usr/local/opt/sqlite/include"
# For pkg-config to find  xxx  you may need to set:
export PKG_CONFIG_PATH="${PKG_CONFIG_PATH} /usr/local/opt/zlib/lib/pkgconfig"
export PKG_CONFIG_PATH="${PKG_CONFIG_PATH} /usr/local/opt/sqlite/lib/pkgconfig"

log报错给出的配置建议没有这个，要加上这个：${...}玩意，并且还要

source ~/.zshrc

使之生效。不过在下次进入，重新pyenv install 3.6.5的时候，依旧需要重新source ~/.zshrc，需要永久生效参考这个吧，我没试。

最后才折腾成功，用pyenv安装上Python其他版本。

至于包管理，也很头疼，pyenv-virtualenv的使用方法以后用到再搞搞。目前直接在pycharm配置Python解释器时安装的，PyCharm菜单→Preference→Project:xxx→Project Interpreter→添加完相应的Python版本后，再在相应的版本下双击、搜索、安装包。