go plugin仅支持linux/macos，windows不支持；编译需用-buildmode=plugin且插件必须为main包、含空main函数、导出符号首字母大写；主程序与插件须同go版本、同构建参数，通过plugin.open加载后用lookup查找并类型断言调用。
plugin 包只在 Linux/macOS 上可用，Windows 不支持 —— 这是第一步就必须确认的事。如果你在 Windows 上开发，得切到 WSL 或换用其他插件机制（比如进程外可执行文件、HTTP 插件或框架内置钩子）。
怎么编译一个 .so 插件文件
Go 官方plugin 模式要求严格：必须用 -buildmode=plugin，且插件源码的 main 包里不能有 main() 函数，否则编译失败。
- 插件文件必须以
package main开头（不是自定义包名） - 所有要被主程序调用的符号（函数/变量）必须首字母大写（即导出）
- 不能 import 主程序中未链接的包（如
net/http在主程序没用过，插件里用了就可能 panic）
示例 math_plugin.go：
package main
<p>import "fmt"</p><p>var Version = "1.0.0"</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill3345" title="Golang Samber Do"><img
src="https://img.php.cn/upload/skill/000/000/081/178954034424640.jpg" alt="Golang Samber Do" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill3345" title="Golang Samber Do" class="overflowclass">Golang Samber Do</a>
<p class="overflowclass">使用 samber/do 在 Golang 中实现依赖注入 — 服务容器、生命周期管理、作用域、健康检查、优雅关闭和模块组织</p>
</div>
<a rel="nofollow" href="/xiazai/skill3345" title="Golang Samber Do" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><p>func Add(a, b int) int {
return a + b
}</p><p>func Multiply(a, b int) int {
return a * b
}</p><p>func main() {}
</p>
编译命令：
go build -buildmode=plugin -o math_plugin.so math_plugin.go
如何在主程序里安全加载和调用
plugin.Open 成功后，必须对每个 Lookup 结果做类型断言，失败会 panic；而且一旦插件被加载，就不能卸载或热重载（无内存释放接口）。
- 必须检查
err：plugin.Open失败常见于 ABI 不匹配（比如主程序和插件用不同 Go 版本编译） -
Lookup返回的是interface{}，需显式转成具体类型，例如func(int, int) int - 变量查找后，必须用指针接收（如
*string），否则取不到值
典型加载片段：
p, err := plugin.Open("math_plugin.so")
if err != nil {
panic(err)
}
addSym, err := p.Lookup("Add")
if err != nil {
panic(err)
}
addFunc := addSym.(func(int, int) int)
result := addFunc(3, 4) // 得到 7
为什么你的插件总在 Lookup 时 panic
最常踩的坑不是语法错，而是链接一致性断裂：- 主程序和插件用了不同 Go 版本（哪怕只是 1.21.5 vs 1.21.6，ABI 可能不兼容）
- 插件里用了主程序没 import 的标准库包（比如插件用了
encoding/json，但主程序完全没碰过它） - 符号名拼写错误或大小写不符（
Add≠add） - 插件文件权限不对（Linux 下
.so需要可读+可执行位）
调试建议：用 readelf -d math_plugin.so | grep NEEDED 看依赖项，和主程序 readelf -d main | grep NEEDED 对比是否多出未满足的 so。
真正难处理的从来不是“怎么写”，而是“怎么让两个独立编译单元在运行时安静地握手成功”——ABI、符号可见性、依赖图，三者缺一不可。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
