go plugin仅支持linux和macos，windows因dll机制不兼容且go团队明确不支持；需用-buildmode=plugin编译、禁用main函数、确保版本与环境完全一致，并导出首字母大写的包级符号。
Go plugin 只支持 Linux 和 macOS，Windows 完全不支持
Go 的 plugin 包底层依赖系统动态链接器（dlopen / dlsym），而 Windows 的 DLL 加载机制与 ELF 共享库不兼容，Go 团队明确不计划支持。你在 Windows 上 import plugin 会编译失败，报错类似：build constraints exclude all Go files in .../plugin。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 开发期务必在目标部署环境（Linux/macOS）上构建和测试 plugin，别依赖 WSL 模拟——WSL1 不支持
plugin，WSL2 虽然能跑但 ABI 行为可能和真机有细微差异 - CI 流程中禁用 Windows 构建 job，避免浪费资源或产生误导性通过结果
- 如果必须跨平台，得换方案：比如用 gRPC 或 HTTP 启独立进程通信，而不是强求 plugin
main 包必须用 -buildmode=plugin 编译，且不能有 main 函数
plugin 源码不是普通 Go 程序，它本质是共享库（.so / .dylib），不能包含 main 函数，也不能被当作可执行文件编译。直接 go build 会报错：cannot build _/path/to/plugin as plugin: no main package（这个错误信息其实有误导性，真正原因是没指定 mode）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- plugin 源文件里删掉所有
func main()，只保留导出的变量或函数，比如var ExportedFunc = func() {} - 编译命令必须显式写：
go build -buildmode=plugin -o myplugin.so myplugin.go - 确保 plugin 文件和主程序用**完全相同的 Go 版本、相同 GOOS/GOARCH、且标准库版本一致**——否则
plugin.Open()会 panic：plugin was built with a different version of package xxx
plugin.Open() 失败的常见原因和调试方法
plugin.Open() 返回 error 很常见，但错误信息往往模糊，比如 plugin.Open("x.so"): plugin was built with a different version of package runtime/internal/sys，实际未必是版本问题，更可能是构建环境不一致。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先用
file myplugin.so确认是 ELF 共享库（Linux）或 Mach-O bundle（macOS），不是普通可执行文件 - 用
ldd myplugin.so（Linux）或otool -L myplugin.so（macOS）检查是否意外链接了非系统级动态库（比如某 cgo 依赖带了私有路径的 .so） - 主程序和 plugin 都禁用 cgo：
CGO_ENABLED=0 go build，能大幅降低 ABI 冲突概率；若必须用 cgo，请确保两边CGO_CFLAGS和CGO_LDFLAGS完全一致 - 加载后立刻调用
plug.Lookup("SymbolName")并检查 error——即使Open()成功，符号也可能因未导出（首字母小写）或类型不匹配而查不到
导出符号必须是包级变量或函数，且首字母大写
Go plugin 只能暴露包级标识符，结构体字段、局部变量、闭包、方法都不行。而且必须导出（首字母大写），否则 Lookup() 返回 nil, nil（注意：第二个返回值是 error，此时为 nil，容易误判成功）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 只导出简单类型：如
func()、func(int) string、*MyStruct、map[string]interface{}；避免导出含未导出字段的 struct，否则运行时 panic - 导出函数签名要和主程序预期严格一致——哪怕只是多一个
context.Context参数，Lookup()返回的Symbol在类型断言时就会 panic - 推荐用 interface 做契约：在 plugin 里定义
type Plugin interface { Do() error }，导出一个实现了它的变量，主程序按 interface 断言，比裸函数更安全
plugin 最难缠的不是语法，而是构建链路里那些看不见的隐式依赖：Go 版本、cgo 开关、C 编译器版本、甚至 GOPROXY 缓存的模块哈希。只要有一处不一致，就卡在 Open() 或 Lookup()，而且错误提示从不直说哪错了。
