CSV文字化け・列ズレ地獄

CSV文字化け・列ズレ地獄とは

CSV文字化け・列ズレ地獄とは、SaaSやシステムからエクスポートしたCSVファイルが、文字化けしたり列がズレて正しく読めない状態です。

「CSVを開いたら日本語が全部「?????」になっていた」「カンマが含まれるデータがあって列がズレた」「同じ操作なのに、今月だけ壊れている」——CSVを扱う現場では、こうした問題が頻繁に発生します。

文字化けの原因

文字化けは、エンコーディング（文字コード）の不一致が原因であることが多いです。

• 出力側がUTF-8、取り込み側がShift_JISを期待している
• BOM（バイトオーダーマーク）の有無が違う
• Mac/Windowsでの文字コードの違い

対策は、出力側のエンコーディングを確認し、取り込み側の設定を合わせることです。Excelで開く場合は、UTF-8のBOM付きにすると文字化けしにくくなります。

列ズレの原因

列ズレは、区切り文字とデータの内容の問題であることが多いです。

• データ内にカンマが含まれている（カンマ区切りの場合）
• データ内に改行が含まれている
• ダブルクォートのエスケープが不正
• ヘッダー行とデータ行の列数が違う

対策は、出力側でダブルクォートを正しく付ける、改行を含むフィールドを適切に処理する、取り込み側でパーサの設定を確認することです。

sento.groupの進め方

CSV問題に対して、以下の手順で進めます。

• 問題が発生しているCSVファイルを確認する
• 出力側の設定（エンコーディング、区切り文字、エスケープ）を確認する
• 取り込み側の設定（期待するエンコーディング、パーサ設定）を確認する
• 手修正ではなく、安定した連携の形を設計する（API連携、自動変換、中間処理）

毎回手で修正するのではなく、原因を特定して仕組みで解決します。

CSVからAPI連携への移行

CSV文字化け・列ズレ地獄を根本的に解消するには、CSV連携からAPI連携への移行を検討します。

APIで直接データを取得すれば、エンコーディングや区切り文字の問題は発生しません。ただし、APIがないSaaS、APIの制限、実装コストも考慮する必要があります。SaaSデータ連携開発では、この判断も含めて設計します。

SaaSのCSV月末との関係

本ページ（CSV文字化け・列ズレ地獄）は、CSVの技術的な問題を解説しています。月末にCSVを集める業務全体の課題は、「SaaSのCSVを月末に集める地獄」ページも参照ください。