Go言語の構造体にメソッドを定義する方法をやさしく解説

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

生徒

「Go言語で、あるデータに動きをつける方法ってありますか？例えば、人の情報に“挨拶する”みたいな動作を持たせたいんです。」

先生

「とても良い視点ですね。Go言語では“構造体”というデータのまとまりに、“メソッド”という形で動作（関数）を定義することができますよ。」

生徒

「なるほど！でも、その“メソッド”ってどうやって書くんですか？」

先生

「それでは、構造体とメソッドの基本的な使い方を一緒に学んでいきましょう！」

1. 構造体とは？

Go言語の構造体（struct）とは、複数の情報をひとまとめにして扱える自分専用のデータ型です。「名前」「年齢」「職業」など、関連するデータを1セットにできるので、バラバラの変数で管理するより圧倒的に分かりやすく整理できます。

イメージとしては、ノートに項目ごとに情報を書き込むようなものです。例えば、人の情報をひとまとめにしたい場合、次のように定義します。


type Person struct {
    Name string
    Age  int
}

Personという構造体には、名前を入れるName、年齢を入れるAgeの2つの項目（フィールド）が含まれています。これを使えば、1人分の情報をひとつの変数で表現でき、複数人のデータ管理もスムーズになります。

例えば次のように値を入れれば、1人の情報をまとめて扱えます。


p1 := Person{Name: "太郎", Age: 20}

このように構造体を使うと、プログラムの見通しが良くなり、ミスも減らせます。特に初心者でも理解しやすく、現場でも頻繁に使われるとても重要な仕組みです。

2. メソッドとは？関数との違いを知ろう

メソッドは、特定の構造体（データのまとまり）に結びつけて定義する「そのデータ専用の関数」です。関数との一番の違いは、レシーバ（receiver）と呼ばれる「どの構造体に属する動きなのか」を明示できる点にあります。関数は単独で呼び出しますが、メソッドは「変数.メソッド名」という形で、そのデータと一緒に呼び出します。

たとえば「人があいさつする」という動きは、Personという構造体にくっついているほうが読みやすく、コードの意味も伝わりやすくなります。下の短いサンプルで、関数とメソッドの書き方・呼び出し方の違いを見てみましょう。


package main

import "fmt"

type Person struct {
    Name string
}

// 関数：データ(構造体)を引数で受け取って処理する
func GreetFunc(p Person) {
    fmt.Println("こんにちは、私は", p.Name, "です。")
}

// メソッド：構造体に結びついた関数（レシーバで所属を明示）
func (p Person) Greet() {
    fmt.Println("こんにちは、私は", p.Name, "です。")
}

func main() {
    user := Person{Name: "太郎"}

    // 関数の呼び出し（データを渡す）
    GreetFunc(user)

    // メソッドの呼び出し（データに対する動きとして呼ぶ）
    user.Greet()
}

どちらも同じメッセージを表示しますが、呼び出し方が異なります。関数版は「処理したい対象を引数として渡す」のに対し、メソッド版は「対象となるデータに対して動きを呼び出す」書き方になります。これにより、「この動きはこのデータの責務」という関係がはっきりし、読み手が意図を追いやすくなります。実際の開発では、データに密接した処理はメソッドにまとめると、コードの見通しや再利用性が高まり、チーム開発でも理解しやすい構成になります。

3. メソッドの定義方法

メソッドは、funcのあとに置くレシーバ（receiver）で「どの構造体に属する処理か」を宣言してから、メソッド名・引数・戻り値を続けて書きます。レシーバは丸かっこで包み、左に変数名、右に型名を書きます（例：(p Person)）。この形にすることで「Personに結びついた処理」であることがひと目でわかり、コードの読みやすさと保守性がぐっと上がります。

まずは最小の例です。Personというデータに「あいさつする」という動きを生やします。レシーバは値レシーバを使い、読み取り専用の振る舞いを定義しています。


type Person struct {
    Name string
    Age  int
}

// Personに紐づくメソッド（レシーバ：p Person）
func (p Person) Greet() {
    fmt.Println("こんにちは、私の名前は", p.Name, "です。")
}

ここでのポイントは、(p Person)という宣言が「この関数はPersonのメソッドである」ことを示している点です。呼び出すときは、変数.Greet()のように「データに対して動作を呼ぶ」書き方になります（呼び出し例は後続セクションで登場します）。

次に、引数や戻り値を持つメソッドの書き方です。メッセージの形式を選べるよう、引数で指定して文字列を返す例を示します。定義の位置は通常の関数と同じで、パッケージ内であればどこに置いてもかまいません。


func (p Person) FormatGreet(prefix string) string {
    msg := prefix + "、私は" + p.Name + "です。"
    return msg
}

このように、レシーバを使うことで「どのデータに属するふるまいか」を明確にできます。メソッド名は目的が伝わる動詞や名詞を選ぶと読みやすく、構造体の責務も自然に整理されます。まずは小さな動きからメソッド化して、データと処理をセットで考える習慣を身につけていきましょう。

