Pythonの変数宣言の方法とは？型ヒント（type hints）の使い方

1. Pythonの変数とは？宣言と代入の基本

1. Pythonの変数とは？宣言と代入の基本

プログラミングにおける変数（へんすう）とは、データに名前をつけて一時的に保存しておく「箱」や「ラベル」のようなものです。Pythonでは、他の言語のように「これから変数を使います」という難しい宣言は不要で、値を入れた瞬間に変数が作成されるという直感的な仕組みになっています。

まずは、最も基本的な書き方を見てみましょう。未経験の方でも、以下のコードで何が行われているかイメージできるはずです。

# 変数「name」に文字列を代入
name = "たろう"

# 変数「age」に数値を代入
age = 20

# 変数「is_student」に真偽値を代入
is_student = True

このコードにある「=」は、算数の「等しい」という意味ではなく、「右側のデータ（値）を、左側の名前（変数）に割り当てる」という代入の操作を意味します。この1行を書くだけで、Pythonは自動的にメモリ上に箱を用意し、名前をつけてデータを保管してくれます。

例えば、name = "たろう" と書けば、それ以降のプログラムの中で name と書くだけで「たろう」というデータを何度でも呼び出すことができます。もし値を書き換えたいときは、再度 name = "じろう" のように新しい値を代入するだけで中身を更新できるため、非常に柔軟です。

2. 変数に使える名前のルール（命名規則）

2. 変数に使える名前のルール（命名規則）

Pythonで変数名を付けるときは、自由に決めて良いわけではなく、いくつかの「守らなければならないルール」と「推奨されるマナー」があります。これを知らないと、プログラムがエラーで動かなかったり、自分でも内容が分からなくなったりします。

必ず守るべき3つの基本ルール

• 使用できる文字： 半角の英小文字・大文字、数字、アンダースコア（_）のみです。
• 数字から始めてはいけない： 1st_name のように数字を先頭に使うとエラーになります。name_1 ならOKです。
• 予約語は使えない： Pythonが特別な意味として予約している単語（if, for, while, True など）は変数名にできません。

初心者におすすめ！読みやすい名前の付け方

プログラムは「動くこと」と同じくらい「読みやすさ」が重要です。例えば、後でコードを見返したときに a = 100 と書いてあっても、それが「価格」なのか「年齢」なのか分かりませんよね。そのため、中身が想像できる具体的な英単語を使いましょう。

# 良い例：中身がわかる
item_price = 1200
user_age = 25

# 悪い例：中身がわからない
x = 1200
a = 25

# 2つの単語をつなぐときは「_（アンダースコア）」でつなぐ（スネークケース）
# 例：user_name, total_score, is_active

Pythonの世界では、user_name のように単語をアンダースコアで区切る「スネークケース」という書き方が一般的です。また、日本語（全角文字）を変数名に使うことも技術的には可能ですが、文字化けやトラブルの原因になるため、実務や学習では避けるのが鉄則です。

3. Pythonは「動的型付け言語」：型を気にせず書ける理由

3. Pythonは「動的型付け言語」：型を気にせず書ける理由

Pythonの大きな特徴の一つに、「動的型付け（どうてきかたづけ）」という仕組みがあります。これは、プログラミング初心者が挫折しにくい理由のトップに挙げられるほど便利な機能です。

他の言語（JavaやC++など）では、変数を作るときに「この箱は整数専用」「この箱は文字列専用」とあらかじめ厳しく決めなければなりません。しかし、Pythonは変数に代入された値を見て、コンピュータ側が自動的にデータの種類（型）を判別してくれます。

# 整数（int型）として自動判別される
price = 500

# 文字列（str型）として自動判別される
message = "期間限定セール"

# 同じ変数に別の種類のデータを入れてもOK（Pythonがその都度判断）
price = "売り切れ" 

上記の例のように、最初は数値を入れていた price という変数に、後から文字列を上書きすることも可能です。このように「型を意識しすぎず、直感的にコードが書ける」のが動的型付けの最大のメリットです。

ただし、自由度が高い反面、「計算するつもりだったのに、いつの間にか中身が文字に変わっていた」というミスが起きることもあります。そのリスクを減らすための便利なテクニックが、次から紹介する「型ヒント」です。

