CSV末尾の空欄が消えて項目数が変わる原因と確認方法

末尾の空欄で起きること

CSVでは、最後に値が入っていない項目も、位置として必要なら一つのフィールドです。画面に何も表示されないため、Excelや別の保存ツールで行末の区切りが省略されると、利用者は「空欄が消えただけ」と思うかもしれません。実際には、1行の項目数が一つ減り、配送会社の取込条件と違う構造になります。

日本郵便のWebゆうパックプリント標準フォーマットは見出しなし72項目、ヤマト運輸B2クラウド基本レイアウトは公式見出しを含む95項目です。72項目が71項目、95項目が94項目になった場合でも、最後の一つだけが空欄だったのか、途中の列が抜けて後ろがずれたのかで安全性は大きく異なります。

最初に構造を確認する

各行の項目数

ヘッダーと全データ行をCSVパーサーで読み、行ごとのセル数を確認します。

最後の位置

最後に空欄が必要なフィールドなのか、そもそも行の項目定義が違うのかを確認します。

中間の位置

後ろの値が一列ずつずれていないかを作成元または公式レイアウトで確認します。

保存経路

Excel、別のCSVツール、区切り文字の変更で行末や引用符が変わっていないか比較します。

区切り・引用符・空欄の技術的な違い

合成例の「A,B,C,」は、4つ目の空フィールドまでを表します。「A,B,C」は、通常のカンマ区切り解釈では3フィールドです。空欄が最後にあることと、区切り文字が余分にあることは見た目が似ていますが、CSVとして読んだときのセル数が違います。

一方、値の中にカンマがある場合は、全体を二重引用符で囲んで一つのフィールドにします。引用符を途中で削ると、カンマが列区切りとして扱われ、後ろの値がずれます。行の途中の空欄を削除して詰めることも、同じように意味を変えます。CSVの一般的な構文を紹介するRFC 4180も、実装には差があることを明記しているため、配送会社の形式と実際のパーサー結果を優先します。

Excel・テキスト編集での確認

1. 元ファイルを複製してから、保存用の別ファイルを作ります。
2. Excelでは、末尾の空欄が画面に見えないことを前提に、列位置と保存後のCSVを再確認します。
3. テキストエディターで引用符を壊さずに確認し、CSVツールで各行のフィールド数を出します。値の中のカンマ、引用符、改行がある行は特に目視カウントを避けます。
4. 行によって71・72、94・95のように混在していないか、ヘッダーの有無、最終改行の有無を記録します。

途中の列が一つ抜けている場合、後ろの値の正しい移動先はCSVだけから決まりません。最後に空欄を足して項目数だけ合わせると、住所、金額、サービスコードなどが別の項目に入ったままになる危険があります。

送り状CSVドクターで確認できる範囲

対応形式を選ぶと、ツールは引用符内のカンマや改行を含めてCSVとして解析し、行ごとの列数、ヘッダー、構造エラーを確認します。日本郵便72項目とヤマト95項目はそれぞれの対応プロファイルで判定され、作業内容はブラウザ内に留まります。

現行の安全修正には、明白な末尾空欄だけを対象にした配送会社別の候補があります。ただし、この共通ガイドが新しい修正を追加するわけではありません。候補が表示されても、修正前後、対象行、最後のフィールド、再検査結果を確認し、途中の欠落・複数不足・余分な列・壊れた引用符があれば自動修正を前提にしません。

• 日本郵便の項目数不一致を見る
• ヤマトの項目数不一致を見る

末尾だけの不足と中間列欠落の境界

一つの最後の空欄が保存経路で消え、元のフィールド位置と全行の構造が確認できるケースは、既存の配送会社別候補で扱える可能性があります。複数フィールドの不足、途中の列欠落、行ごとに異なる不足、96項目など余分な値、引用符が壊れた行は、正しい値や位置を推測できないため自動で直しません。

Excelで再保存したCSVで末尾空欄と先頭0、文字コードが同時に変わった場合は、Excel編集の確認項目を先に読みます。配送会社ごとの項目定義は、現在の公開ルールと公式資料を照合してください。