CSVGuide2026-10-12

CSVの住所や説明文にカンマがあるなら、そのセルだけ引用符で囲む

約5分で読めます

こんな人向け住所・説明・タグなどカンマを含むデータをCSVへ書き出す人
難易度入門

CSVの値そのものにカンマが含まれると列がずれる理由と、RFC 4180の基本に沿って二重引用符で1フィールドとして保持する方法を整理します。

目次を開く

CSVの列が途中からずれたとき、よくある原因の一つが値そのものに含まれるカンマです。CSVではカンマが列境界なので、住所や説明文のカンマをそのまま書くと次の列として解釈されます。

カンマを含むフィールドを引用符で囲む

RFC 4180では、カンマを含むフィールドは二重引用符で囲う形が示されています。

name,address,note
Sato,"Sapporo, Hokkaido","call after 18:00"

"Sapporo, Hokkaido" は1フィールドです。引用符がなければ2列として読まれる可能性があります。

全セルを囲う必要はない

カンマや改行、引用符を含むセルだけ囲っても成立します。ただし出力ツールごとに統一形式を使った方が差分確認は簡単です。

データ内カンマが列ずれを起こす例と引用符で守る例

手で置換するよりCSVライブラリを使う

プログラムでCSVを生成するなら、自前で join(",") するより標準のCSVライブラリを使う方が安全です。ライブラリに引用規則を任せ、出力後に数行をテキストで確認します。

列数不一致や引用符崩れの事前検査には、CSV Preflightを使えます。

本番投入前の最終チェック

カンマを含む代表値を抽出して、前後の引用符が揃っているか確認します。CSVパーサーで読み直し、全行の列数がヘッダーと一致することを確認してから投入します。

  • 値内カンマを含む行を確認した
  • 引用符を閉じた
  • パーサーで再読込した
  • 列数を比較した
  • 元CSVを残した

文字としてカンマが見えるかではなく、パーサーが1フィールドとして読めるかで判定します。

修正後は値そのものも照合する

列数が揃っただけで完了にすると、引用処理の途中でカンマや空白を削ってしまった事故を見逃します。修正前の代表値と再読込後の値を文字列で比較し、住所・タグ・説明文が同じ内容のまま1フィールドとして復元されることまで確認します。行数と列数に加えて値の一致をREADBACKへ含めると、安全に本番へ戻せます。

NEXT

次に読む。

CSV / Guide

CSVのセル内に「"」を入れるなら、二重引用符をもう一つ重ねる

約5分

CSVの説明文や商品名に二重引用符を含めたいとき、フィールド全体を引用し、内部の引用符を二つ重ねてエスケープする基本を整理します。

CSV / Guide

CSV行末のカンマ1個が「空の余計な列」を作る

約5分

CSVの行末へ余分なカンマが入ったときに列数が1つ増え、インポーターで列数不一致になる仕組みと見つけ方を整理します。

CSV / Guide

Shopify CSVの「Illegal quoting」を、引用符の事故として直す

約5分

Shopifyの商品CSVでIllegal quotingが出るときに、UTF-8、カンマを含む値、二重引用符の閉じ忘れをテキストとして確認する手順を整理します。

SHARE
XBLUESKYFACEBOOKLINE