データ移行約5分で読めます

CSVの書き出し|他のシステムに渡す形

CSVの書き出しを表したイメージ
記事の内容を表したイメージ(AI生成)

手元のスプレッドシートをCSVに書き出したのに、渡した先のシステムで文字化けしたり、列がずれたりして取り込めない――そういった状況で検索している方に向けて書いています。

この記事で扱うのは「書き出す側」の作業です。どの文字コードを選ぶか、区切り文字は何にするか、日付や数値はどう整形するか、という判断基準と具体的な手順を順番に示します。受け取るシステムの仕様が分かっている前提で読み進めてください。仕様が不明なときの確認方法も後半で触れます。

CSVの書き出しで失敗する原因の大半は、「書き出し側のデフォルト設定」と「受け取り側が期待する設定」のずれです。Excelの「CSV(コンマ区切り)」で保存すると、Windowsでは通常Shift_JIS(CP932)で書き出されますが、多くのWebサービスやLinux系のシステムはUTF-8を前提としています。この一点を合わせるだけで解決するケースが多くあります。


まず受け取り側の仕様を確認する

書き出す前に、渡す先のシステムが何を期待しているかを確認します。確認すべき項目は次の四つです。

  • 文字コード:UTF-8かShift_JIS(CP932)か。UTF-8の場合、BOM(バイト順マーク)付きを求めるかどうかも確認します。
  • 区切り文字:コンマ(,)かタブか、セミコロンかを確認します。
  • 改行コード:Windows(CRLF)かUnix/Mac(LF)か。
  • ヘッダ行:1行目に列名を含めるか、データ行だけで渡すか。

これらはシステムの「インポート仕様書」「データ取り込みガイド」などに記載されています。社内システムであれば担当部署、外部サービスであれば公式のヘルプページを確認してください。仕様書がない場合は「UTF-8(BOMなし)・コンマ区切り・LF・ヘッダあり」が現在のWebサービスで最も通用する組み合わせです。ただしこれを「正解」とせず、取り込みテストで必ず確認してください。


文字コードを指定して書き出す

Excelで書き出す場合

Excelの「名前を付けて保存」から選べるCSV形式は複数あります(画面の表示は版や設定により異なります)。

  • 「CSV UTF-8(コンマ区切り)」:UTF-8・BOMあり。多くのExcelバージョンで選べます。BOMを嫌うシステムに渡すときは後処理が必要です。
  • 「CSV(コンマ区切り)」:Shift_JIS(CP932)。古い国内システムや、特定の自治体・行政のインポートで指定されることがあります。

BOMの有無を変えたいときや、LFに変換したいときは、一度保存してからテキストエディタで開き直して保存し直す方法が確実です。VSCodeやサクラエディタなどのテキストエディタは文字コードと改行コードを指定して保存できます。

Googleスプレッドシートで書き出す場合

「ファイル」→「ダウンロード」→「カンマ区切り形式(.csv)」を選ぶと、UTF-8・BOMなし・LF・コンマ区切りで書き出されます。Shift_JISでの書き出しは直接できないため、必要な場合はダウンロード後にテキストエディタで変換します。


データの中身を整形する

文字コードが合っていても、セルの中身が受け取り側の期待する形になっていなければ取り込みエラーになります。

日付の形式

Excelのセルに「2026/10/21」と表示されていても、システムによっては「2026-10-21」や「20261021」を求めることがあります。書き出す前にセルを文字列として整形しておくと安全です。

=TEXT(A2,"YYYY-MM-DD")

上の数式(ExcelでもGoogleスプレッドシートでも同じ形)を使うと、日付セルの値を指定した文字列形式に変換できます。数式のままCSVに書き出すと数式ごと出力されるため、書き出し前に「値のみ貼り付け」で文字列に置き換えておきます。

数値・ゼロ埋め

「0001」「0002」のような先頭ゼロが必要なコード列は、Excelで数値として入力すると「1」「2」になってしまいます。列全体を文字列として設定してから入力するか、TEXT関数で整形します。

=TEXT(A2,"0000")

4桁ゼロ埋めの例です。架空の例として、社員番号が1〜999まであり、4桁で渡す仕様の場合は上の数式で「0001」〜「0999」に変換できます。これも値貼り付けで確定させてから書き出します。

コンマを含む値の扱い

住所や備考欄など、文字列の中にコンマが含まれるセルがある場合、CSVに書き出すとその位置で列がずれます。通常、スプレッドシートのCSV書き出し機能は該当セルを自動的にダブルクォート(")で囲んでくれますが、ダブルクォート自体が値に含まれるときは""(2つ並べる)にエスケープする仕様が一般的です。書き出し後にテキストエディタで目視確認するとトラブルに気づきやすくなります。

改行を含むセル

セル内で改行(Alt+Enter)を使っている場合、CSV上では行がずれる原因になります。書き出す前にセル内改行を除去するか、スペースや別の記号に置換しておきます。

=SUBSTITUTE(A2,CHAR(10)," ")

CHAR(10)はLF(改行コード)を表します。ExcelでもGoogleスプレッドシートでも同じ形で使えます。


書き出し前後のチェック手順

作業を始める前に、元のファイルを必ずコピーして保存しておきます。書き出し後に元に戻せる状態を確保してから進めてください。

  1. 仕様の確認:文字コード・区切り文字・改行コード・ヘッダ要否をメモする。
  2. データの整形:日付・ゼロ埋め・コンマ・セル内改行を仕様に合わせて変換し、値貼り付けで確定させる。
  3. 書き出し:指定の形式でCSVを書き出す。
  4. 目視確認:テキストエディタでCSVを開き、1行目のヘッダ、数行分のデータ、最終行を確認する。文字化けがないか、列数が一致しているかを見る。
  5. テスト取り込み:本番データを渡す前に、数行だけ抜き出したテスト用CSVで取り込みを試す。取り込み結果を受け取り側に確認してもらう。

テスト取り込みに個人情報を含む名簿などを使う場合は、外部サービスや共有環境に入れる前に情報取り扱いのルールを確認してください。


受け取り側から「文字化けした」と言われたとき

取り込んだ結果が文字化けしている場合、原因は文字コードかBOMのどちらかである場合がほとんどです。

表は横にスクロールできます

症状考えられる原因対処
日本語が「???」や記号になっている文字コードが合っていないUTF-8←→Shift_JISを切り替えて再書き出し
1列目の先頭に「」などが入っているUTF-8のBOMを受け取り側が処理できないBOMなしで保存し直す
1行目がすべて1列目に入っている区切り文字が合っていない(タブとコンマの混在など)区切り文字を確認して再書き出し
行数が増えているセル内改行が残っているセル内改行を除去して再書き出し

BOMを取り除くだけであれば、VSCodeでファイルを開き、右下の文字コード表示をクリックして「UTF-8」(BOMなし)を選んで上書き保存する方法が手軽です(画面の表示は版や設定により異なります)。


次の行動

受け取り側のシステムの仕様書またはヘルプページを開き、文字コード・区切り文字・改行コード・ヘッダの有無の4点を確認してください。仕様が取れたら、数行のテストデータで書き出しと取り込みを試してから本番作業に進んでください。不明点があれば渡す前に受け取り担当者に確認するのが、手戻りを最も減らせる判断です。

参考資料

この記事の本文はAI(Claude)が執筆しました。画面の表示や操作名は、アプリの版や設定によって異なります。実際の操作の前に元のファイルを複製し、公式のヘルプで最新の情報を確認してください。

記事の誤り・ファイルの不具合を知らせる · 修正記録

記事一覧へ