知識マップ: MAX_PATHとWindowsのパス・ファイル名の落とし穴 ── 260文字制限、予約名、末尾ドット、大文字小文字

記事「MAX_PATHとWindowsのパス・ファイル名の落とし穴 ── 260文字制限、予約名、末尾ドット、大文字小文字」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

MAX_PATH=260という制限はドライブ文字・コロン・バックスラッシュ・最大256文字のパス文字列・終端NULを合わせたWin32 API側の制限であり、NTFS自体はより長いパスを扱えるため、LongPathsEnabledとlongPathAwareを両方設定するか\?\プレフィックスを使えば260文字の壁を越えられるが、Explorerを含め長パス非対応アプリは現実に残る。.NET(Core)/.NET 5以降は長いパスを暗黙に扱うのに対し、古い.NET Frameworkは260文字超過でPathTooLongExceptionを投げる。ファイル名にはCONやNULなどの予約デバイス名が拡張子付きでも使えず、末尾のスペースやドットは正規化で黙って取り除かれるため、ユーザー入力からのファイル名生成はこれらを自前でサニタイズする必要がある。Path.Combineはルート付き引数で前段のベースパスを黙って捨てるため、ベースディレクトリ配下かの検証と組み合わせる。

flowchart LR
    accTitle: MAX_PATHとファイル名の落とし穴の知識マップ
    accDescr: 260文字のMAX_PATH制限がWin32 APIの制限でありNTFS自体の限界ではないこと、長パスの有効化や\?\プレフィックスによる回避条件、予約デバイス名や末尾ドット・スペースの正規化によるファイル名の落とし穴、Path.Combineの仕様に起因するリスクとその対策の関係を示す図
    max_path["MAX_PATH(260文字制限)"]
    reserved_device_name["予約デバイス名(CON/NUL等)"]
    path_normalization["パス正規化(末尾ドット・スペースの除去)"]
    long_path_enable["長パスの有効化(LongPathsEnabled+longPathAware)"]
    long_path_prefix["\\?\プレフィックス"]
    path_too_long_exception["PathTooLongException"]
    dotnet[".NET(Core以降)"]
    dotnet_framework[".NET Framework"]
    path_combine["Path.Combineのルート付き引数仕様"]
    directory_traversal_risk["意図した保存フォルダー外への書き込み"]
    path_containment_check["ベースディレクトリ配下チェック"]
    filename_sanitization["ファイル名のサニタイズ"]
    filename_case_handling["大文字小文字の保持と非区別"]
    fsutil["fsutil"]
    case_sensitivity_side_effect["大文字小文字区別有効化の副作用"]
    eight_dot_three_name["8.3短縮名"]
    ntfs["NTFS"]
    path_component_limit["パスコンポーネントの長さ上限(255文字)"]
    long_path_enable -->|"軽減する"| max_path
    long_path_prefix -.->|"軽減する"| max_path
    max_path -.->|"原因になり得る"| path_too_long_exception
    dotnet -.->|"防止する"| path_too_long_exception
    dotnet_framework -.->|"原因になり得る"| path_too_long_exception
    dotnet_framework -.->|"前提とする"| long_path_enable
    path_combine -.->|"原因になり得る"| directory_traversal_risk
    path_containment_check -->|"軽減する"| directory_traversal_risk
    filename_sanitization -->|"防止する"| reserved_device_name
    filename_sanitization -->|"軽減する"| path_normalization
    long_path_prefix -->|"軽減する"| path_normalization
    filename_case_handling -->|"で構成できる"| fsutil
    filename_case_handling -.->|"原因になり得る"| case_sensitivity_side_effect
    eight_dot_three_name -.->|"軽減する"| max_path
    ntfs -.->|"利用する"| eight_dot_three_name
    ntfs -->|"前提とする"| path_component_limit
    filename_sanitization -->|"前提とする"| path_component_limit
    ntfs -->|"実装を担う"| filename_case_handling
    path_containment_check -->|"前提とする"| path_normalization