4. 型ヒント（type hints）とは？メリットと基本の書き方

4. 型ヒント（type hints）とは？メリットと基本の書き方

Python 3.5から導入された型ヒント（type hints）とは、変数や関数の引数に対して「この箱には何のデータ（数値や文字など）を入れる予定か」というメモを残しておく仕組みのことです。

前述の通り、Pythonは自動で型を判別してくれますが、プログラムが大規模になると「この変数、数字だっけ？文字だっけ？」と混乱しがちです。型ヒントを記述することで、自分だけでなく他の人がコードを見たときも、データの種類が一目で理解できるようになります。

型ヒントの基本：コロン「:」を使って型を指定する

書き方は非常に簡単で、変数名の後ろに「: 型名」を付け加えるだけです。未経験の方でも直感的に理解できるはずです。

# 名前は「文字列（str）」ですよ、というヒント
user_name: str = "たろう"

# 年齢は「整数（int）」ですよ、というヒント
user_age: int = 25

# 身長は「小数（float）」ですよ、というヒント
height: float = 172.5

ここで重要なポイントは、型ヒントは「あくまでヒント」であり、プログラムの実行を制限しないという点です。例えば int と書いた変数に誤って文字列を入れても、Pythonはエラーを出さずに動いてしまいます。

「じゃあ書かなくてもいいのでは？」と思うかもしれませんが、最近の開発現場では、VS Codeなどのエディタが型ヒントを読み取って入力ミスを自動で警告してくれたり、入力補完（予測変換）を正確に出してくれたりするため、バグを未然に防ぐための必須テクニックとなっています。

5. 実務で頻出！Pythonでよく使う基本の型ヒント一覧

5. 実務で頻出！Pythonでよく使う基本の型ヒント一覧

Pythonの型ヒントには多くの種類がありますが、初心者がまずマスターすべきは以下の「基本の5つ」です。これらを使いこなすだけで、コードの読みやすさとデバッグの効率が格段にアップします。

未経験でも納得！具体的なコード例

実際にこれらの型ヒントを使って、身近なデータを表現してみましょう。変数名のあとに「: 型名」を添えるだけで、その変数が何者であるかを誰にでも伝えることができます。

# 商品の個数は「整数」
item_count: int = 5

# 消費税率は「小数」
tax_rate: float = 0.1

# 商品の名前は「文字列」
product_name: str = "リンゴ"

# 在庫があるかどうかは「真偽値」
is_in_stock: bool = True

# 関連する商品IDの「リスト」
related_ids: list = [101, 102, 103]

また、Python 3.9以降のモダンな書き方では、list[int]のように記述することで「中身が整数のリストである」といった、より詳細な指定（ジェネリクス）が可能です。これにより、後からリストの中身を取り出す際も、それが数値なのか文字なのか迷うことがなくなります。

このように型ヒントを添える習慣をつけると、数ヶ月後の自分やチームのメンバーがコードを読んだ際に「この変数にはどんなデータを入れればいいんだっけ？」と悩む時間をゼロにできるのです。

6. 関数でも使える型ヒント：引数と戻り値を明確にする

6. 関数でも使える型ヒント：引数と戻り値を明確にする

型ヒントの真価が最も発揮されるのが「関数（複数の処理をまとめたもの）」での活用です。関数の入り口である「引数」と、出口である「戻り値」に型を指定することで、その関数が何を必要とし、何を返してくれるのかがドキュメントを読まなくても一目で分かるようになります。

関数の型ヒントの書き方（アノテーション）

引数の後ろには「: 型名」を、戻り値の前には「-> 型名」を記述します。プログラミング未経験の方でも、以下の例を見れば「この関数は文字列を受け取って、文字列を返すんだな」と直感的に理解できるはずです。

# name（引数）は文字列、返ってくる結果（戻り値）も文字列
def greet(name: str) -> str:
    return "こんにちは、" + name + "さん！"

# 実行して結果を受け取る
message: str = greet("たろう")
print(message)

