クロスプラットフォームコピー前に大文字と小文字を区別するファイル名の衝突を検出する方法

大文字・小文字を区別するファイル名の衝突は、すべての相対パスを調査し、各パスを宛先の比較ルールに正規化し、同じ正規化キーを生成するパスをグループ化することで検出します。コピー前にすべてのグループを解決してください。

この事前検査は、大文字・小文字を区別するLinux共有からWindows、デフォルトのmacOSボリューム、または大文字・小文字を区別しないSMB名前空間に移動する際に不可欠です。通常のファイル数では、2つの有効なソース名が1つの宛先名を競合していることはわかりません。

ファイル名の衝突とは何か？

衝突は異なるソースパスが宛先で同一パスとして扱われると発生します。クロスプラットフォームの大文字・小文字感度の違いに関する実用的な注意は、Report.pdfとreport.pdfが異なる動作をする理由を示しますが、比較はすべてのディレクトリコンポーネントを含める必要があります。

クロスプラットフォームの競合はUnicode正規化、末尾のスペースやピリオド、予約されたデバイス名、宛先が禁止する文字も含むことがあります。macOSとLinux間のファイル名変更の原因は同じパス互換性監査に含まれます。

スキャン前にターゲットを定義してください。ext4、NTFS、またはSMBバックのデータセットへのコピーは異なる名前付け動作を示すことがあります。これはクライアント間でSMBの動作が異なる理由に関連しています。

どの衝突タイプを事前検査レポートに含めるべきか？

修正が予測可能になるように衝突の種類を分けます。大文字・小文字のみのペアは通常名前を変更できますが、予約されたWindows名は名前変更とアプリケーション参照の更新が必要な場合があります。

レポートは元のバイトレベルのパスを保持し、読みやすい形式で表示すべきです。視覚的に同一のUnicode名は、2つの異なるソースエントリではなく重複行のように見えることがあります。

信頼できるソースインベントリはどのように構築しますか？

インベントリはソースファイルシステム上か、移行に使うのと同じプロトコルで実行してください。スペース、タブ、改行、非ASCII文字を安全に扱う形式で相対パスをエクスポートします。

ディレクトリも含めてください。衝突するディレクトリ名は数千の影響を受けるファイルを隠すことがあります。オブジェクトタイプ、サイズ、変更時間、利用可能な場合は安定した識別子を記録し、名前変更された項目を追跡できるようにします。

最終スキャンの前に書き込みを凍結するかスナップショットを取得してください。インベントリとコピーの間で名前が変わると、移行開始前にクリーンな事前チェックが古くなる可能性があります。

比較のためにパスはどのように正規化すべきですか？

宛先の大文字小文字の折りたたみ動作から始めます。元のパスを保持しつつ、小文字または折りたたみ済みキーで比較します。この段階でソースを自動的にリネームしないでください。

次に、宛先固有のルールを追加します：Unicode正規化、区切り文字の処理、禁止文字、トリムされたサフィックス、パス長制限、予約名。宛先よりも厳しく正規化すると誤検知が生じ、緩すぎると破壊的な衝突を見逃します。

すべてのパスコンポーネントに正規化を適用します。異なるベース名の2つのファイルでも、親ディレクトリが同じ正規化パスに収束すると衝突します。

Linux、macOS、またはWindowsで何が実行できますか？

LinuxやmacOSでは、スクリプトがヌル区切りのパスを読み取り、宛先キーを計算し、そのキーでソートして、元のパスが複数あるグループを報告できます。同じ名前の重複ファイルを見つける方法がグループ化のロジックを示していますが、多言語混在のアーカイブでは明示的なUnicode処理が必要です。

find /source -print0 | python3 collision_scan.py --target windows

Windowsでは、PowerShellが相対パスを列挙し、序数の大文字小文字を区別しない比較子を使ってグループ化できます。すべての対象ディレクトリを参照できるアカウントでソース共有に対して実行してください。

Get-ChildItem -LiteralPath '\\NAS\Source' -Recurse -Force |
  ForEach-Object { $_.FullName.Substring($root.Length).ToLowerInvariant() } |
  Group-Object | Where-Object Count -gt 1

これらの例はグルーピングモデルを示しており、普遍的なスキャナーではありません。実運用のチェックは元を保持し、アクセス不能なパスを処理し、ターゲットの完全な命名ルールを実装する必要があります。

衝突グループはどのように解決すべきですか？

データ所有者と共に正規名を選び、他のパスはプロジェクトコード、日付、ソースシステムタグなどの決定論的な接尾辞でリネームしてください。一貫したホームサーバー命名ルールは任意の接尾辞を避けるのに役立ちます。

1. 衝突グループとその所有部門またはアプリケーションをエクスポートしてください。
2. 正書法を保持するパスを選択してください。
3. ソースまたはステージングコピー内で衝突するパスをリネームしてください。
4. それらを参照するプレイリスト、データベース、ショートカット、スクリプト、マニフェストを更新してください。
5. ブロックするグループがなくなるまで完全スキャンを再実行してください。

コピー ツールに上書き順で静かに決定させてはいけません。両方のファイル内容が同一でも、名前を静かに潰すことは元の名前空間に関する証拠を破壊します。

コピーがパスを潰していないことをどう検証しますか？

修正後にコピー前のマニフェストを取得し、同じ相対パスルールで宛先マニフェストを生成します。正規化されたパスセット、オブジェクト数、サイズ、重要ファイルの内容ハッシュを比較してください。

「すでに存在する」「リネーム」「スキップ」「無効な名前」「上書き」などのコピーログを確認してください。ツールによってはスキップされたパスでもゼロの終了コードが返されることがあります。

ユーザーがアプリケーションの動作を検証するまで、ソースは読み取り専用のままにしてください。名前空間の互換性にはリンクや参照も含まれ、単にファイルのバイトが存在するだけではありません。

よくある質問

Linux上で大文字小文字だけが異なる2つのファイル名は共存できますか？

一般的な大文字小文字を区別するLinuxファイルシステムでは通常は安全です。ただし、大文字小文字を区別しない宛先にコピーしたり、異なる設定のサービスを通じて公開すると衝突する可能性があります。

すべてのファイル名を小文字に変換するのは安全な修正ですか？

いいえ。一括小文字化は新たな衝突を生み、参照を壊す可能性があります。まずグループを検出し、その後にレビュー済みの決定論的なリネームを適用してください。

チェックサムはファイル名の衝突を検出しますか？

チェックサムは名前空間の識別ではなく内容を比較します。異なる2つのパスは異なる内容または同一内容であっても、1つの宛先名を競合する可能性があります。

安全なクロスプラットフォームコピーは、すべてのソースパスが一意で有効な宛先パスにマッピングされることを証明します。転送前にその証明を行い、上書きされたファイルによる衝突を発見するのではなく防ぎます。