概念間の関係(全19件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

• 長パスの有効化(LongPathsEnabled+longPathAware)はMAX_PATH(260文字制限)を軽減します。Windows 10 1607以降でレジストリのLongPathsEnabled=1とアプリマニフェストのlongPathAwareの両方を設定すると、多くのWin32ファイル関数でMAX_PATHの260文字制限が外れる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• \?\プレフィックスはMAX_PATH(260文字制限)を軽減します。パス文字列の先頭に\\?\を付けると正規化がスキップされてそのままファイルシステムへ渡され、MAX_PATHの制限を超えられる(相対パスやUnicode版以外のAPIには使えない) / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• MAX_PATH(260文字制限)はPathTooLongExceptionの原因になることがあります。旧来の.NET Frameworkではフルパスが260文字以上になるとSystem.IO.PathTooLongExceptionが投げられていた / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• .NET(Core以降)はPathTooLongExceptionを防ぎます。.NET(Core)/.NET 5以降のランタイムはMAX_PATHチェックを行わないため、260文字超過を理由とするPathTooLongExceptionは投げられない。ただしOSやファイルシステムが定める上限を超えた場合は、この例外や同等のOSエラーが依然として発生し得る / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• .NET FrameworkはPathTooLongExceptionの原因になることがあります。.NET Frameworkは4.6.2未満をターゲットにすると260文字超過でPathTooLongExceptionが投げられる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• .NET Frameworkは長パスの有効化(LongPathsEnabled+longPathAware)を前提とします。.NET Frameworkアプリが実務で長パスを通すには、ランタイム側のターゲット変更(4.6.2以降)に加えてOS側のLongPathsEnabledとマニフェストのlongPathAwareの併用が必要になる(長いパスを扱う必要がある場合に限る。長パスを使わないアプリでは不要) / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• Path.Combineのルート付き引数仕様は意図した保存フォルダー外への書き込みの原因になることがあります。Path.Combineは2番目以降の引数にルート付きパスが渡されるとそれより前の引数を無視するため、ユーザー入力をそのまま渡すと意図した保存フォルダーの外へ書き込む脆弱性になり得る / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• ベースディレクトリ配下チェックは意図した保存フォルダー外への書き込みを軽減します。ベース側も正規化したうえで相対パスに変換し、..への脱出や別ドライブ・UNCへの脱出を検知して弾く実装が対策になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ファイル名のサニタイズは予約デバイス名(CON/NUL等)を防ぎます。ユーザー入力からファイル名を組み立てる際、GetInvalidFileNameCharsに加えて予約デバイス名と末尾ドット・スペースを自前でチェックし接頭辞を付けることで、予約名としての解釈を防げる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ファイル名のサニタイズはパス正規化(末尾ドット・スペースの除去)を軽減します。末尾のスペース・ドットをTrimEndで事前に取り除くことで、正規化によって黙って名前が変わる事故を避けられる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• \?\プレフィックスはパス正規化(末尾ドット・スペースの除去)を軽減します。\\?\プレフィックスは正規化をスキップしてファイルシステムへそのまま渡すため、末尾がドットやスペースの名前(hidden.など)にもアクセスできる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 大文字小文字の保持と非区別はfsutilで構成できます。fsutil.exe file setCaseSensitiveInfoで、ディレクトリ単位で大文字小文字の区別を有効化・確認できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 大文字小文字の保持と非区別は大文字小文字区別有効化の副作用の原因になることがあります。NTFSのディレクトリ単位の大文字小文字区別を有効化すると、大文字小文字非区別を仮定するWindowsアプリがファイルにアクセスできなくなることがある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• 8.3短縮名はMAX_PATH(260文字制限)を軽減します。8.3短縮名でパス中のフォルダー名を短く指定すると、MAX_PATHの上限に触れて開けないパスを詰める応急処置になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• NTFSは8.3短縮名を利用します。8.3短縮名の生成が無効化されていない既定の設定では、NTFSは歴史的互換性のため長いファイル名に対して8.3短縮名を自動生成する(ボリューム単位で無効化されている場合は生成されない) / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• NTFSはパスコンポーネントの長さ上限(255文字)を前提とします。NTFSではパスを構成する個々のコンポーネント(1つのフォルダー名・ファイル名)の上限は一般に255文字である / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ファイル名のサニタイズはパスコンポーネントの長さ上限(255文字)を前提とします。ファイル名1要素の長さ上限(通常255文字)に収まるよう、切り詰め処理でコンポーネント長を考慮する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• NTFSは大文字小文字の保持と非区別の実装を担います。Windowsファイルシステムの既定である「保持するが区別しない」大文字小文字の扱いはNTFS自身の動作であり、NTFSはPOSIX的な大文字小文字の区別も(既定では無効だが)サポートしている / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• ベースディレクトリ配下チェックはパス正規化(末尾ドット・スペースの除去)を前提とします。ベースディレクトリ配下チェックはPath.GetFullPathによるパス正規化を経て絶対パス化した結果に対して行う必要があり、正規化を経ずに文字列比較すると判定が崩れる / 確度: 確立した関係 / 確認日: 2026-08-01 出典

主要概念の定義

MAX_PATH(260文字制限)

Win32 APIにおけるパスの最大長で、ドライブ文字・コロン・バックスラッシュ・最大256文字のパス文字列・終端NULを合わせた260文字という制限。

予約デバイス名(CON/NUL等)

CON、PRN、AUX、NUL、COM1〜COM9、LPT1〜LPT9などMS-DOS時代から続くデバイスの予約名で、拡張子を付けてもファイルではなくデバイスとして解釈される名前。

パス正規化(末尾ドット・スペースの除去)

Windowsのパス解決処理の一部で、パスが区切り文字で終わらない場合に末尾のドットとスペースをすべて取り除く規則。

長パスの有効化(LongPathsEnabled+longPathAware)

Windows 10 バージョン1607以降で、レジストリ値LongPathsEnabled=1とアプリケーションマニフェストのlongPathAware要素の両方を設定することで、多くのWin32ファイル関数からMAX_PATH制限を外せる仕組み。

\\?\プレフィックス

パス文字列の先頭に付けることで文字列の正規化と解析をスキップし、Unicode版APIでMAX_PATHを超えるパスをそのままファイルシステムへ渡せるようにする表記。

.NET(Core以降)

.NET Frameworkの後継となる、クロスプラットフォーム対応の.NETランタイム(.NET 5以降)。

.NET Framework

Windowsのコンポーネントとして扱われ、インストールされているOSのライフサイクルに沿ってサポートされるランタイム。System.Messagingの対象範囲。

Path.Combineのルート付き引数仕様

Path.Combineメソッドで2番目以降の引数にルート付きパスが渡されると、それより前の引数がすべて無視される.NETの仕様。

ベースディレクトリ配下チェック

Path.GetFullPathで正規化した結果がベースディレクトリ配下かどうかを検証する手法。

ファイル名のサニタイズ

GetInvalidFileNameCharsによる不正文字の置換に加え、予約デバイス名・末尾のドットやスペース・長さ上限を自前でチェックして安全なファイル名に直す処理。

大文字小文字の保持と非区別

作成時の大文字小文字を保持して表示するが、検索・比較では大文字小文字を区別しないWindowsファイルシステムの既定動作。

8.3短縮名

歴史的互換性のためNTFSが長いファイル名に対して自動生成できる、REPORT~1.DOCのような形式の短縮名。

NTFS

現行のWindowsが標準で使うファイルシステム。MFT(マスターファイルテーブル)などの構造でボリューム上のファイルを管理する。

機械可読データ

• JSON-LD / Turtle ── この記事の知識グラフ全体
• 概念一覧 / 語彙(述語)の定義

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。