苹果M1芯片macOS安装virtualenv运行时报RuntimeError错误求助
问题原因
触发该报错的核心是当前virtualenv调用关联了系统自带的Python 2.7版本:
- 新版virtualenv已经完全移除了对Python 2.7的支持(Python 2.7已于2020年停止官方维护),不存在适配Python 2.7的实现逻辑
- M1芯片为arm64架构,macOS自带的Python 2.7是为x86架构编译的,本身就存在架构兼容性问题,无法正常适配新版virtualenv
注意事项
- 不要尝试修改或删除系统自带的Python 2.7,macOS 部分底层服务依赖该版本,随意修改可能导致系统运行异常
解决步骤
- 卸载已安装的适配Python 2.7的virtualenv
执行命令:pip uninstall -y virtualenv - 安装适配arm64架构的Python 3版本,可通过Homebrew安装或直接从Python官网下载M1专用安装包,安装完成后执行以下命令验证可用性:
python3 --version pip3 --version - 使用pip3安装对应Python 3版本的virtualenv
执行命令:pip3 install virtualenv - (可选)配置zsh默认调用Python 3,避免后续再触发Python 2的兼容问题
打开zsh配置文件:nano ~/.zshrc,在文件末尾添加如下配置:
保存退出后执行alias python="python3" alias pip="pip3"source ~/.zshrc让配置立即生效 - 验证配置结果
执行命令:virtualenv --version,正常输出版本号即为修复完成
如果不想修改全局别名,也可以直接使用python3 -m virtualenv 虚拟环境名称的命令直接创建虚拟环境。
内容的提问来源于stack exchange,提问作者Shubham Bansal
相关产品推荐
相关产品推荐

