Go の宣言と初期化

---

クイックリファレンス: var vs :=

コンテキスト	用途	例
トップレベル	var (常に)	var _s = F()
ローカル (値あり)	:=	s := "foo"
ローカル ゼロ値 (意図的)	var	var filtered []int
型が式と異なる	var と型指定	var _e error = F()

複雑な初期化パターンまたは複数戻り値の割り当てで var と := を選択する場合は references/SCOPE.md を読んでください。

---

関連する宣言をグループ化

関連する var、const、type を括弧で囲まれたブロックにグループ化します。 関連のない 宣言は別のブロックに分けます。

// Bad
const a = 1
const b = 2

// Good
const (
    a = 1
    b = 2
)

関数内では、関連のない場合でも隣接する変数をグループ化します:

var (
    caller  = c.name
    format  = "json"
    timeout = 5 * time.Second
)

---

定数と iota

列挙型は 1 から開始し、ゼロ値が無効/未設定を表すようにします:

const (
    Add Operation = iota + 1
    Subtract
    Multiply
)

デフォルトの動作が望ましい場合はゼロを使用します (例: LogToStdout)。

ビットマスクパターン、バイトサイズの定数、または String() メソッドで iota 列挙型を設計する際は references/IOTA.md を読んでください。

---

変数スコープ

エラーチェックのためにのみ結果が必要な場合は if-init を使用してスコープを制限します:

if err := os.WriteFile(name, data, 0644); err != nil {
    return err
}

ネストを深くする必要がある場合や if の外で結果が必要な場合はスコープを縮小しないでください。 そこでのみ使用される定数は関数内に移動してください。

トップレベルの宣言を操作する場合や、ローカル変数の var と := を選択する場合は references/SCOPE.md を読んでください。

---

構造体の初期化

• 常にフィールド名を使用 (go vet で強制)。例外: ≤3 フィールドのテストテーブル
• ゼロ値フィールドは省略 — Go にデフォルト値を設定させる
• ゼロ値構造体には var を使用: user := User{} ではなく var user User
• &T{} を new(T) より優先: sptr := &T{Name: "bar"}

多くのフィールドを持つ構造体を初期化する場合、構造体ポインタのスライスを構築する場合、または単一行と複数行形式を選択する場合は references/STRUCTS.md を読んでください。

---

複合リテラルのフォーマット

外部パッケージの型にはフィールド名を使用します。閉じ括弧の行頭インデントを開き行と一致させます。 スライス/マップリテラル内の繰り返される型名を省略します (gofmt -s)。

複雑な複合リテラル、cuddled ブレース、またはゼロ値フィールドの決定を扱う場合は references/INITIALIZATION.md を読んでください。

複雑な複合リテラルをフォーマットする場合は references/LITERALS.md を読んでください。

---

マップの初期化

シナリオ	用途	例
空、後で設定	make(map[K]V)	m := make(map[string]int)
nil 宣言	var	var m map[string]int
初期化時に固定エントリ	リテラル	m := map[string]int{"a": 1}

make() は空だが初期化されたものを nil と視覚的に区別します。 カウントが既知の場合はサイズヒントを使用します。

---

ロー文字列リテラル

バッククォート文字列を使用して手動エスケープ文字を回避します:

// Bad
wantError := "unknown name:\"test\""

// Good
wantError := `unknown name:"test"`

正規表現、SQL、JSON、および複数行テキストに最適です。

---

interface{} より any を優先

Go 1.18+: すべての新規コードで interface{} の代わりに any を使用します。

---

組み込み名のシャドーイングを回避

事前に宣言された識別子 (error、string、len、cap、append、 copy、new、make、close、delete、panic、recover、any、true、 false、nil、iota) を名前として使用しないでください。go vet で検出します。

// Bad — 組み込みをシャドーイング
var error string

// Good
var errorMessage string

:= が外側のスコープをシャドーイングする新しい変数を作成する場合の問題をデバッグする際は references/SHADOWING.md を読んでください。

---

関連スキル

• 命名規則: 変数名、定数名を選択する際、またはスコープ別の名前長を決定する際は go-naming を参照してください
• データ構造: new と make を選択する際、またはスライスとマップを初期化する際は go-data-structures を参照してください
• 制御フロースコープ: if-init、:= 再宣言、または変数シャドーイングの回避を使用する際は go-control-flow を参照してください
• 容量ヒント: サイズが既知のマップまたはスライスを事前割り当てする際は go-performance を参照してください