よくある原因
ZIPファイルの仕様では、ファイル名の文字コードをUTF-8とするかShift_JISとするかが長らく曖昧でした。WindowsのエクスプローラーはデフォルトでShift_JISを使ってZIPを作成しますが、macOSや多くのLinux環境はUTF-8を期待するため、相互にZIPを渡すと文字化けが起きます。
ギガサイト便はCloudflare Workersで動作するため、Linux系の処理系を使っています。Windows環境で作成したZIPをそのままアップロードすると、日本語フォルダ名が文字化けしてHTMLからの参照が404になります。
- 相手がログインなしで開ける状態か確認する
- PCとスマホで最低1回ずつ表示を確認する
- 内部情報・個人情報・不要な外部送信が残っていないか見る
- レビュー期限と修正時の差し替え方を決めておく
自分側で確認すること
まず、ZIPの中身をmacOSまたはLinux上で展開して日本語フォルダ名が正しく表示されるかを確認します。Windows上の7-ZipでZIPを作成する場合は、設定でUTF-8エンコードを明示的に選択することで互換性が高まります。7-Zipのバージョン22以降は「UTF-8」チェックボックスがメニューに追加されています。
最も確実な対処法は、フォルダ名を英数字とハイフンのみに変更することです。「資料/」を「documents/」に、「画像/」を「images/」に変えるだけで文字コード問題を根本から回避できます。HTMLや他のファイルから参照している場合は、参照パスも同時に変更する必要があります。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
相手側で確認すること
相手が文字化けを報告した場合、どの解凍ソフトを使っているかを確認します。Windowsの標準解凍機能は古い仕様に対応していないことがあり、7-ZipやWinRARを使うと文字化けが解消する場合があります。相手に「7-Zipで解凍し直してください」と依頼するのが最初の対処として有効です。
相手がmacOS上でZIPを解凍している場合、Archiver 4やThe Unarchiverなどのサードパーティツールをすすめると文字化けが解消することがあります。Appleの標準解凍機能（Finder）はShift_JIS ZIPに対して不安定なことが知られています。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
再発防止の運用
プロジェクト内のファイル・フォルダ命名規則を「英数字・ハイフン・アンダースコアのみ使用可」として文書化し、参加メンバー全員に共有します。AI生成ツールでファイル名を自動付与する場合もプロンプトに「フォルダ名とファイル名は英数字のみで付けること」と明記します。
GitHubやNotionでZIPを共有する場合も同様のルールを適用してください。日本語ファイル名はGitでは問題なく動くことが多いですが、ZIPに圧縮した段階で問題が発生するため、最終成果物の命名規則は常に英数字を維持するのが最も安全です。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
よくある質問
WindowsでUTF-8エンコードのZIPを作成するにはどうすればよいですか？
7-Zip 22以降を使い、圧縮ダイアログで「UTF-8」にチェックを入れてください。PowerShellのCompress-Archiveコマンドもデフォルトでは問題が残るため、7-Zipの使用が最も確実です。
既に日本語フォルダ名のZIPを送ってしまいました。相手側で対処できますか？
相手が7-ZipやWinRARを使って解凍すると、文字化けせずに展開できる場合があります。ただし保証はないため、可能であればフォルダ名を英字に変更したZIPを再送することをお勧めします。
macOSのFinderで作ったZIPはWindows側で文字化けしますか？
macOS FinderはUTF-8でZIPを作成するため、Windows側で7-Zipなど対応ツールを使えば正しく展開できます。ただしWindowsの標準解凍機能では文字化けする場合があるため、受け取る側に対応ツールの使用を案内してください。