plugin.Open 失败时怎么拿到具体原因
直接看 err 的类型和内容，别只打印字符串。Go 的 plugin.Open 错误通常是 *plugin.PluginError 或底层 *exec.Error，它们都实现了 Error()，但结构信息藏在字段里。
- 用
errors.As(err, &pe)尝试断言为*plugin.PluginError，它有Plugin和Err两个字段，后者才是真正的加载失败原因（比如符号找不到、ELF 格式不匹配） - 如果断言失败，再试
*exec.Error，常见于插件文件不存在、权限不足、或不是可执行/共享对象格式 - 别只写
log.Fatal(err)—— 这会丢掉原始错误链，建议用fmt.Printf("load plugin %q failed: %+v\n", path, err)，%+v能展开结构体字段
为什么 plugin.Open 在 macOS 上总报 “no suitable image found”
这是典型的动态链接兼容性问题，不是代码写错了。macOS 对插件（dylib）的签名、架构、rpath 要求比 Linux 严格得多。
- 确保插件编译时加了
-buildmode=plugin，且和主程序用**完全相同的 Go 版本 + GOOS/GOARCH**（比如都是GOOS=darwin GOARCH=arm64） - 检查插件是否被 Apple 公证（Gatekeeper），临时绕过可用
xattr -d com.apple.quarantine your_plugin.so - 用
otool -L your_plugin.so看依赖路径，如果含@rpath却没设运行时路径，plugin.Open会静默失败；解决方法是编译插件时加-ldflags="-rpath @loader_path"
Symbol 查找失败：Lookup 返回 nil 但没报错
plug.Lookup 不返回 error，只返回 symbol, ok —— 这是故意设计，因为“符号不存在”在插件场景下常是预期分支，不是异常。
- 永远检查
ok，别只看symbol是否为 nil；漏判会导致 panic（比如对 nil func 调用） - 导出的 symbol 必须是**首字母大写的包级变量或函数**，小写名不会被导出（即使加了
//export注释也没用） - 如果插件里用了 init 函数且触发 panic，
plugin.Open会成功，但后续Lookup可能静默失败（实际是插件内部已崩溃），这时需加日志到插件的 init 里辅助定位
plugin 包在 Windows 上根本不能用
Go 官方明确不支持 Windows 下的 plugin 包，调用 plugin.Open 会直接返回 "not implemented on windows" 错误。
立即学习“go语言免费学习笔记（深入）”；
- 这不是配置或编译问题，是 runtime 层面限制 —— Windows 的 DLL 加载模型和 Go 的反射/符号解析机制冲突
- 跨平台项目若需插件能力，Windows 必须换方案：用进程间通信（如 gRPC over localhost）、或改用 WASM（TinyGo + wazero）、或退回到静态注册表（把插件逻辑编译进主程序，靠配置开关启用）
- CI 中别用
// +build windows忽略测试 —— 应该显式if runtime.GOOS == "windows" { t.Skip("plugin not supported") }，避免误以为功能存在
插件机制本身就很薄，Go 没给它加太多容错层。真正难的不是写 Open 和 Lookup，而是把错误路径覆盖全：从文件系统权限、ABI 兼容性、符号可见性，到跨平台的硬性缺失——这些地方一漏，就是线上查不出的黑盒失败。
