はじめての道具箱 — まず知っておくこと
— データを入れる2つの箱 —
AI に道具を作ってもらうと、「データを CSV で保存します」「JSON にします」といった言葉が出てきます。この記事では、2つの違いと、どちらがどんなデータに向いているかを、はじめての人向けに説明します。
この記事を読むとできること
想定している使い方
ブラウザで開くチャット型の AI（Gemini や ChatGPT など）にコードを書いてもらい、 それを自分の Mac に保存して動かす使い方です。この記事の操作や画面の説明は、すべて Mac を前提にしています。
読む目安：約12分 ・ 道具箱の項目 A2（まず知っておくこと）・ 図4枚
CSV は「表」を文字だけで書いたもの、JSON は「名札を付けた箱を、入れ子にしたもの」を文字だけで書いたものです。どちらも、道具が覚えておきたい情報をファイルとして保存するための箱です。
AI に作ってもらう道具の多くは、一覧や成績のような情報を、Mac の中にファイルとして保存します。そのとき AI から「CSV で保存します」「JSON にします」と提案されます。
2つの違いを知らないと、提案の理由が分からず、データの形に合わない箱を選んでしまい、あとで中身が崩れることがあります。どちらにするかは AI が提案してくれますが、データがどんな形をしているかを一番よく知っているのはあなたです。違いを知っておくと、提案が合っているかを判断できるようになります。
図の見方：上の段は、解くたびに「いつ解いて、合っていたか」の記録が1回分ずつ増え、問題ごとに記録の数が違う「クイズの成績」を、列の数が決まった表（CSV）に押し込んだ場合です。入りきらない情報が出て、はみ出したりずれたりします。下の段は、同じ成績を、箱の中に箱を入れられる JSON に入れた場合で、あとから情報が増えても崩れずに入ります。
動画2本ぶんの「タイトル・大分類・中分類」を、それぞれの形で書いてみます。覚えるのは書き方ではなく、形の違いです。
CSV では、1行目に見出しを書き、2行目から1件ずつ、項目を「,」（カンマ）で区切って並べます。Numbers（Apple の表計算アプリ。App Store から無料で入れられます）や Excel で開くと、そのまま表として見られます。JSON では、1件ぶんの情報を「{ }」でくくった箱に入れ、その箱を「[ ]」でくくって一覧にします。値の前には毎回「タイトル」のような名札が付きます。
※ CSV は Comma-Separated Values（カンマで区切った値）、JSON は JavaScript Object Notation（JavaScript というプログラミング言語の書き方を借りた、データの書き方）の略です。名前は覚えなくて大丈夫です。
動画の一覧は、どの1本も「タイトル・大・中」と同じ欄を持つので、表（CSV）にぴったり収まります。
一方、クイズの成績を「いつ解いて、合っていたか」の記録として残すと、1問ごとに、解くたびに記録が1回分ずつ増えていきます。3回解いた問題には3回分、1回しか解いていない問題には1回分と、問題ごとに記録の数が違い、1つの欄の中にさらに一覧がある形です。こうしたデータは、箱の中に箱を入れられる JSON の方が、無理なく入ります。
※ どちらを使うかは、AI が提案してくれます。違いを知っておくと、その提案の理由が読めるようになります。
筆者の体験メモ
筆者の道具では、動画の一覧を CSV、クイズの問題と成績を JSON で保存しています。
CSV も JSON も、中身は文字だけです。書類の中で付けた太字や赤い文字は、箱に移したとたんに落ちてしまいます。下の図では、「無効」に太字と色を付けた解説の文を CSV にしたところ、文字は残っても、太字と色が消えています。
※ 装飾を残したいときは、装飾を決まった記号の「印」に置き換えてから箱に入れるか、元の書類から直接読み取る方法に変えてもらいます。
筆者の体験メモ
筆者もクイズの道具でこの壁に当たりました。問題をスプレッドシートに移して CSV で読み込んでいたころは、原本で付けた文字の色や太字がすべて落ちてしまい、セルの中に手で印を書き込むか、原本へ飛ぶボタンを置いて見に行く、という形で折り合いをつけていました。のちに（2026年7月）、書類（Word 形式で書き出したもの）から直接読む方法に変えて、太字や色をそのまま画面に出せるようになりました。
起きていることから探してください。
| 起きていること | 原因 | どうするか |
|---|---|---|
| CSV を表計算アプリで開いたら、文字化けした | 文字の符号の決まり（文字コード）が、作った側と開いた側で違う | AI に「この CSV を Numbers で開くと文字化けする」と伝えて、保存の仕方を合わせたコードにしてもらいます |
| CSV の一部の行だけ、列が1つずつずれる | 中身の文に「,」（カンマ）が入っていて、区切りと読まれた | 文を「"」でくくる書き方のコードにしてもらいます |
| 太字や色が消えた | CSV も JSON も文字だけの箱だから | 装飾を印に置き換えるか、元の書類から直接読む方法に変えてもらいます |
| JSON を手で少し直したら、道具がまったく読めなくなった | かっこやカンマが1つ欠けるだけで、ファイル全体が読めなくなる | 手で直す前に控え（コピー）を残します。直すのは道具の画面からにするか、直し方を AI に聞きます |
| JSON を開いたら、1行にぎっしり詰まっていて読めない | 改行を省いて保存してある（機械にとっては同じ意味） | 読みやすく表示する方法を AI に聞きます（中身を貼る前に、個人の情報が入っていないか確かめます） |
※ この道具箱は対話型コーディング（ブラウザの画面でチャットの AI と文章をやりとりして、コードを書いてもらうやり方）の前提です。 チャットの AI はあなたの Mac を見られないので、頼むのは「コードを書いて」、困ったら出た文字を貼って伝えます。 形式を自分で決める必要はありません。どんなデータを、何に使うかを話して、形式は理由つきで提案してもらうのが近道です。 下の文は、そのまま写すためのものではなく、言い方の見本です。
保存の形を決めてもらうとき
「クイズの問題と、1問ごとの成績を保存したい。成績は解くたびに増えていく。CSV と JSON のどちらがいいか、理由を1行ずつ添えて提案して」
壊れたときの扱いを決めておくとき
「保存したファイルが壊れていて読めないときは、空っぽとして扱わずに、止めて画面に知らせるコードにして。上書きもしないようにして」
※ 2つ目は地味ですが大事です。「読めない＝0件」として先に進むと、そのまま空の中身で上書きされ、それまでの記録が消えることがあります。
箱がデータの形に合っているかは、実際に開いて、1件直して、もう一度開くことで確かめられます。
CSV の場合は、Numbers で開いて、全部の行で列がそろっているか（右へはみ出した行が無いか）を見ます。
JSON の場合は、道具の画面で1件だけ直して保存し、道具を起動し直しても、その変更が残っているかを見ます。
太字や色が要るデータなら、装飾を付けた1件が、道具の画面でもそのまま見えているかを確かめます。消えていたら、「文字だけの箱には、太字も色も入りません」の話です。