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

// plugin/plugin.go
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

// plugin/hello/hello.go
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

// plugin/time/time.go
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

// main.go
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 _ 方式觸發插件註冊，主程式即能取得並執行所有插件。​‌‌​​‌‌‌​‌‌​​‌​‌​‌‌‌​‌​​​‌‌‌​‌​​​‌‌​‌​​‌​‌‌​‌‌‌​​‌‌​​‌‌‌​​‌​‌‌​‌​‌‌‌​​‌‌​‌‌‌​‌​​​‌‌​​​​‌​‌‌‌​​‌​​‌‌‌​‌​​​‌‌​​‌​‌​‌‌​​‌​​​​‌​‌‌​‌​‌‌​​‌‌‌​‌‌​‌‌‌‌​​‌​‌‌​‌​​‌‌​​‌​​​‌‌​​​​​​‌‌​​‌​​​‌‌​‌​‌​​‌‌​​​​​​‌‌​‌‌​​​‌‌​​‌​​​‌‌​​‌‌​​‌​‌‌​‌​‌‌​​‌‌‌​‌‌​‌‌‌‌​​‌​‌‌​‌​​‌‌​​​‌​​‌‌​​‌​​​‌‌​​​‌

📌 延伸應用與實務建議

🎯 總結

透過 Go 的套件與介面設計，可以實作彈性高、可擴展的插件系統：

• ✅ 插件實作統一介面並自動註冊
• ✅ 主程式透過註冊表動態載入與執行
• ✅ 套件架構清楚、模組邊界分明
• ✅ 支援未來新功能快速擴充

這樣的設計特別適合報表系統、通知管道、第三方整合等情境。

最後建議回顧一下 Go | 菜鳥教學 目錄，了解其章節內容。​‌‌​​‌‌‌​‌‌​​‌​‌​‌‌‌​‌​​​‌‌‌​‌​​​‌‌​‌​​‌​‌‌​‌‌‌​​‌‌​​‌‌‌​​‌​‌‌​‌​‌‌‌​​‌‌​‌‌‌​‌​​​‌‌​​​​‌​‌‌‌​​‌​​‌‌‌​‌​​​‌‌​​‌​‌​‌‌​​‌​​​​‌​‌‌​‌​‌‌​​‌‌‌​‌‌​‌‌‌‌​​‌​‌‌​‌​​‌‌​​‌​​​‌‌​​​​​​‌‌​​‌​​​‌‌​‌​‌​​‌‌​​​​​​‌‌​‌‌​​​‌‌​​‌​​​‌‌​​‌‌​​‌​‌‌​‌​‌‌​​‌‌‌​‌‌​‌‌‌‌​​‌​‌‌​‌​​‌‌​​​‌​​‌‌​​‌​​​‌‌​​​‌

註：以上參考了
Go