Go MIDI PortMidi 安装编译教程

本文详解在 Go 项目中正确安装和使用 PortMidi（通过 `rakyll/portmidi` 封装）的完整流程，重点解决因系统包管理器提供的 `libportmidi` 缺失符号（如 `Pt_Start`）导致的链接错误。

在 Linux 系统中直接执行 go get github.com/rakyll/portmidi 常会失败，并报出类似以下关键错误：

/usr/bin/ld: ... undefined reference to symbol 'Pt_Start'
/usr/lib/libporttime.so.0: error adding symbols: DSO missing from command line

该错误本质是 动态链接阶段缺失 PortTime 库符号，根本原因在于：大多数发行版（如 Ubuntu/Debian）仓库中的 libportmidi0 包仅包含运行时库，未提供完整的静态链接支持或配套的 libporttime 开发头文件与库，而 rakyll/portmidi 的 CGO 构建依赖于 PortMidi 源码级编译环境（含 porttime 子模块）。

✅ 正确解决方案：从官方源码手动编译安装 PortMidi（含 PortTime），而非依赖系统包管理器。

✅ 推荐步骤（以 Linux 为例）

1. 下载并解压官方源码
   访问 PortMIDI 官方 SourceForge 页面，下载 portmidi-src-217.zip 并解压：

   wget http://sourceforge.net/projects/portmedia/files/portmidi/217/portmidi-src-217.zip/download -O portmidi.zip
   unzip portmidi.zip
   cd portmidi/pm_linux

2. 编译并安装（需 root 权限）
   进入 pm_linux 目录后，执行标准 GNU 构建流程：

   make clean
   make
   sudo make install

   ⚠️ 注意：默认安装路径为 /usr/local（头文件到 /usr/local/include/portmidi/，库文件到 /usr/local/lib/libportmidi.so 和 /usr/local/lib/libporttime.so）。确保后续 Go 构建能识别该路径。

3. 配置 CGO 环境变量（关键！）
   在运行 go get 前，显式告知 CGO 链接器所需库路径与名称：

   export CGO_LDFLAGS="-L/usr/local/lib -lportmidi -lporttime"
   export CGO_CFLAGS="-I/usr/local/include/portmidi"
   go get github.com/rakyll/portmidi

   若使用 Go Modules，建议在项目根目录下验证：

   // main.go
   package main
   
   import (
       "log"
       "github.com/rakyll/portmidi"
   )
   
   func main() {
       if err := portmidi.Initialize(); err != nil {
           log.Fatal(err)
       }
       defer portmidi.Terminate()
       log.Println("PortMidi initialized successfully!")
   }

   运行 go run main.go 应输出初始化成功日志。

? 补充说明与注意事项

• ❌ 避免使用 apt install libportmidi-dev 或 yum install portmidi-devel：这些包通常不包含 libporttime，或版本不匹配，无法满足 rakyll/portmidi 的 CGO 构建要求。
• ✅ 手动编译的优势：可精确控制 ABI 兼容性、启用调试符号、支持交叉编译（需调整 makefile）。
• ? 若需静态链接，可在 CGO_LDFLAGS 中添加 -static-libgcc -static-libstdc++（需对应静态库存在）。
• ? macOS 用户：推荐使用 Homebrew 安装 portmidi（brew install portmidi），因其已预处理依赖关系；Windows 用户建议使用 MSYS2 + pacman -S mingw-w64-x86_64-portmidi。

通过源码编译 PortMidi，你将获得完整、可链接的开发环境，彻底规避 DSO missing from command line 和 undefined reference to 'Pt_Start' 等典型链接失败问题。