Pythonバイブコーディング講座 — 補足記事
Windowsの「ロングパス」問題への対処
「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文字を超えてしまい、エラーになります。
解決策A:ロングパスを有効化(推奨)
Windows 10(バージョン1607以降)と Windows 11 では、設定変更でこの制限を解除できます。いちばん簡単なのは PowerShell を 管理者権限 で開いて、コマンドを1つ実行する方法です。
- スタートメニューで「PowerShell」と検索
- 「Windows PowerShell」を 右クリック → 「管理者として実行」
- 「ユーザーアカウント制御」のダイアログで「はい」を選択
- 次のコマンドを貼り付けて、Enterキーを押す
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
-Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
実行後、PCを再起動してください。再起動したあと、もう一度 pip install を試すと、エラーが出なくなっているはずです。
このコマンドは Windows のレジストリ(設定を保存している場所)の値を1つ書き換えるだけで、システムの安定性に悪影響を与えません。Microsoft が公式に推奨している、正規の対処法です。
解決策B:プロジェクトフォルダの場所を変える
管理者権限が使えない場合(会社や大学のPCで権限が制限されているなど)は、プロジェクトフォルダをパスが短い場所に移動するのが効果的です。
- 避けたほうがよい場所:
C:\Users\長い名前\OneDrive\デスクトップ\研究\2026\...のように深い階層 - 推奨:
C:\dev\my_first_analysisやC:\work\my_first_analysisのような浅い階層
Cドライブ直下に dev や work といったフォルダを新しく作って、そこにプロジェクトフォルダを置きましょう。これだけでロングパス問題はほぼ解消します。
OneDriveで同期しているフォルダにプロジェクトを置くと、パスが長くなります。さらに、仮想環境がOneDriveの同期と競合する不具合も起きやすくなります。研究プロジェクトはOneDrive外のローカルフォルダに置くことをおすすめします。
解決策C:Pythonインストール時に有効化
Pythonをこれからインストールする場合、インストーラの最後の画面に 「Disable path length limit」 というボタンが表示されることがあります。このボタンをクリックするだけでロングパスが有効化されます(管理者権限の確認ダイアログが出ます)。
すでにPythonをインストール済みの方は、python.org/downloads から再度インストーラをダウンロードしてください。インストーラを開いて「Modify」を選ぶと、最後の画面でこのボタンを押せます。
対処後の確認
対処が完了したら、Part 2 で行った pip install pandas openpyxl などのコマンドを再度試してください。エラーが出ずに「Successfully installed ...」と表示されればOKです。
以上の対処をしてもエラーが続く場合は、エラーメッセージ全文をChatGPTやClaudeに貼り付けて相談してください。OSのバージョンや環境ごとに細かい違いがあるため、状況に合った追加の対処をLLMに聞くのがいちばん早いことが多いです。