- JSONファイルとは？
- PythonでJSONファイルをどうやって読み込むの？
- エラーが出たときはどうすればいいの？
JSONは、データを効率的にやり取りするためのフォーマットとして、プログラミング初心者から上級者まで幅広く使われています。
その扱いやすさから、APIやウェブアプリ開発でも欠かせない存在です。
しかし、JSONファイルの読み込み方法やエラーへの対処方法を正しく理解していないと、思わぬところでつまずいてしまうこともあります。
この記事では、Pythonを使ってJSONファイルを読み込む方法を具体的なコード例や注意点とともにわかりやすく解説します。
初めてJSONに触れる方でも安心して理解できる内容なので、ぜひ最後までご覧ください！
目次
JSONファイルを読み込む方法
この章では、JSONファイルを読み込む方法について以下の通りに解説します。
- JSONファイルとは
- PythonでJSONを扱う準備
1つずつ詳しく見ていきましょう。
JSONファイルとは
JSON（JavaScript Object Notation）は、データを保存するための軽量で扱いやすいフォーマットです。
これはテキスト形式で記述され、人間にもコンピューターにも理解しやすい構造になっています。
例えば、キーと値のペアを持つ辞書のような形をしています。
以下はJSONの簡単な例です：
{
"name": "Taro",
"age": 25,
"skills": ["Python", "JavaScript"]
}この形式は、ウェブアプリケーションやAPIでよく使われます。
JSONは柔軟でありながら、扱いやすい点が魅力です。
Pythonを使うと、このデータを簡単に読み書きできます。
次のセクションでは、PythonでJSONを扱う準備について詳しく説明します。
PythonでJSONを扱う準備
PythonでJSONを扱うには、標準ライブラリのjsonモジュールを使います。
このモジュールをインポートするだけで、特別な準備なしにJSONデータを簡単に操作できます。
以下はJSONファイルを読み込む基本的なコードです：
Pythonコード
import json
# JSONファイルを読み込む
with open('data.json', 'r', encoding='utf-8') as file:
data = json.load(file)
# 読み込んだデータを表示
print(data)このコードでは、json.load()を使ってJSONファイルを辞書形式で読み込んでいます。
以下は、サンプルJSONファイルdata.jsonの内容を表示する例です：
data.json
{
"name": "Taro",
"age": 25,
"skills": ["Python", "JavaScript"]
}出力例
{'name': 'Taro', 'age': 25, 'skills': ['Python', 'JavaScript']}このように簡単なコードで、JSONデータを操作できます。
JSONを扱う際は、データの形式が正しいかを確認し、適切なエンコーディング（例：utf-8）の使用が大切です。
JSONファイルを読み込むコード例
この章では、JSONファイルを読み込むコード例について以下の通りに解説します。
- 基本的なコードの解説
- ファイルを開くときの注意点
1つずつ詳しく見ていきましょう。
基本的なコードの解説
PythonでJSONファイルを読み込む際は、標準ライブラリのjsonモジュールを使います。
このモジュールを使うと、JSONデータを辞書やリストとして扱えるため、とても便利です。
基本的な手順は、ファイルを開き、その内容を読み込むだけです。
以下に具体的なコードを示します。
Pythonコード
import json
# JSONファイルを開いて読み込む
with open('data.json', 'r', encoding='utf-8') as file:
data = json.load(file)
# データを表示
print(data)このコードは、open()でファイルを開き、json.load()でJSON形式のデータをPythonの辞書に変換します。
サンプルファイルとして以下のようなdata.jsonがあるとします：
data.json
{
"name": "Taro",
"age": 25,
"skills": ["Python", "JavaScript"]
}実行すると、次のような結果が得られます。
出力例
{'name': 'Taro', 'age': 25, 'skills': ['Python', 'JavaScript']}このコードはシンプルですが、効率的でミスが少ない方法です。
ファイルを閉じる処理も自動で行われるため、リソースを無駄にしません。
次のセクションでは、ファイルを開く際の注意点について説明します。
ファイルを開くときの注意点
JSONファイルを扱うときは、エンコーディングやファイルの存在確認に注意が必要です。
エンコーディングが適切でない場合、データが正しく読み込めないことがあります。
utf-8を指定すると、文字化けを防げます。
次に、ファイルが存在しない場合のエラーを防ぐために、例外処理を追加する方法を紹介します。
Pythonコード
import json
try:
# ファイルを開く
with open('data.json', 'r', encoding='utf-8') as file:
data = json.load(file)
print(data)
except FileNotFoundError:
print("ファイルが見つかりません")
except json.JSONDecodeError:
print("JSON形式が正しくありません")このコードは、ファイルが存在しない場合やデータ形式が間違っている場合にエラーをキャッチします。
data.jsonが存在しない場合の出力例は以下の通りです。
出力例
ファイルが見つかりませんこれらの注意点を守ると、JSONファイルの読み込み時に起こり得るトラブルを未然に防げます。
正しいエンコーディングを使い、例外処理を組み込むことが安全にデータを扱うコツです。
JSONファイルを安全に読み込む方法
この章では、JSONファイルを安全に読み込む方法について以下の通りに解説します。
- エラー処理を追加する方法
- よくあるエラーと対処法
1つずつ詳しく見ていきましょう。
エラー処理を追加する方法
JSONファイルを扱う際には、エラー処理を追加するとプログラムの安全性を高められます。
特に、ファイルが存在しない場合やデータ形式が正しくない場合は、エラーが発生する可能性があります。
これを防ぐために、Pythonのtryとexcept構文を使ったエラー処理の実装が必要です。
以下は、エラー処理を追加したJSONファイルの読み込みコードです。
Pythonコード
import json
try:
# JSONファイルを開く
with open('data.json', 'r', encoding='utf-8') as file:
data = json.load(file)
print(data)
except FileNotFoundError:
print("指定したファイルが見つかりません")
except json.JSONDecodeError:
print("JSON形式が正しくありません")このコードでは、FileNotFoundErrorが発生した場合に「指定したファイルが見つかりません」とメッセージを表示します。
また、ファイルが存在しても中身が正しいJSON形式でない場合、json.JSONDecodeErrorをキャッチして「JSON形式が正しくありません」と知らせます。
出力例（ファイルが存在しない場合）
指定したファイルが見つかりません出力例（JSON形式が不正の場合）
JSON形式が正しくありませんエラー処理を組み込むと、ユーザーに分かりやすいメッセージを伝えられ、トラブルシューティングが簡単になります。
これにより、プログラムの信頼性も向上します。
よくあるエラーと対処法
JSONファイルを扱う際に起こりやすいエラーとして、主に「ファイルが見つからない」「エンコーディングの不一致」「形式の不正」の3つが挙げられます。
それぞれの問題と対処法を詳しく解説します。
1つ目のエラーは、ファイルが見つからないケースです。
ファイルパスを正しく指定していない場合や、ファイル名にミスがある場合に発生します。
この問題を防ぐには、プログラムを実行する前にファイルの存在の確認が重要です。
2つ目は、エンコーディングの不一致です。
日本語を含むJSONファイルでは、文字コードがutf-8で保存されているか確認してください。
以下のコードを使用してエンコーディングを指定できます。
Pythonコード
with open('data.json', 'r', encoding='utf-8') as file:
data = json.load(file)3つ目は、JSON形式が不正な場合です。
たとえば、カンマの付け忘れや、キーと値のダブルクオートが抜けている場合に発生します。
以下の例では、不正なJSONを修正する方法を示します。
不正なJSON
{
"name": "Taro"
"age": 25
}修正後のJSON
{
"name": "Taro",
"age": 25
}これらのエラーに注意しながら作業すれば、スムーズにJSONデータを扱えます。
正しい形式と適切なエンコーディングを守り、エラー処理を追加すると、さらに安心してプログラムを実行できます。
JSON文字列を扱う方法
この章では、JSON文字列を扱う方法について以下の通りに解説します。
- JSON文字列を読み込むコード例
- JSON文字列を扱う際の注意点
1つずつ詳しく見ていきましょう。
JSON文字列を読み込むコード例
JSON文字列をPythonで扱う場合、json.loads()を使用します。
このメソッドは、JSON形式の文字列をPythonの辞書やリストに変換してくれます。
ファイルを使わず直接文字列を処理できるため、APIからのデータ取得やテストで使用可能です。
以下は、JSON文字列を読み込む基本的なコード例です：
Pythonコード
import json
# JSON形式の文字列
json_string = '{"name": "Taro", "age": 25, "skills": ["Python", "JavaScript"]}'
# JSON文字列をPythonの辞書に変換
data = json.loads(json_string)
# データを表示
print(data)
print(data["name"])このコードでは、json_stringという文字列をjson.loads()で辞書形式に変換しています。
出力を以下に示します。
出力例
{'name': 'Taro', 'age': 25, 'skills': ['Python', 'JavaScript']}
Taroこの方法は、APIやネットワーク通信で受け取ったデータを処理するのに便利です。
また、文字列としてデータを直接扱えるため、ファイル操作が不要な場面でも役立ちます。
次に、JSON文字列を扱う際の注意点について説明します。
JSON文字列を扱う際の注意点
JSON文字列を扱うときに気をつけるべき点は、形式の正しさとエンコーディングです。
JSON形式が少しでも間違っているとエラーが発生するため、入力データの整合性を確認する必要があります。
また、受け取るデータがUTF-8でエンコードされているかも重要です。
以下は、形式が不正なJSON文字列を扱った場合の例です。
不正なJSON文字列
json_string = '{"name": "Taro", "age": 25, "skills": ["Python" "JavaScript"]}'この例では、"Python"と"JavaScript"の間にカンマがないためエラーになります。
このようなエラーを防ぐには、例外処理を使う方法が有効です。
Pythonコード
import json
# 不正なJSON文字列を処理する例
json_string = '{"name": "Taro", "age": 25, "skills": ["Python" "JavaScript"]}'
try:
data = json.loads(json_string)
print(data)
except json.JSONDecodeError:
print("JSON形式が正しくありません")出力例
JSON形式が正しくありませんさらに、文字列内で特殊文字が含まれる場合も注意が必要です。
たとえば、ダブルクオートはエスケープする必要があります。
正しいエスケープ例
json_string = '{"text": "He said, \\"Hello\\""}'データ形式の正確さを保ち、例外処理を追加すると、エラーを最小限に抑えられます。
これにより、API連携や他のシステムとのデータ交換も安心して行えます。
まとめ
PythonでのJSONファイルの読み込み方について、基本的なコード例や注意すべきポイントを解説してきました。
JSONはそのシンプルさから、多くの場面で活躍するフォーマットですが、正しく扱うためにはエラー処理や形式の確認が欠かせません。
今回紹介した方法を参考に、JSONを安全に活用できるようになれば、プログラミングの幅も大きく広がるはずです。
ぜひ、自分のプロジェクトに活用してみてください。
そして、新しい知識を実際にコードで試しながら、JSONの操作に慣れていきましょう！
なお、Pythonを挫折せずに学びたい方には以下の記事がおすすめです。
現役のPythonエンジニアがおすすめのプログラミングスクールを2つ厳選しました。
ぜひご覧ください！
