Go言語のnil structの挙動と注意点について解説

package main
import "fmt"
// User構造体はユーザー情報を保持するための構造体です。
type User struct {
    Name string // ユーザー名
    Age  int    // ユーザーの年齢
}
func main() {
    // User構造体のリテラル初期化を行います。
    user := User{
        Name: "Alice",
        Age:  30,
    }
    fmt.Println("User:", user)
}

User: {Alice 30}

package main
import "fmt"
type Profile struct {
    Email string // メールアドレス
}
func main() {
    // ポインタ変数は初期化されないためnilとなります。
    var ptrProfile *Profile
    fmt.Println("ptrProfile:", ptrProfile) // <nil>が出力される
    // 構造体変数はゼロ値で初期化され、フィールドは型のゼロ値となります。
    var directProfile Profile
    fmt.Println("directProfile:", directProfile) // {""}が出力される
}

ptrProfile: <nil>
directProfile: { }

package main
import "fmt"
// User構造体はユーザー情報を保持するための構造体です。
type User struct {
    Name string // ユーザー名
}
func main() {
    var user *User // userはnilです。
    // 以下の行でnilの構造体のフィールドにアクセスしようとするためpanicが発生します。
    fmt.Println("User Name:", user.Name)
}

panic: runtime error: invalid memory address or nil pointer dereference
...

package main
import "fmt"
// Config構造体は設定情報を保持します。
type Config struct {
    Port int // サーバーのポート番号
}
func main() {
    var cfg *Config // cfgはnilです。
    if cfg == nil {
        fmt.Println("Config is nil. 初期化が必要です。")
    } else {
        fmt.Println("Config Port:", cfg.Port)
    }
}

Config is nil. 初期化が必要です。

package main
import "fmt"
// User構造体はユーザー情報を保持するための構造体です。
type User struct {
    Name string // ユーザー名
}
func main() {
    // リテラルでUser構造体を明示的に初期化します。
    user := &User{
        Name: "Taro", // 名前を初期化
    }
    fmt.Println("User Name:", user.Name)
}

User Name: Taro

package main
import "fmt"
// Config構造体は設定情報を保持します。
type Config struct {
    Port int // サーバーのポート番号
}
func main() {
    var cfg *Config // cfgはnilです。
    // nilチェックを実施してから処理を行います。
    if cfg == nil {
        fmt.Println("Config is nil. 正しい初期化が必要です。")
        return
    }
    fmt.Println("Config Port:", cfg.Port)
}

Config is nil. 正しい初期化が必要です。

package main
import (
    "testing"
)
// Service構造体は何らかのサービス情報を保持します。
type Service struct {
    Data string // サービスデータ
}
// Process関数はService構造体への依存処理を行います。
func Process(s *Service) string {
    if s == nil {
        return "Error: service is nil" // nilの場合はエラーメッセージを返す
    }
    return s.Data
}
func TestProcess(t *testing.T) {
    // nilのケース
    result := Process(nil)
    expected := "Error: service is nil"
    if result != expected {
        t.Errorf("expected %s but got %s", expected, result)
    }
    // 初期化済みの場合のケース
    serviceInstance := &Service{
        Data: "Success", // 正常な初期化
    }
    result = Process(serviceInstance)
    expected = "Success"
    if result != expected {
        t.Errorf("expected %s but got %s", expected, result)
    }
}

PASS
ok  	package/test	0.001s