Go開発ガイド（Modern Go Development）

🎯 使用タイミング

• Goプロジェクト新規作成時
• 既存Goコードのレビュー・改善時
• 並行処理の実装時
• エラーハンドリング設計時
• Goのテスト作成時

📚 ドキュメント構成

このスキルは以下のドキュメントで構成されています：

1. 命名規則

Goの命名ベストプラクティス：

• パッケージ名の付け方
• 変数・関数名の規則
• インターフェース命名（-erサフィックス）
• エクスポート名の考え方

2. エラーハンドリング

堅牢なエラー処理パターン：

• エラーは値として扱う
• エラーラッピング（%w vs %v）
• センチネルエラーとカスタムエラー型
• panic/recoverの適切な使用

3. 並行処理

Goの強力な並行処理パターン：

• goroutineの基本
• チャネルによる通信
• select文の活用
• 同期プリミティブ（sync.Mutex等）
• コンテキストによるキャンセル

4. テスト戦略

効果的なGoテストの書き方：

• テーブル駆動テスト
• t.Errorとt.Fatalの使い分け
• サブテスト（t.Run）
• ベンチマークテスト
• テストヘルパーの作成

5. プロジェクト構造

推奨ディレクトリレイアウト：

• cmd/とinternal/の使い分け
• pkg/の適切な使用
• go.modの管理
• モジュール設計

6. 開発ツール

Goエコシステムのツール活用：

• gofmt/goimports
• golangci-lint
• go vet
• delve（デバッガ）
• Makefileパターン

🎯 Goの設計哲学

シンプルさを重視

// Good: シンプルで明確
func ProcessItems(items []Item) error {
    for _, item := range items {
        if err := item.Process(); err != nil {
            return fmt.Errorf("process item %s: %w", item.ID, err)
        }
    }
    return nil
}

// Bad: 過度な抽象化
func ProcessItems(items []Item, processor ItemProcessor, validator ItemValidator) error {
    // 不必要な複雑さ
}

明示的であること

// Good: 明示的なエラーハンドリング
result, err := doSomething()
if err != nil {
    return err
}

// Bad: エラーを無視
result, _ := doSomething()

通信でメモリを共有

// Good: チャネルで通信
results := make(chan Result)
go func() {
    results <- process(data)
}()
result := <-results

// Avoid: 共有メモリでの通信（必要な場合のみ）
var mu sync.Mutex
var shared int

🚀 クイックスタート

1. プロジェクト初期化

# モジュール作成
mkdir my-project && cd my-project
go mod init github.com/username/my-project

# 基本構造
mkdir -p cmd/myapp internal/handler internal/service

2. 基本的なmain.go

package main

import (
    "context"
    "log"
    "os"
    "os/signal"
    "syscall"
)

func main() {
    ctx, cancel := signal.NotifyContext(context.Background(),
        os.Interrupt, syscall.SIGTERM)
    defer cancel()

    if err := run(ctx); err != nil {
        log.Fatal(err)
    }
}

func run(ctx context.Context) error {
    // アプリケーションロジック
    return nil
}

3. 開発コマンド

# フォーマット
gofmt -w .

# Lint
golangci-lint run

# テスト
go test ./...

# ビルド
go build -o bin/myapp ./cmd/myapp

💡 重要な原則

ゼロ値の活用

// Good: ゼロ値で有効な状態
type Counter struct {
    mu    sync.Mutex
    count int  // ゼロ値は0で有効
}

func (c *Counter) Inc() {
    c.mu.Lock()
    c.count++
    c.mu.Unlock()
}

// 初期化なしで使用可能
var c Counter
c.Inc()

インターフェースは小さく

// Good: 単一メソッドインターフェース
type Reader interface {
    Read(p []byte) (n int, err error)
}

type Writer interface {
    Write(p []byte) (n int, err error)
}

// 組み合わせで拡張
type ReadWriter interface {
    Reader
    Writer
}

早期リターン

// Good: ガード節で早期リターン
func process(item *Item) error {
    if item == nil {
        return errors.New("item is nil")
    }
    if item.ID == "" {
        return errors.New("item ID is empty")
    }

    // メインロジック
    return item.Save()
}

🔗 関連スキル

• applying-solid-principles: SOLID原則とクリーンコード
• testing: テストファーストアプローチ
• securing-code: セキュアコーディング
• writing-dockerfiles: Goアプリのコンテナ化

📖 参考リソース

• Effective Go
• Google Go Style Guide
• Go Code Review Comments

📖 次のステップ

1. 初めての方: プロジェクト構造から始めてください
2. 命名に迷ったら: 命名規則を参照
3. エラー処理: エラーハンドリングでパターン確認
4. 並行処理: 並行処理でgoroutine/channel学習
5. テスト作成: テスト戦略でテーブル駆動テスト
6. ツール設定: 開発ツールでlint設定