如何在 Go 中调用动态链接库（.so）中的函数

go 本身不直接支持运行时动态加载 .so 库，但可通过 cgo 调用 posix 的 dlopen/dlsym 等 c 接口实现，需链接 -ldl 并正确处理 c 字符串与错误检查。

在 Go 中原生不提供类似 windows 下 LoadLibrary/GetProcaddress 或 linux 下纯 Go 实现的动态库加载机制。syscall.LoadLibrary 并不存在于现代 Go 标准库中——它属于已废弃的旧版 syscall 包（如 windows-only 的 golang.org/x/sys/windows 中有类似接口），且仅适用于 Windows 平台；在 Linux/macOS（POSIX 系统）上，必须借助 cgo 封装标准 C 动态链接 API。

以下是使用 cgo 调用 .so 文件中函数的完整、安全示例：

// #cgo LDFLAGS: -ldl // #include  // #include  import "C" import (     "fmt"     "unsafe" )  func callSymbolFromSO(soPath, symbolName string) {     // 1. 加载共享库（RTLD_LAZY 表示延迟解析符号）     cSoPath := C.CString(soPath)     defer C.free(unsafe.Pointer(cSoPath))     handle := C.dlopen(cSoPath, C.RTLD_LAZY)     if handle == nil {         errMsg := C.GoString(C.dlerror())         fmt.Printf("dlopen failed: %sn", errMsg)         return     }     defer C.dlclose(handle) // 记得释放句柄      // 2. 获取函数符号地址     cSymName := C.CString(symbolName)     defer C.free(unsafe.pointer(cSymName))     sym := C.dlsym(handle, cSymName)     if sym == nil {         errMsg := C.GoString(C.dlerror())         fmt.Printf("dlsym failed for '%s': %sn", symbolName, errMsg)         return     }      // 3. 类型转换并调用（⚠️关键：需知目标函数签名）     // 假设 libfoo.so 中定义了 int bar(int x, const char* msg)     // 则应声明对应 C 函数指针类型：     //     // typedef int (*bar_func)(int, const char*);     // bar_func f = (bar_func)sym;     // int ret = f(42, "hello from Go");     //     // 在 Go 中需通过 unsafe.Pointer 转换，并严格匹配 ABI。     // 示例（调用无参 void 函数）：     // (*[0]byte)(sym) // 仅获取地址；实际调用需借助 reflect 或更安全的封装（如 github.com/google/codesearch/... 不推荐生产直接裸调）      fmt.Printf("Successfully loaded symbol '%s' at address %pn", symbolName, sym) }

重要注意事项：

• ✅ 必须启用 cgo：编译时确保 CGO_ENABLED=1（默认开启），且系统安装了 gcc 和 libc-dev（Linux）或 xcode command line tools（macOS）。
• ✅ 显式链接 -ldl：#cgo LDFLAGS: -ldl 不可省略，否则链接失败。
• ⚠️ C 字符串生命周期管理：C.CString 分配的内存必须手动 C.free，否则导致内存泄漏。
• ⚠️ 类型安全需自行保障：dlsym 返回 unsafe.Pointer，Go 无法校验函数签名。错误的类型断言会导致崩溃或未定义行为。强烈建议：
  • 将 C 函数声明为 //export 并在 Go 中定义对应 type（如 type MyFunc func(int) float64），再用 (*MyFunc)(unsafe.Pointer(sym)) 转换；
  • 或使用封装库（如 github.com/ebitengine/purego，支持纯 Go 动态调用，无需 cgo）；
• ⚠️ 错误检查不可省略：每次 dlopen/dlsym 后应检查 handle == nil 或调用 C.dlerror() 获取详细错误。
• ? 不支持跨平台抽象：此方案仅适用于 Linux/macos；Windows 需用 syscall.LoadDLL + FindProc（见 golang.org/x/sys/windows）。

综上，虽然 Go 没有内置 .so 加载器，但通过 cgo + libdl 是成熟、可控的解决方案。生产环境建议进一步封装为类型安全的 Loader 结构体，并添加符号缓存、自动错误映射等能力，以提升可维护性与鲁棒性。