writing-go

Go 開発（1.25+）

基本原則

• 標準ライブラリ優先：正当な理由がある場合に限り、外部依存関係を追加します
• 具体的な型：インターフェースは利用側で定義し、構造体を返します
• コンポジション：継承ではなく、常にコンポジションを使います
• 早期に失敗：コンテキストを含む明確なエラーを返します
• シンプルに：たいていの場合、最もわかりやすい解決策が正解です

クイックパターン

エラー処理

if err := doThing(); err != nil {
    return fmt.Errorf("do thing: %w", err)
}

オプション付き構造体

type Server struct {
    addr    string
    timeout time.Duration
}

func NewServer(addr string, opts ...Option) *Server {
    s := &Server{addr: addr, timeout: 30 * time.Second}
    for _, opt := range opts {
        opt(s)
    }
    return s
}

テーブル駆動テスト

tests := []struct {
    name    string
    input   string
    want    string
    wantErr bool
}{
    {"valid", "hello", "HELLO", false},
    {"empty", "", "", true},
}
for _, tt := range tests {
    t.Run(tt.name, func(t *testing.T) {
        got, err := Process(tt.input)
        if tt.wantErr {
            require.Error(t, err)
            return
        }
        require.NoError(t, err)
        assert.Equal(t, tt.want, got)
    })
}

Go 1.25 の機能

• testing/synctest：シミュレートされたクロックを使った決定論的な並行テスト
• encoding/json/v2：実験的機能。3～10 倍高速（GOEXPERIMENT=jsonv2）
• runtime/trace.FlightRecorder：本番環境のトレースをオンデマンドで取得
• コンテナ対応 GOMAXPROCS：cgroup の制限を自動検出
• GreenTea GC：実験的機能。レイテンシを低減（GOEXPERIMENT=greenteagc）

参考資料

• PATTERNS.md - 詳細なコードパターン
• TESTING.md - testify/mockery を使ったテスト戦略
• CLI.md - CLI アプリケーションのパターン

ツール

go build ./...           # Build
go test -race ./...      # Test with race detector
golangci-lint run        # Lint
mockery --all            # Generate mocks

---

注意点

• nil チャネルへの送受信は永遠にブロックされます。クローズ済みのチャネルから受信すると、ゼロ値がすぐに返ります — nil チャネルのケースを含む select は、そのケースを無効にします。便利なパターンですが、意図せずそうしてしまいやすいので注意してください。
• defer は実行時ではなく、呼び出し時に引数をキャプチャします — defer fmt.Println(time.Now()) は、遅延実行時ではなく、今の時刻をキャプチャします。
• Go 1.22 より前では、for ループ内のクロージャは、すべての反復で同じ変数をキャプチャします — これが、ループ内で goroutine を使うときのバグの原因です。Go 1.22 でセマンティクスが変更されました。以前の習慣が、複数のバージョンが混在するコードで微妙なバグを生むことがあります。
• errors.Is は Unwrap() のチェーンをたどりますが、ラップされたエラーが独自に Is(target error) bool を実装している場合は、チェーンをたどる代わりにそのカスタム Is が優先されます — xerrors から移行するときに混乱しやすい点です。
• sync.Pool のアイテムは、Get から次の Put までの間に GC で回収されることがあります — Pool が状態を保持することを前提にしてはいけません。