4. メソッドを使ってみよう！

構造体を作成してメソッドを呼び出すには、以下のように書きます。


package main

import "fmt"

type Person struct {
    Name string
    Age  int
}

// Person型にGreetというメソッドを定義
func (p Person) Greet() {
    fmt.Println("こんにちは、私の名前は", p.Name, "です。")
}

func main() {
    p1 := Person{Name: "太郎", Age: 20}
    p1.Greet() // メソッド呼び出し
}

実行結果：


こんにちは、私の名前は 太郎 です。

5. 値レシーバとポインタレシーバの違い

メソッドを定義する際、レシーバを値渡しにするか、ポインタ渡しにするかを選べます。

値レシーバは、構造体のコピーが渡されるので、元のデータは変更されません。一方、ポインタレシーバでは、元のデータを直接変更できます。


func (p *Person) Birthday() {
    p.Age += 1
}

このように*Personと書くことで、ポインタ（元のデータ）に対して操作できます。

6. ポインタレシーバの実例


package main

import "fmt"

type Person struct {
    Name string
    Age  int
}

func (p *Person) Birthday() {
    p.Age += 1
}

func main() {
    p1 := Person{Name: "花子", Age: 25}
    p1.Birthday()
    fmt.Println(p1.Name, "は", p1.Age, "歳になりました。")
}

実行結果：


花子 は 26 歳になりました。

ポイント：ポインタレシーバを使うと、構造体の内容を書き換えることができます。年齢のように「増やしたい」「変更したい」データにはポインタレシーバが便利です。

7. レシーバ名は自由に決めていいの？

レシーバの変数名は自由に決められますが、一般的には構造体名の頭文字の小文字を使うことが多いです。例えば、Personならpという名前にするのが慣例です。

ただし、意味がわかりやすければ他の名前でも問題ありません。

8. メソッドを使うとコードが読みやすくなる理由

構造体にメソッドを定義することで、「この動作はこのデータに関係している」とはっきり分かるようになります。

例えば、Greetという動作がPersonにあることで、「この人があいさつするんだな」と一目でわかります。プログラムが大きくなっても、整理されたコードになります。

まとめ

Go言語で構造体にメソッドを定義するという考え方は、一見むずかしいように感じますが、実際のプログラムで手を動かしてみると「データ」と「動作」がセットになることで理解が深まります。とくに、名前や年齢のような情報を持った構造体に挨拶の動作を追加する例は、はじめて学ぶ人にもイメージしやすく、実践的です。構造体はフィールドをまとめる箱のような役割を持ち、メソッドはその箱から取り出したデータに振る舞いを与えるという仕組みです。この「データ」と「動き」がつながっていることこそが、大規模なプログラムで役立つポイントになります。

さらに、値レシーバとポインタレシーバの違いは、Go言語ならではの特徴といえます。値レシーバでは元の値が変わらないため、安全に読み取りができ、ポインタレシーバでは直接書き換えができるため「年齢を増やす」「ポイントを加算する」など、更新を伴う処理で大活躍します。実際に動かして比べてみると、コードの見た目はほとんど同じなのに、挙動が大きく変わる点はとても興味深いところです。

また、レシーバ名の付け方も自由に決められますが、慣習として構造体名の頭文字を小文字にすることで読みやすさが保たれます。チームで開発する場合は、このような小さな決まりが積み重なることで読みやすいプログラムへとつながります。メソッドが増えても、型ごとに動きがまとまっていれば、あとからコードを読む人にも親切です。構造体とメソッドが組み合わさることで、Go言語のプログラムは「意味のあるかたまり」になり、自然に整理されたコードへ近づいていきます。

以下は、学んだ内容をまとめた最終サンプルです。構造体とメソッドを組み合わせ、挨拶と誕生日の処理をまとめて書くと、どのデータにどんな操作ができるのかが読み手に伝わりやすくなります。

サンプルプログラムまとめ


package main

import "fmt"

type Person struct {
    Name string
    Age  int
}

// あいさつするメソッド（値レシーバ）
func (p Person) Greet() {
    fmt.Println("こんにちは、私の名前は", p.Name, "です。")
}

// 年齢をひとつ増やすメソッド（ポインタレシーバ）
func (p *Person) Birthday() {
    p.Age += 1
}

func main() {
    p := Person{Name: "太郎", Age: 20}

    // あいさつ
    p.Greet()

    // 年齢を増やす
    p.Birthday()
    fmt.Println(p.Name, "は", p.Age, "歳になりました。")
}

このサンプルのように、「自分というデータが自分であいさつをする」「年齢をひとつ増やす」といった動作が、構造体の中に自然におさまります。もし値レシーバとポインタレシーバの違いがあいまいなままであれば、実際に値が変わるかどうかを画面に出力して確かめてみると理解が深まります。人の情報を表す構造体は、住所やメールアドレス、会員ランクなどを追加していけば、より豊かな例に発展させることができます。こうしてメソッドを活用していけば、Go言語のプログラムは「人間が読んで理解しやすいもの」へと育っていくのです。