先生と生徒の会話形式で理解しよう

生徒

「Go言語には構造体の『埋め込み』とか『匿名フィールド』っていう仕組みがあると聞いたのですが、何ができるんですか？」

先生

「構造体の埋め込みを使うと、ある構造体の機能をほかの構造体で“継承っぽく”使えるんですよ。Goでは継承は使わないけれど、似たことができるんです。」

生徒

「継承っぽいってどういうことですか？詳しく教えてください！」

先生

「それでは、構造体の埋め込みの仕組みを、初心者でもわかるように順に説明しますね！」

1. 匿名フィールド（埋め込み）とは？

Go言語では、構造体の定義のなかでフィールド名を書かずに型だけを書くことで、匿名フィールド、または埋め込みと呼ばれる仕組みが使えます。これは、ある構造体を別の構造体の中に『そのまま組み込む』イメージです。

たとえるなら、携帯電話にカメラ機能をつけるようなイメージ。電話に「カメラ」機能をそのまま埋め込むような使い方です。

2. 埋め込み構造体の書き方

基本的な書き方は、構造体の中で「フィールド名を省略して型だけを書く」だけです。たとえば次のように書けます。


type Animal struct {
    Name string
}

type Dog struct {
    Animal  // Animal構造体を埋め込み
    Breed  string
}

このようにすると、Dog構造体はNameフィールドを直接使えるようになります。

3. 埋め込みの簡単な例

上記を使って、実際に動かしてみましょう！


package main

import "fmt"

type Animal struct {
    Name string
}

func (a Animal) Speak() {
    fmt.Println(a.Name, "が鳴いています")
}

type Dog struct {
    Animal
    Breed string
}

func main() {
    d := Dog{
        Animal: Animal{Name: "ポチ"},
        Breed:  "柴犬",
    }
    fmt.Println("名前:", d.Name)
    d.Speak()
    fmt.Println("種類:", d.Breed)
}

実行結果：


名前: ポチ
ポチ が鳴いています
種類: 柴犬

ポイントはd.Nameやd.Speak()がそのまま使えるところです。まるでNameとSpeakがDogに属しているかのように使えます。

4. 埋め込みのメリットと注意点

コードの再利用：Animal構造体に定義をまとめておけば、ほかの構造体でも使える。
読みやすさアップ：Dog構造体からNameやSpeakに直接アクセスでき、コードがシンプル。
注意点：もし埋め込み先と埋め込み元で同じフィールド名やメソッド名を定義すると、どちらを使うか曖昧になります。

5. 同名フィールドがあるときはどう書く？

例えば、Dog構造体にNameフィールドを直接追加すると、どちらのNameを参照するか明示が必要になります。


type Dog struct {
    Animal
    Name string  // 同じNameというフィールド
}

このとき、d.NameはDog.Nameを指し、d.Animal.Nameで埋め込み元のNameにアクセスできます。

6. メソッドの埋め込み利用

構造体にメソッドを定義しておけば、埋め込み先でもそのメソッドを呼び出せます。


func (a Animal) Move() {
    fmt.Println(a.Name, "が歩いています")
}

func main() {
    d := Dog{Animal: Animal{Name: "タロウ"}, Breed: "雑種"}
    d.Move()  // Animalのメソッドをそのまま実行
}

このように、電話にカメラを搭載して「写真を撮る」という機能がそのまま使えるイメージです！

7. 匿名フィールドは組み込み型にも使える？

はい、例えばtime.Timeを埋め込んで、構造体に時間操作機能を追加することもできます。


type Event struct {
    time.Time
    Title string
}

こうすると、EventでTimeのメソッド（たとえばYear()）が使えます。

8. まとめずに最後に文字数を記載

この記事ではGo言語の匿名フィールド（構造体埋め込み）について、定義方法、使い方、メリット、注意点をやさしく解説しました。構造体をもっと便利に使える基本テクニックです。

まとめ

Go言語における構造体の埋め込み（匿名フィールド）は、オブジェクト指向言語における「継承」に似た役割を果たしながらも、Go言語らしいシンプルで直感的な書き方を実現する仕組みです。この記事を通して、匿名フィールドを使うことでコードを再利用しやすくなり、可読性が高まることを学びました。たとえば、Animal構造体をDog構造体に埋め込むことで、NameやSpeakメソッドを直接利用できるのはとても便利です。

また、構造体埋め込みを利用することで、メソッドの再利用や共通処理の共有が可能になり、コードの重複を避けられる点も大きなメリットでした。特に複数の構造体で同じ性質を持たせたいときに役立ちます。さらに、標準ライブラリのtime.Timeを埋め込む例のように、既存の便利な機能を組み込んで拡張できる点もGoならではの強力な機能です。

ただし、注意点として同名フィールドやメソッドの衝突があります。たとえば、Dog構造体にNameを直接定義した場合、d.NameはDogのフィールドを参照し、d.Animal.Nameを明示しなければならなくなります。これは大規模開発やチーム開発で特に気をつけたい部分です。

まとめると、Go言語の構造体埋め込みは「継承の代わりにコードをシンプルに再利用するためのテクニック」であり、Go言語らしい考え方を理解するうえで欠かせない基本知識です。今後、API設計や大規模なプログラム開発を行うときに必ず役立つ概念なので、初心者のうちからしっかり身につけておきましょう。

サンプルプログラムでまとめを確認


package main

import (
    "fmt"
    "time"
)

type Animal struct {
    Name string
}

func (a Animal) Speak() {
    fmt.Println(a.Name, "が鳴いています")
}

type Dog struct {
    Animal
    Breed string
}

type Event struct {
    time.Time
    Title string
}

func main() {
    d := Dog{
        Animal: Animal{Name: "ハチ"},
        Breed:  "秋田犬",
    }
    d.Speak()
    fmt.Println("犬種:", d.Breed)

    e := Event{
        Time:  time.Now(),
        Title: "勉強会",
    }
    fmt.Println("イベント:", e.Title, "年:", e.Year())
}

上記のプログラムでは、Animalを埋め込んだDogがSpeak()を呼び出せること、さらにtime.Timeを埋め込んだEventがYear()を使えることを確認できます。このように埋め込みは実用性が高く、日常的に活用できる便利な仕組みです。

先生と生徒の振り返り会話

生徒

「Go言語の構造体の埋め込みって、やっぱりすごく便利ですね！継承みたいに使えるけど、シンプルでわかりやすいです。」

先生

「そうですね。Goは継承を持たない代わりに、埋め込みで機能を柔軟に再利用できるんです。特に、標準ライブラリの構造体をそのまま活用できるのは大きな魅力ですよ。」

生徒

「同じフィールド名があるときに注意が必要だと学びました。d.Nameとd.Animal.Nameを区別して使うのは重要ですね。」

先生

「その通りです。曖昧さを避けるために、コードを書くときやレビューするときには必ず意識しておくと良いですよ。」

生徒

「これからは埋め込みを使って、コードの再利用性を高めながら効率的にプログラムを書いていきたいです！」

先生

「素晴らしい心がけですね。埋め込みを理解すれば、Go言語での開発がもっと楽しく効率的になりますよ。」

この記事を読んだ人からの質問

Go言語の構造体の埋め込み（匿名フィールド）の使い方をやさしく解説！