必须用完全相同的 go 版本（go version 输出一字不差）构建主程序和插件，且确保 runtime 和标准库 abi 一致；linux 需用 ldd 检查依赖库，windows 需用 dependencies.exe 查缺 dll，并统一 msvc 工具链。
Go 加载 .so 文件时 panic: “plugin.Open: plugin was built with a different version of package …” 怎么办
这是最典型的版本不匹配错误，不是路径或权限问题，而是 Go 编译器对插件和主程序的 runtime、标准库 ABI 做了严格校验。只要 go build 主程序和 go build -buildmode=plugin 插件用的不是同一份 Go 安装（哪怕只是 minor 版本不同，比如 1.21.6 vs 1.21.7），就会直接失败。
- 必须用完全相同的 Go 版本（
go version输出一字不差）构建主程序和插件 - 不能混用系统包管理器安装的 Go 和官方二进制安装的 Go（比如 macOS 上
brew install go和官网 .pkg 安装路径不同，GOROOT不同，会导致runtime包 hash 不一致） - CI/CD 中要显式锁定 Go 版本，例如 GitHub Actions 用
actions/setup-go@v4并指定go-version: '1.21.6'，而非'1.21' - 插件内避免 import 非标准库中可能随 Go 升级而变更的内部包（如
internal/abi、internal/syscall/unix）
为什么 plugin.Open() 返回 nil + error，但 error 消息是 “no such file or directory” 却文件明明存在
这不是文件没找到，而是动态链接失败：插件依赖的某个共享库（比如 libssl.so.3）在运行时不可见。Linux 的 dlopen 在解析依赖时失败，会统一包装成 ENOENT。
- 用
ldd your_plugin.so检查插件真实依赖链，确认所有=> not found条目都已解决 - 不要只看
ls -l，要验证LD_LIBRARY_PATH是否包含对应路径，或目标库是否在/etc/ld.so.conf.d/配置中 - 如果插件用了 CGO，且链接了静态库（如
-lfoo），确保构建时加了-extldflags "-static"或改用动态链接方式，否则运行时找不到符号 - 容器环境尤其要注意：基础镜像里缺
glibc衍生库（如libresolv.so.2），即使alpine镜像有musl，也不能加载 glibc 编译的.so
在 Windows 上用 plugin.Open() 加载 .dll 失败，提示 “The specified module could not be found.”
Windows 下这个错误绝大多数情况不是 DLL 本身丢失，而是它依赖的某个 DLL（尤其是 VC++ 运行时、OpenSSL、SQLite 等）不在 PATH 或当前目录。
- 用
Dependencies.exe（替代旧版 Dependency Walker）打开 DLL，看红色标记的缺失模块 - Go 主程序启动前，确保把插件及其所有依赖 DLL 放到同一目录，或把该目录加进
PATH（注意：仅修改os.Setenv("PATH", ...)对后续plugin.Open无效，必须在进程启动前设置） - 避免混用不同 MSVC 工具链：插件若用 VS2022 编译（
v143），主程序也得用同版本工具链构建，否则msvcp140.dll/vcruntime140.dll版本不兼容 - Go 1.21+ 在 Windows 上默认启用
/DELAYLOAD，但插件机制不支持延迟加载，务必在构建插件时加-ldflags="-linkmode=external -extldflags='-Wl,--no-delayload'
插件函数调用后 panic: “invalid memory address or nil pointer dereference”
这通常发生在你通过 plugin.Symbol 获取函数后，没检查返回的 err 就直接调用——而 Symbol 查找失败时返回的是 nil 函数值，不是 error。
立即学习“go语言免费学习笔记（深入）”；
-
plugin.Symbol成功时返回interface{}，失败时返回nil, error；但如果你写成sym, _ := plug.Lookup("Foo")，就丢掉了 error，然后sym.(func())()会 panic - 导出函数必须是首字母大写的包级函数（如
func DoWork() {}），不能是方法、闭包、未导出函数 - 函数签名必须完全一致：参数类型、返回值个数与类型（包括命名返回）、是否带
error都要对齐，Go 不做自动转换 - 插件中不要传递含指针或 map/slice 的结构体跨边界，它们的底层数据可能被 GC 回收或地址失效；建议只传基本类型、字符串或 C 兼容结构体（
unsafe.Sizeof可计算）
插件系统本质是把编译期耦合挪到运行期，版本、链接、符号、内存模型四个层面只要一个没对齐，就当场崩溃。没有“差不多能跑”的中间状态。
