Mac环境下以sudo权限运行Python脚本时keyboard模块导入报错的解决方法

核心根因：Python 解释器与 pip 安装源不匹配 #

macOS 默认预装多套独立的 Python 环境，你遇到的「sudo pip 安装成功但脚本提示找不到模块」，本质是pip 给另一套 Python 环境装了keyboard模块，和你运行脚本调用的解释器不是同一个：

• 第一步先定位两个关键路径：
  • 执行 sudo which python，获取运行脚本时实际调用的Python解释器绝对路径，常见路径包括：
    • /usr/bin/python：系统自带的Python 2 环境
    • /usr/local/bin/python3：Intel芯片Mac通过Homebrew安装的Python3
    • /opt/homebrew/bin/python3：Apple芯片Mac通过Homebrew安装的Python3
  • 执行 sudo which pip，对比两个命令输出的路径关联的Python版本——如果两者不对应，就会出现安装无效的问题
• 正确的安装操作：放弃直接调用裸的sudo pip命令，通过目标解释器的内置pip模块强制安装，确保包装到对应解释器的搜索路径下：
  假设你查到运行脚本的Python路径是/opt/homebrew/bin/python3，则执行安装命令：
  sudo /opt/homebrew/bin/python3 -m pip install keyboard
  这种安装方式可以完全避免环境路径错配的问题。

次要触发原因：sudo 环境的 Python 路径隔离 #

root用户的Python模块搜索路径和普通用户相互独立，如果你之前是在普通用户权限下安装的keyboard模块，root环境不会识别普通用户目录下的site-packages包，同样会触发导入错误。通过上文提到的「解释器绝对路径 + -m pip」的安装方式，可以直接把包装到对应解释器的系统级包路径下，被root环境正常识别。

macOS 全局键盘监听的使用注意点 #

解决完导入问题后，运行keyboard.on_press_key()相关脚本不需要强制使用sudo提权：

• macOS 对全局键盘监听的拦截是系统隐私策略管控，和用户权限等级无关。只需要在「系统设置-隐私与安全性」中，给运行脚本的终端程序开启「辅助功能」「输入监控」两项权限，普通用户身份就可以正常触发按键回调
• 长期以root身份运行全局键盘监听脚本存在安全风险，无需为了绕过系统监听限制刻意提权。

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