macOS 15.5下PyCuba安装失败及导入异常求助

方案一：修复 brew 安装后的路径与链接问题 #

brew 安装的 Cuba 在 macOS 下生成的是 .dylib 文件而非 .so，PyCuba 默认查找 .so，需手动配置软链接并指定路径：

• 定位 brew 安装的 Cuba 库路径：

  brew --prefix cuba
  

  M 系列芯片输出类似 /opt/homebrew/Cellar/cuba/4.2.2，Intel 芯片输出类似 /usr/local/Cellar/cuba/4.2.2，其 lib 目录为 ${输出路径}/lib。
• 进入对应 lib 目录，创建 .dylib 到 .so 的软链接：

  # M系列芯片示例
  ln -s /opt/homebrew/lib/libcuba.dylib /opt/homebrew/lib/libcuba.so
  # Intel芯片示例
  ln -s /usr/local/lib/libcuba.dylib /usr/local/lib/libcuba.so
  

• 将该 lib 路径添加到环境变量：
  临时生效执行：

  # M系列芯片
  export LD_LIBRARY_PATH=/opt/homebrew/lib:$LD_LIBRARY_PATH
  # Intel芯片
  export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
  

  永久生效可将上述命令添加到 ~/.zshrc（zsh）或 ~/.bash_profile（bash）末尾，执行 source ~/.zshrc 刷新配置。

方案二：修改源码编译脚本适配 macOS #

源码自带的 makesharedlib.sh 适配 Linux，需修改参数适配 macOS：

• 克隆源码并生成目标文件：

  git clone https://github.com/JohannesBuchner/Cuba.git
  cd Cuba
  make
  

• 替换 makesharedlib.sh 内容为：

  clang -dynamiclib -o libcuba.dylib cuba.o -lm
  ln -s libcuba.dylib libcuba.so
  

• 执行脚本生成共享库：

  chmod +x makesharedlib.sh
  ./makesharedlib.sh
  

• 将生成的库文件复制到系统库目录：

  sudo cp libcuba.* /usr/local/lib/
  

验证安装 #

执行以下命令确认 PyCuba 可正常导入：

python3 -c 'import pycuba; print("PyCuba 导入成功")'

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