Go言語での変数名の付け方ガイド！わかりやすくミスを減らす命名規則とは

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

生徒

「Go言語でプログラミングを始めたいんですけど、変数の名前ってどうやって決めたらいいですか？」

先生

「いいですね！プログラミングでは変数名を適切につけることがとても大切なんです。わかりやすい名前をつけると、ミスも減って読みやすいコードになりますよ。」

生徒

「でも、何を基準に決めればいいのか、よくわかりません……」

先生

「それでは、Go言語での変数名の付け方について、基本から丁寧に解説していきましょう！」

1. そもそも変数って何？

変数とは、データを一時的に保存しておく「入れ物」のようなものです。例えば、リンゴを入れるかごに「apple」と名前をつければ、そのかごの中身を見たときに「あ、これはリンゴだな」とすぐにわかりますよね。

プログラミングでも同じように、データにわかりやすい名前をつけておくことで、後から見ても何のためのデータなのかがすぐに理解できるようになります。

2. Go言語での変数の宣言方法

Go言語では、変数を宣言するときにvarというキーワードを使います。基本の形はこちらです。


var 名前 型 = 値

例えば、整数型の「年齢」を表す変数は次のように書けます。


var age int = 25

このageが「変数名」です。英語で「年齢」を意味する単語を使っているので、とてもわかりやすいですよね。

3. わかりやすい変数名の付け方のコツ

変数名は、何のデータを扱っているかが一目でわかるようにするのがポイントです。以下のルールを意識しましょう。

意味のある英単語を使う（例：name, price, isValid）
短すぎず長すぎない（xやdata123のような名前は避ける）
英単語をつなぐときはキャメルケースにする（例：userName, totalPrice）

キャメルケースとは、複数の単語をつなげるときに、2単語目以降の頭文字を大文字にする書き方です。

4. Go言語の命名規則と注意点

Go言語には、次のような命名ルールがあります。

アルファベット、数字、アンダースコアが使える（ただし、先頭は数字にできません）
大文字で始めると外部公開（エクスポート）される
小文字で始めるとそのパッケージ内だけで使える

たとえば、次のように書くと、他のパッケージからも使える変数になります。


var UserName string = "Taro"

逆に、小文字で始めるとそのファイル内だけの変数になります。


var userName string = "Hanako"

5. よくあるミスと避けたい変数名

初心者にありがちなミスを紹介します。

意味のない名前（例：aaa, temp1）
長すぎて読みにくい（例：thisIsTheNameOfTheUserWhoIsLoggedIn）
省略しすぎ（例：u、何のデータか分かりません）

また、Go言語ではintやstringのような予約語（あらかじめ言語で決められている単語）を変数名に使うことはできません。

6. 変数名に使えるおすすめの単語一覧

Go言語で使いやすい変数名の単語をいくつか紹介します。英語が苦手な方でも、意味を覚えておくと便利です。

count：数えるときに使う
index：順番や位置を表す
name：名前を表す
flag：条件の有無を示す（true/false）
isValid：有効かどうかの判定

これらの単語を使うと、他の人が見てもすぐに意味がわかるコードになります。

7. 実際に変数を使ってみよう！

それでは、Go言語で実際に変数を使ってみる簡単なサンプルを見てみましょう。


package main

import "fmt"

func main() {
    var userName string = "Taro"
    var age int = 20
    var isStudent bool = true

    fmt.Println("名前：", userName)
    fmt.Println("年齢：", age)
    fmt.Println("学生ですか？", isStudent)
}

このコードを実行すると、次のような結果になります。


名前： Taro
年齢： 20
学生ですか？ true

まとめ

Go言語での変数名の付け方について、記事全体を通して学んだ内容を振り返ると、初心者がつまずきやすい「命名の基準」をしっかり理解することが、読みやすくて扱いやすいプログラムを書くための大きな第一歩になることがわかります。変数名は単なる“名前”ではなく、そのデータが何を意味しているのか、どんな目的で使われているのかを示す重要な手がかりになります。今回紹介したような、意味のある英単語を使うことや、キャメルケースで単語を組み合わせる方法は、Go言語に限らず多くのプログラミング言語で使われる基本的な考え方で、文章を読むように自然なコードを書くための基礎となります。また、Go言語では大文字で始めると外部公開、小文字で始めるとパッケージ内限定というように、変数名の先頭の書き方に明確な意味があるため、プログラムの設計を意識するうえでもとても役に立つ知識です。

さらに、避けたい変数名の例として挙げたような、短すぎる単語や意味のない文字列は、最初のうちはつい使ってしまいがちですが、後の読みづらさやトラブルの原因になります。逆に、長すぎて覚えにくい変数名もストレスにつながるため、適度な長さ・自然な単語選びが求められます。初心者のうちからこの感覚を身につけておくことで、後でチーム開発に参加したり、複雑なアプリケーションを作ったりするときにも、スムーズにコードを整理しながら進められるようになります。Go言語のシンプルな構文は、こうした命名規則と非常に相性がよいため、学習を進めるほど自然に読みやすいコードを書く力が育っていきます。

また、実際にサンプルコードを動かしてみることで、変数がどのように値を保存し、どのように表示されるかといった具体的な動作を体験できたはずです。特に、string、int、boolのような基本的な型と、fmt.Printlnを使った出力は、Go言語の基礎的な書き方として欠かせない要素です。これらが理解できれば、今後の「条件分岐」「繰り返し」「構造体」などの学習にもスムーズにつながります。変数名の付け方は、今後扱うすべてのコードに関わってくるため、この段階でしっかり身につけておくと大きな強みになります。

サンプルプログラムでもう一度おさらいしよう

ここで、変数名の付け方を意識した簡単なサンプルプログラムを紹介します。今回学んだ命名規則を踏まえて、より分かりやすい変数名を使ったコードにしてみました。


package main

import "fmt"

func main() {
    var userName string = "Hanako"
    var totalScore int = 92
    var isPassed bool = true

    fmt.Println("利用者名：", userName)
    fmt.Println("合計得点：", totalScore)
    fmt.Println("合格しましたか？：", isPassed)
}

このように、変数名に明確な意味を持たせることで、コードの内容が自然と理解しやすくなります。プログラミングは積み重ねが大切なので、自分のコードをより読みやすくする工夫を続けていくことで、実力は着実に伸びていきます。

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

生徒

「変数名って、ただ好きな名前を付ければいいと思っていましたが、意味を考えてつけることで読みやすさが全然違うんですね！」

先生

「その通りです。変数名はプログラムの“言葉”のようなものなので、自然な名前を付けることでコードの理解がとてもスムーズになりますよ。」

生徒

「あと、大文字で始めるか小文字で始めるかで意味が変わるのも驚きました。パッケージ間で使うときに重要なんですね。」

先生

「ええ、設計を意識するときにとても役立つ考え方です。変数名の付け方ひとつで、プログラム全体が整理されて見えるようになります。」

生徒

「これからも意味のある英単語を意識して、読みやすいコードを心がけます！」