Pythonバイブコーディング講座 — 補足記事
「path too long」エラーが出た場合の対処法
Windowsは従来、ファイルパスの長さを260文字以内に制限する仕様になっています。Pythonライブラリをインストールしたとき、または仮想環境を作ったときに「path too long」「FileNotFoundError」「The filename or extension is too long」のようなエラーが出る場合は、この制限が原因です。本ページでは Windows のロングパス機能を有効化する手順を解説します。Mac・Linux では発生しない問題です。
次のようなエラーメッセージが出た場合、ロングパス問題の可能性が高いです。
ERROR: Could not install packages due to an OSError:
[Errno 2] No such file or directory:
'C:\\Users\\...\\.venv\\Lib\\site-packages\\...\\very_long_filename.py'
特に、フォルダをデスクトップやOneDrive配下のような階層が深い場所に作っている場合、ライブラリ内部の長いファイル名と組み合わさって260文字を超えてしまい、エラーになります。
Windows 10（バージョン1607以降）と Windows 11 では、設定変更でこの制限を解除できます。一番簡単なのは PowerShell を 管理者権限 で開いて1コマンド実行する方法です。
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
-Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
実行後、PCを再起動してください。再起動後、再度 pip install を試すとエラーが出なくなっているはずです。
このコマンドは Windows のレジストリ設定を1つ書き換えるだけで、システムの安定性に悪影響を与えません。Microsoft 公式が推奨している正規の対処法です。
管理者権限が使えない場合（会社・大学PCで権限制限されているなど）は、プロジェクトフォルダをパスが短い場所に移動するのが効果的です。
C:\Users\長い名前\OneDrive\デスクトップ\研究\2026\... のように深い階層C:\dev\my_first_analysis や C:\work\my_first_analysis のような浅い階層
Cドライブ直下に dev や work といったフォルダを新しく作って、そこにプロジェクトフォルダを置きましょう。これだけでロングパス問題はほぼ解消します。
OneDriveの同期対象フォルダにプロジェクトを置いていると、パスが伸びるだけでなく、仮想環境がOneDrive同期と競合する不具合も起きやすくなります。研究プロジェクトはOneDrive外のローカルフォルダに置くことをおすすめします。
Pythonをこれからインストールする場合、インストーラの最後の画面に 「Disable path length limit」 というボタンが表示されることがあります。このボタンをクリックするだけでロングパスが有効化されます（管理者権限の確認ダイアログが出ます）。
すでにPythonをインストール済みの方は、python.org/downloads から再度インストーラをダウンロードしてください。「Modify」を選び、最後の画面でこのボタンを押すこともできます。
対処が完了したら、Part 2 で行った pip install pandas openpyxl などのコマンドを再度試してください。エラーが出ずに「Successfully installed ...」と表示されればOKです。
以上の対処をしてもエラーが続く場合は、エラーメッセージ全文をChatGPTやClaudeに貼り付けて相談してください。OS バージョンや環境ごとに細かい違いがあるため、LLMにケース別の追加対処を聞くのが一番早いことが多いです。