不推荐使用 plugin 包实现 API 版本路由，因其在 macOS/Windows 上不可用、Go 1.16+ 已弃用，且极易因版本、CGO 或构建参数不一致导致加载失败；正确做法是启动时预编译各版本 handler 并注册到 map，通过中间件提取版本标识后查表分发，或对强隔离需求采用子进程 + JSON 协议方式。
别用 plugin 包做 API 版本插件路由——它在 macOS/Windows 上直接不可用，Go 1.16+ 已弃用，且版本、构建参数、CGO 设置稍有不一致就会报 "plugin was built with a different version of package xxx"，根本跑不起来。
API 版本路由本质是配置驱动的接口分发，不是二进制热插拔
所谓“v1/v2 API 加载不同插件”，95% 的场景只需要：读取请求路径或 header 中的版本标识 → 查表选实现 → 调用对应逻辑。不需要运行时加载 .so，更不需要跨进程通信。
- 主程序启动时预编译所有版本插件（如
v1.PaymentHandler、v2.PaymentHandler），全部注册进一个 map：handlers["v1"] = &v1.PaymentHandler{}、handlers["v2"] = &v2.PaymentHandler{} - HTTP 中间件提取版本号（例如从
X-API-Versionheader 或/v2/pay路径前缀），再查 map 获取 handler 实例 - 每个 handler 实现统一接口：
type Handler interface { ServeHTTP(http.ResponseWriter, *http.Request) }，避免类型耦合 - 新增 v3 只需写新 struct + 注册，不改主程序二进制，也不动路由分发逻辑
真要隔离运行时？用子进程 + JSON 协议，而非 plugin.Open
只有当某个 API 版本必须用不同语言实现（比如 v2 改用 Rust 编写）、或要求崩溃不拖垮主服务时，才考虑进程级隔离。这时 plugin 不仅没用，反而会锁死技术栈。
- 为每个版本准备独立可执行文件：
payment-v1、payment-v2，静态链接，无外部依赖 - 主程序用
exec.Command启动对应版本进程，通过 stdin/stdout 传 JSON：{"method":"charge","amount":100,"currency":"USD"} - 必须设置超时：
cmd.WaitDelay = 3 * time.Second，否则子进程卡死会导致整个 API 请求 hang 住 - 版本路由逻辑仍在主程序：收到
/v2/charge→ 启payment-v2→ 等响应 → 转发回 client
千万别踩的 ABI 兼容陷阱
如果你仍尝试用 plugin.Open 加载不同版本插件，以下任一条件不满足，加载必失败：
立即学习“go语言免费学习笔记（深入）”；
- 主程序和所有插件必须用**完全相同的 Go 小版本**（如都是
go1.22.3），go version输出必须逐字一致 - 编译时都必须设
CGO_ENABLED=0，且不能加-ldflags="-s -w"（会 strip 插件必需的类型元数据） -
plugin.Open()参数必须是**绝对路径**，相对路径在容器或 systemd 下极易失效 - 插件里不能引用主程序的包路径（如
import "myapp/config"），否则类型系统断裂，interface{}断言直接 panic
最易被忽略的一点：API 版本切换常伴随数据结构变更（如 v2 增加字段），但插件和主程序之间没有共享内存，JSON 序列化/反序列化才是安全边界；别试图在插件里直接操作主程序传入的 struct 指针——它们在两个地址空间里，压根不是同一个类型。
