如何将C动态库嵌入Go二进制文件并控制其加载时机？

针对你的需求，有几个更简便的方案可以避免Go提前加载C动态库，完全不需要用Go插件：

1. 手动动态加载C库（最可靠的方案） #

Go的cgo默认会在程序启动阶段自动链接并加载依赖的动态库，绕过这个机制的核心是不依赖cgo的自动链接，自己手动加载动态库。具体步骤：

• 不要在Go代码里直接用#cgo LDFLAGS链接目标共享库，而是在C代码（或Go通过syscall调用系统API）中使用dlopen（Linux/macOS）或LoadLibrary（Windows）手动加载共享库。
• 先把embed的共享库解压到临时目录，再调用手动加载函数，加载完成后通过dlsym/GetProcAddress获取C库的函数指针，之后再调用这些函数。

示例代码思路：

package main

import (
	"embed"
	"os"
	"syscall"
)

//go:embed libfoo.so
var libFoo embed.FS

func main() {
	// 1. 解压共享库到临时目录
	tmpDir, err := os.MkdirTemp("", "lib")
	if err != nil {
		panic(err)
	}
	defer os.RemoveAll(tmpDir) // 程序退出时清理临时文件

	libPath := tmpDir + "/libfoo.so"
	data, _ := libFoo.ReadFile("libfoo.so")
	os.WriteFile(libPath, data, 0755)

	// 2. 手动加载库
	handle, err := syscall.Dlopen(libPath, syscall.RTLD_NOW)
	if err != nil {
		panic(err)
	}
	defer syscall.Dlclose(handle)

	// 3. 获取函数指针并调用
	funcPtr, err := syscall.Dlsym(handle, "foo_function")
	if err != nil {
		panic(err)
	}
	// 转换为对应的函数类型并调用（需要根据C函数签名定义）
	foo := func() int {
		return int(syscall.SyscallN(uintptr(funcPtr), 0))
	}
	println(foo())
}

2. 利用链接器选项实现延迟加载 #

如果不想手动处理动态加载，可以通过修改cgo的链接选项，让系统链接器延迟加载动态库，直到第一次调用C函数时才加载：

• 在Linux下，添加#cgo LDFLAGS: -Wl,-z,lazy，这个选项会告诉链接器不要在程序启动时解析库的符号，而是在第一次调用时才加载库。
• 配合将所有C库调用逻辑放在非init阶段的函数中，先完成共享库的解压，再调用这些函数。同时需要确保解压后的库路径在系统的库搜索路径中（比如临时修改LD_LIBRARY_PATH环境变量）。

注意：这个方案的局限性是如果C库包含__attribute__((constructor))之类的初始化函数，这些函数还是会在库加载时执行，可能无法完全控制时机。

3. 封装C调用逻辑，延迟初始化 #

把所有依赖C库的代码封装到一个单独的模块中，确保Go代码不会在启动阶段触发C库的加载：

• 不要在全局变量、init函数中调用任何C代码，所有C相关调用都放在一个InitCLib()函数里。
• 主程序先完成共享库的解压操作，设置好正确的库路径（比如修改LD_LIBRARY_PATH），再调用InitCLib()初始化C库相关逻辑。

结合方案2的链接器选项，就能确保C库在你指定的时机才被加载。

关键注意事项 #

• 临时目录权限：解压后的共享库需要设置可执行权限（如0755），否则系统无法加载。
• 路径处理：手动加载时一定要用绝对路径，或者确保临时目录在LD_LIBRARY_PATH中，避免系统找不到库。
• 跨平台兼容：不同操作系统的动态加载API不同，需要用Go的条件编译（//go:build linux等）处理差异。

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