このように記述しておくと、例えば数値を扱う関数に誤って文字を渡してしまったり、戻り値を間違った型で処理しようとしたりした際に、エディタ（VS Codeなど）がすぐに警告を表示してくれます。特に複雑な計算を行う関数や、複数の人が関わる開発プロジェクトでは、この「型による自己説明」がバグを防ぐ強力な武器になります。

「型を書くのは少し手間」と感じるかもしれませんが、将来の自分がコードを読み返すときや、エラーで悩む時間を減らすための「未来への投資」だと考えて、積極的に取り入れていきましょう。

7. ListやDictを使う型ヒント

7. ListやDictを使う型ヒント

リストや辞書など複雑な型にヒントをつけたい場合、Python3.9以前ではtypingモジュールが必要です。

from typing import List, Dict

numbers: List[int] = [1, 2, 3]
profile: Dict[str, str] = {"名前": "たろう", "趣味": "ゲーム"}

Python3.9以降なら、次のように書けます：

numbers: list[int] = [1, 2, 3]
profile: dict[str, str] = {"名前": "たろう", "趣味": "ゲーム"}

8. Optional型とNoneの使い方

8. Optional型とNoneの使い方

「値があるかもしれないし、ないかもしれない」場合には、Optional型を使います。これは、None（値が存在しないこと）を許容するという意味です。

from typing import Optional

nickname: Optional[str] = None

また、関数が値を返さない場合は、戻り値の型をNoneにします。

def say_hello(name: str) -> None:
    print("こんにちは、" + name + "さん！")

まとめ

まとめ

Pythonにおける変数の宣言方法と、型ヒント（type hints）の使い方について学んできました。Pythonの変数宣言はとてもシンプルで、代入するだけで変数が作られます。この手軽さがPythonの魅力のひとつですが、同時に動的型付けという特徴によって、予期しない型の値が代入されるリスクもあります。そこで登場するのが型ヒント（type hints）です。

型ヒントを使えば、変数や関数のデータ型を明示でき、可読性や保守性が向上します。特に複数人で開発する場合や、大規模なプログラムになると、どんな型が使われているかを明示することでバグの予防や効率的なデバッグに役立ちます。

また、Python3.9以降では、リストや辞書の中のデータ型も明示できるようになり、より直感的でわかりやすくなっています。さらに、Optional型を使えば、値があるかもしれないし、ないかもしれないという場面に対応できるため、実践的な型の表現も可能です。

関数における型ヒントの活用も見逃せません。引数や戻り値に型を指定することで、関数の使い方が明確になり、補完機能を持つエディタとの相性も良くなります。初心者のうちから型ヒントの書き方に慣れておくことで、将来的にも読みやすく安全なコードを書く力が身につきます。

以下は、学んだ内容を整理したPythonのサンプルコードです。

from typing import List, Dict, Optional

# 基本の型ヒント
name: str = "たろう"
age: int = 20
height: float = 175.5
is_student: bool = True

# 関数に型ヒント
def greet(name: str) -> str:
    return f"こんにちは、{name}さん！"

# リストや辞書
scores: List[int] = [85, 90, 78]
profile: Dict[str, str] = {"名前": "たろう", "趣味": "ゲーム"}

# Optional型
nickname: Optional[str] = None

# 戻り値がない関数
def say_hello(name: str) -> None:
    print(greet(name))

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

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

プログラミング初心者からのよくある疑問／質問を解決します

Pythonで変数を宣言する方法が知りたいです。初心者でもわかる書き方はありますか？

Pythonの変数宣言はとても簡単で、イコール記号（=）を使って値を代入するだけです。例えば、name = "たろう" のように書くだけで変数が作られます。

Pythonで変数名に使ってはいけないルールや禁止事項はありますか？

変数名には英数字とアンダースコアのみ使えます。数字で始めることや、ifやforなどの予約語を使うことは禁止されています。

Pythonの型ヒント（type hints）って何のために使うんですか？

型ヒントは、変数や関数がどのような型のデータを扱うかを明示するために使います。コードの読みやすさが上がり、ミスを防ぎやすくなります。

Pythonの型ヒントはプログラムの実行に影響しますか？

いいえ、型ヒントはあくまで補助的な情報であり、実行時の動作には影響しません。