go插件系统需用plugin包加载so文件并约定接口，reflect仅用于调用已导出的工厂函数和方法；纯反射注册可行但无热加载能力，核心在于类型、错误、生命周期等契约对齐。
如何用 reflect 注册并调用插件函数
Go 的反射本身不支持动态加载未编译进主程序的代码，所谓“插件系统”必须依赖 plugin 包（仅 Linux/macOS 支持）或显式接口约定 + 反射驱动的注册表。核心不是靠 reflect.Value.Call 魔法，而是靠提前约定好插件导出的函数签名，并用 reflect.TypeOf 校验类型一致性。
典型做法是定义统一插件接口（如 type Plugin interface { Init() error; Run(map[string]interface{}) error }），所有插件实现该接口；主程序通过 plugin.Open 加载 so 文件后，用 plug.Lookup("NewPlugin") 获取符号，再用 reflect.ValueOf(fn).Call(nil) 调用工厂函数得到实例——注意：这里 fn 必须是导出的、无参数、返回 Plugin 接口的函数，否则 Call 会 panic。
-
plugin.Open失败常见原因是 so 文件未用go build -buildmode=plugin构建，或 Go 版本与主程序不一致 - 插件中不能引用主程序包（包括
main），否则链接失败；所有共享类型需抽到独立模块（如pluginapi包） -
reflect.Value.Call传参必须是[]reflect.Value，空参也要传nil或[]reflect.Value{}，否则 panic
为什么不能直接用 reflect.Value.MethodByName 调用插件方法
因为 plugin.Lookup 返回的是 plugin.Symbol，本质是 interface{}，它底层可能是指针或值类型；而 reflect.Value.MethodByName 要求接收者是可寻址的（即必须是指针），否则报 panic: reflect: call of MethodByName on zero Value 或 unaddressable value。
正确路径是：先用 reflect.ValueOf(symbol).Call(nil) 得到插件实例（通常为指针），再对其调用 MethodByName；或者更稳妥地，直接在插件里暴露方法函数（如 func (p *MyPlugin) Run(args map[string]interface{}) error），主程序用 reflect.ValueOf(pluginInst).MethodByName("Run").Call(...)，但务必确保 pluginInst 是指针类型。
- 若插件返回的是值而非指针（比如
func NewPlugin() Plugin { return MyPlugin{} }），reflect.ValueOf后调用方法会失败——必须返回&MyPlugin{} -
MethodByName对大小写敏感，且只查找导出方法（首字母大写），run不会被找到 - 参数类型必须严格匹配：传
map[string]interface{}，不能传map[string]string，否则Callpanic
plugin 模式下如何安全传递结构体和错误
插件与主程序之间无法共享 struct 定义内存布局，除非它们来自同一编译单元。因此，任何跨 plugin 边界的结构体都必须定义在独立的、双方共用的包中（如 github.com/yourorg/pluginapi），且该包不能 import 主程序或插件私有包。
错误处理也受限：插件内 return errors.New("xxx") 返回的是插件内部的 errors.errorString 类型，主程序用 errors.Is 或 errors.As 判断会失败。推荐方案是插件统一返回预定义错误码（如 int）+ 错误消息（string），主程序根据码映射为本地错误；或让插件实现 Error() string 方法，主程序只消费字符串。
- 共用包必须用
go install安装到 GOPATH 或 go.mod 中，否则插件构建时找不到依赖 - 插件中不能使用
fmt.Printf等标准库 I/O，因 stdout/stderr 可能被重定向或不可见；日志应走回调函数或 channel 传回主程序 - 插件中启动 goroutine 后未清理，会导致主程序退出时资源泄漏（plugin 不支持卸载）
替代方案：不用 plugin，纯反射注册是否可行
可行，但只是“伪插件”——所有插件代码仍编译进主二进制，通过字符串名注册到全局 map，运行时用 reflect.ValueOf(registry[name]).Call(...) 调用。这规避了 plugin 的平台限制和 ABI 风险，但失去热加载能力。
关键点在于注册时机：必须在 main() 之前完成（如用 init() 函数），否则 registry 还是空的。同时要避免循环 import：插件包不能 import 主程序，只能由主程序 import 插件包并显式调用其注册函数。
- 注册函数签名建议统一为
func Register() { registry["xxx"] = myPlugin }，主程序遍历所有插件包的Register函数 - 若插件依赖配置初始化，不要在
init()里做，而应在Run()中首次调用时 lazy 初始化 - 这种模式下，反射仅用于调用已知函数，无需
plugin，也不受 CGO 影响，适合 CLI 工具或服务端静态扩展
真正难的不是反射调用那一行代码，而是插件与主程序之间的契约边界——类型定义、错误语义、生命周期、日志流向，这些没对齐，reflect.Value.Call 再多也救不回来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
