go插件机制在windows上完全不可用，因官方通过//+build !windows硬性排除；linux/macos需严格满足go版本、goos/goarch、cgo_enabled一致，且插件须用-buildmode=plugin构建、符号首字母大写导出，推荐改用子进程+grpc隔离方案。
插件目录结构必须与 Go module 路径一致
GoLand 本身不原生支持“插件热加载”概念，它只识别标准 Go 工作区结构。如果你的项目设计为通过 plugin.Open() 加载动态插件（即编译为 .so 文件），那么插件源码目录必须是独立的 Go module，且其 go.mod 中的 module path 必须与你在主程序中调用 plugin.Open("path/to/plugin.so") 时预期的导入路径完全匹配——否则 plugin.Open 会报 "plugin was built with a different version of package xxx"。
- 插件目录不能放在主项目的
internal/或cmd/下，否则会被主 module 隐式包含，导致构建冲突 - 推荐结构：
./plugins/http-handler/go.mod（module 名为example.com/myapp/plugins/http-handler），主程序里用plugin.Open("./plugins/http-handler/http-handler.so") - GoLand 默认不会索引插件目录，需右键该目录 → “Mark Directory as” → “Sources Root”，否则无法跳转、补全
构建插件时必须禁用 CGO 和指定 -buildmode=plugin
GoLand 的默认 Run Configuration 会忽略 -buildmode=plugin，直接运行会导致 panic：“cannot execute binary file”；而如果启用了 CGO（比如用了 cgo 导入 C 函数），则 plugin.Open 会拒绝加载，报错 "plugin not built with plugins enabled" 或 "symbol not found"。
- 在 GoLand 中，右键插件目录 → “Run As” → “Go Build”，然后点击齿轮图标编辑配置
- “Go tool arguments” 填写：
-buildmode=plugin -ldflags="-s -w" -o ./http-handler.so - 勾选 “CGO_ENABLED=0”（Environment variables 栏），除非你明确需要 C 交互且已确保所有依赖也用相同 CGO 设置构建
- 注意：macOS 上插件后缀是
.dylib，Linux 是.so，Windows 是.dll—— GoLand 不自动切换，得手动改输出名和路径
主程序调用 plugin.Lookup 时符号名必须导出且大小写敏感
Go 的插件机制只暴露首字母大写的导出符号。plugin.Lookup("HandleRequest") 找不到 handleRequest()，也不会提示拼写错误，而是返回 nil, error，容易误判为文件路径问题。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 插件中必须定义：
var HandleRequest func(http.ResponseWriter, *http.Request)（变量）或func HandleRequest(...)（函数），且首字母大写 - 类型签名必须严格一致：主程序里
fn.(func(http.ResponseWriter, *http.Request))类型断言失败，是因为插件里定义的是func(http.ResponseWriter, *http.Request) error—— 少个error就 panic - 建议在插件入口加
func init() { fmt.Println("plugin loaded") }，便于确认是否被成功Open，而非卡在Lookup
GoLand 调试插件时无法单步进入符号代码
GoLand 的调试器不支持跨 .so 边界单步执行插件内部逻辑，plugin.Open 后设置的断点在插件函数里不会命中，只会停在 fn.Call(...) 这一行。
- 唯一可行方案：把插件代码以普通包方式临时 import 到主程序（删掉
plugin.Open相关逻辑），调试通过后再切回插件构建流程 - 插件构建命令建议保存为 GoLand 的 “External Tool”：Program =
go，Arguments =build -buildmode=plugin -o $ProjectFileDir$/plugins/http-handler/http-handler.so $ProjectFileDir$/plugins/http-handler - 别依赖 GoLand 自动生成的
go run命令去测试插件——它根本跑不起来，go run不支持-buildmode=plugin
插件机制本身脆弱，路径、模块名、CGO、符号导出、类型签名、平台后缀，五处任一不匹配都会静默失败或 panic。与其花时间调 GoLand 的插件支持，不如先确保 go build -buildmode=plugin 命令行能稳定产出可加载的 so 文件，再把它拖进 IDE 环境里。
