33 lines
709 B
Markdown
33 lines
709 B
Markdown
---
|
||
paths:
|
||
- "**/*.go"
|
||
- "**/go.mod"
|
||
- "**/go.sum"
|
||
---
|
||
# Go 程式碼風格 (Coding Style)
|
||
|
||
> 本檔案擴展了 [common/coding-style.md](../common/coding-style.md)，包含 Go 特定內容。
|
||
|
||
## 格式化 (Formatting)
|
||
|
||
- **gofmt** 與 **goimports** 是強制性的 — 不存在風格爭論。
|
||
|
||
## 設計原則 (Design Principles)
|
||
|
||
- 接收介面 (Accept interfaces)，返回結構體 (Return structs)。
|
||
- 保持介面精簡 (1-3 個方法)。
|
||
|
||
## 錯誤處理 (Error Handling)
|
||
|
||
始終為錯誤包裹上下文：
|
||
|
||
```go
|
||
if err != nil {
|
||
return fmt.Errorf("failed to create user: %w", err)
|
||
}
|
||
```
|
||
|
||
## 參考資源
|
||
|
||
參見技能 (Skill)：`golang-patterns`，獲取全面的 Go 慣用法與模式。
|