M1 Mac安装PyAutoGui构建wheel失败报权限不足及PEP 517错误如何解决

问题核心原因 #

本次报错有两个根本诱因：

• pip缓存目录权限不足，导致构建生成的wheel无法写入缓存
• M1架构缺少PyAutoGui依赖的macOS图形接口组件，触发PEP 517构建失败报错

修复步骤 #

1. 重置pip缓存目录权限 #

执行以下命令将pip缓存目录的所有者修改为当前用户，解决权限拒绝报错：

sudo chown -R $(whoami) ~/Library/Caches/pip

执行时输入当前用户的开机密码即可（输入时密码不会显示，正常输入回车即可）。

2. 安装M1适配的系统依赖 #

先确保已安装Homebrew包管理器，执行以下命令安装PyAutoGui必须的 macOS Python 接口依赖：

brew install pyobjc-core pyobjc

该组件是M1芯片原生适配版本，安装完成后即可解决图形相关依赖的构建问题。

3. 执行PyAutoGui安装 #

优先使用标准命令安装：

pip3 install pyautogui

如果仍报PEP 517相关错误，添加参数跳过PEP 517强制检查即可：

pip3 install pyautogui --no-use-pep517

如果存在全局Python环境权限冲突，可以改用用户目录安装模式：

pip3 install pyautogui --user

安装验证 #

执行以下命令，输出版本号即代表安装成功：

python3 -c "import pyautogui; print(pyautogui.__version__)"

注意事项 #

如果使用conda、venv等虚拟环境，需先激活对应环境再执行上述所有pip相关命令，避免全局环境和虚拟环境的命令混用。

内容的提问来源于stack exchange，提问作者Nishant