Windows のパスが長すぎる：短いインストール先と長いパスへの対応を区別する

対象範囲と症状

展開、Git チェックアウト、ノードのビルドは、長いパスが原因で失敗する場合があります。システム設定を変更したり、既存の Python 環境を移動したりする前に、失敗したツールを特定してください。

検索の手掛かりとなる断片です。表現や状況は環境によって異なります。

File name too long
WinError 206

出典から確認できること

Microsoft のファイルパス資料によると、長いパスの動作はシステム設定とアプリケーションの対応状況の両方によって決まります。LongPathsEnabled は、すべてのアーカイブツール、ネイティブ拡張、古い実行ファイルに適用される共通スイッチではありません。V04-WINPATH（英語）

区別すべき状況

1. 新しいインストールで、ノード自体のフォルダーに到達するまでに、ダウンロード先やアーカイブを包む余分なフォルダーが積み重なっている。

2. 既存のインストールは動作しているが、特定のチェックアウトやビルドで、より深い階層のパスが作られている。

3. システム設定はすでに有効だが、処理を行うプログラムが必要な動作に対応していない。

推奨する確認手順

この手順は編集上の案内であり、お使いのマシンの診断結果ではありません。

手順 1. 正確なエラー、失敗したパス、実行ファイルを記録します。報告を共有する前に、個人情報を含むパスの部分を伏せます。展開、チェックアウト、コンパイルを分けて確認します。

手順 2. 新規で未使用のインストールなら、書き込み可能な短い専用フォルダーを選び、検証済みのアーカイブを改めて展開します。動作中のインストールには手を加えません。

手順 3. 新しいチェックアウト、展開、ビルドのうち一つだけが失敗する場合は、そのツールが対応する、短く書き込み可能な別の場所で処理を試します。動作中のインストールは維持します。インストール先のルート自体を変更する必要がある場合は、まずワークフローと設定をバックアップし、宣言された依存関係から短いパスの環境を再作成して、サポートされる外部モデルパスを通じて重みを再接続します。Python の仮想環境は、一般に移動できません。Python venv（英語）

手順 4. 長いパスへの対応が必要な場合は、権限を持つ管理者に Microsoft の要件とアプリケーションの対応状況を確認してもらいます。影響を受けたプロセスを再起動し、失敗した処理だけを再度実行します。

完了の確認

以前失敗したファイルを作成するか、チェックアウトできるようになり、できあがった環境が意図した起動方法で起動します。新しいフォルダーが作成されただけでは、展開の完了を証明できません。

制限と注意点

アクセス拒否、ディスク容量不足、アーカイブの破損は、それぞれ別に調査する必要があります。管理対象デバイスのポリシーは、自分で変更できない場合があります。すべてのカスタムノードを管理者として実行しても、原因の診断にはなりません。

出典と英語原文の確認日：2026-09-27。インストール、チェックアウト、GPU 推論、お使いの環境の修復は実行していません。

参照した原文資料

• Microsoft：最大ファイルパスの制限（英語）（確認日：2026-09-27）
• Python：venv の作成と移植できない性質（英語）（確認日：2026-09-27）

関連ガイド

• モデルまたは実行環境のダウンロード失敗：通信、アクセス、完全性、ストレージを切り分ける
• ComfyUI の修復記録を再現可能な形で残し、秘密情報を公開しない