Mac下Python3环境安装virtualwrapper报错及解决
发布时间：2026-10-13| 6人浏览过
本文介绍在Mac系统中使用Homebrew安装的Python3环境下配置virtualwrapper时，因默认指向系统Python2导致模块找不到的错误。通过修改~/.bash_profile中的VIRTUALENVWRAPPER_PYTHON环境变量指向Python3路径，成功解决该问题并实现虚拟环境管理。
Mac下Python3环境安装virtualwrapper报错及解决
前言
在Mac上使用virtualwrapper时曾遇到配置难题，经过反复调试才最终解决。现将整个过程整理分享，帮助遇到相同困扰的用户避免踩坑，快速完成配置。
问题背景
问题背景
Mac系统默认内置的是Python2版本，而开发者通常通过Homebrew安装并使用Python3。这种版本差异可能导致工具链指向错误。
安装步骤与报错分析
以下是安装过程中遇到的具体错误提示
1. 安装virtualwrapper
首先打开终端，执行以下命令进行基础安装：
pip3 install virtualenv
pip3 install virtualenvwrapper2. 在配置文件~/.bash_profile中添加代码
# Settings for virtualenvwrapper
export WORKON_HOME=$HOME/.virtualenvs
source /usr/local/bin/virtualenvwrapper.sh3. 使配置生效：
source ~/.bash_profile此时终端返回如下错误信息：
/usr/bin/python: No module named virtualenvwrapper
virtualenvwrapper.sh: There was a problem running the initialization hooks.
If Python could not import the module virtualenvwrapper.hook_loader,
check that virtualenvwrapper has been installed for
VIRTUALENVWRAPPER_PYTHON=/usr/bin/python and that PATH is
set properly.原因分析与解决方案
原因分析
报错信息中明确指出“VIRTUALENVWRAPPER_PYTHON=/usr/bin/python”，说明当前环境变量指向了系统自带的Python2路径。由于我们使用的是Homebrew安装的Python3，因此需要修正该环境变量以指向正确的Python3路径。
解决办法
编辑配置文件 vim ~/.bash_profile，在文件中添加以下行以指定Python3路径：
export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python3保存后，重新加载配置使其生效：
source ~/.bash_profile再次尝试创建虚拟环境，问题即可解决。
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
