Go | 套件介面實現插件系統
💬 簡介
在大型應用中，功能模組常常需要動態擴展、靈活替換。
Go 雖不具備傳統意義上的動態載入機制，但透過「套件 + 介面」設計，可以實現類似插件系統的效果。
本篇將帶你打造一個簡單的「可插拔插件系統」，讓功能像積木一樣自由組合。
圖片來源：Gophers
🧠 插件系統設計概念
在 Go 中可透過以下方式設計插件系統：
- 📦 每個插件是一個獨立套件
- 🧩 插件套件實作統一介面
- 🏗 主程式依賴介面而非實作
- 🗂 插件註冊機制統一管理插件列表
1
2
3
4
5
6
7
8
| /project
|- main.go
|- plugin/
|- plugin.go // 定義 Plugin 介面與管理邏輯
|- hello/
|- hello.go // Hello 插件
|- time/
|- time.go // Time 插件
|
🏗 Plugin 介面與註冊機制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
package plugin
import "fmt"
type Plugin interface {
Name() string
Execute() string
}
var registry = make(map[string]Plugin)
func Register(p Plugin) {
if _, exists := registry[p.Name()]; exists {
panic(fmt.Sprintf("Plugin %s already registered", p.Name()))
}
registry[p.Name()] = p
}
func Get(name string) Plugin {
return registry[name]
}
func List() []string {
names := make([]string, 0, len(registry))
for k := range registry {
names = append(names, k)
}
return names
}
|
📝 使用 Register() 註冊插件、Get() 取得實體、List() 可列出所有註冊插件。
🛠 實作插件套件：Hello 插件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
package hello
import (
"example/plugin"
)
type HelloPlugin struct{}
func (h HelloPlugin) Name() string {
return "hello"
}
func (h HelloPlugin) Execute() string {
return "Hello from plugin!"
}
func init() {
plugin.Register(HelloPlugin{})
}
|
📝 每個插件皆可在 init() 自動註冊自己進入系統。
🛠 實作插件套件：Time 插件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
package timeplugin
import (
"time"
"example/plugin"
)
type TimePlugin struct{}
func (t TimePlugin) Name() string {
return "time"
}
func (t TimePlugin) Execute() string {
return time.Now().Format(time.RFC1123)
}
func init() {
plugin.Register(TimePlugin{})
}
|
📝 Time 插件回傳目前時間，模擬不同功能實作。
🚀 主程式動態載入與執行插件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
package main
import (
"fmt"
_ "example/plugin/hello"
_ "example/plugin/time"
"example/plugin"
)
func main() {
fmt.Println("🔌 Registered Plugins:")
for _, name := range plugin.List() {
p := plugin.Get(name)
fmt.Printf("👉 [%s]: %s\n", name, p.Execute())
}
}
|
📝 透過空白引入 import _ 方式觸發插件註冊，主程式即能取得並執行所有插件。
📌 延伸應用與實務建議
| 技巧或概念 |
說明 |
| 使用 interface |
介面隔離實作，提升彈性與測試性 |
| 避免硬編 plugin 名 |
使用動態註冊或配置清單 |
| 加入 version/metadata |
提供插件資訊、版本控制 |
| 插件初始化錯誤處理 |
加入 fallback 或警告機制 |
與 go:embed 搭配 |
可進一步用檔案載入配置與插件資料 |
🎯 總結
透過 Go 的套件與介面設計，可以實作彈性高、可擴展的插件系統：
- ✅ 插件實作統一介面並自動註冊
- ✅ 主程式透過註冊表動態載入與執行
- ✅ 套件架構清楚、模組邊界分明
- ✅ 支援未來新功能快速擴充
這樣的設計特別適合報表系統、通知管道、第三方整合等情境。
最後建議回顧一下 Go | 菜鳥教學 目錄，了解其章節內容。
註：以上參考了
Go
