M1（Arm架构）Mac Big Sur下Python无法加载GLFW3共享库

报错原因定位 #

遇到的ImportError: Failed to load GLFW3 shared library本质是两类问题：一是M1架构下Homebrew/MacPorts安装的GLFW路径和Python pyglfw包的默认查找路径不匹配，二是存在二进制架构不兼容、系统安全机制拦截的问题。

可落地解决步骤 #

• 第一步：完成架构匹配校验
  分别执行命令确认二进制架构完全匹配：
  1. 查看当前使用的Python版本架构：file /Library/Frameworks/Python.framework/Versions/3.9/bin/python3.9
  2. 查看已安装的GLFW动态库架构：
     • Homebrew安装路径下的库：file /opt/homebrew/lib/libglfw.3.dylib
     • MacPorts安装路径下的库：file /opt/local/lib/libglfw.3.dylib
       两个文件的架构标识必须完全一致，如果Python是x86_64转译版本，对应的GLFW也必须是x86_64架构，不能混用arm64版本的动态库。
• 第二步：手动指定GLFW动态库的加载路径
  pyglfw默认不会扫描M1版Homebrew的库路径，之前尝试的brew link glfw --force没有实际作用——因为pyglfw的查找逻辑不依赖Homebrew的软链路径，仅扫描macOS默认的系统库目录。只需要在代码里显式指定库位置即可：
  在所有导入glfw的代码最前面加上路径配置，替换成你实际的库路径：

  import os
  os.environ['PYGLFW_LIBRARY'] = "/opt/homebrew/lib/libglfw.3.dylib"
  import glfw
  

  也可以全局永久配置路径，在~/.zshrc文件末尾添加对应环境变量，执行source ~/.zshrc生效即可：
  export PYGLFW_LIBRARY=/opt/homebrew/lib/libglfw.3.dylib
• 第三步：处理Big Sur系统的安全拦截
  如果是自行从源码编译的GLFW库，会被MacOS的隔离机制拦截，需要移除隔离属性：
  xattr -d com.apple.quarantine /opt/homebrew/lib/libglfw.3.dylib
  同时确认库文件具备可执行权限：
  chmod 755 /opt/homebrew/lib/libglfw.3.dylib
• 第四步：升级pyglfw到适配版本
  旧版本的pyglfw对M1架构的路径适配存在bug，先卸载现有包再重装最新版：

  pip3 uninstall glfw -y
  pip3 install --upgrade glfw
  

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