WindowsでPYTHONPATHを恒久的に編集する方法【Anaconda3・Python 3.7対応】

この記事にたどり着いたということは、おそらく以下の環境をお使いではないでしょうか。

1. Windows 10以降のOS
2. Python 3.3以降
3. Anaconda3

そして、PYTHONPATHを恒久的（永続的）に編集したいと考えていることでしょう。本記事では、その具体的な手順をわかりやすく解説します。

手順の概要（TL;DR）

1. C:\Users\<ユーザー名>\Anaconda3\Lib\site-packages フォルダへ移動します。
2. python37.pth という名前のファイルを作成します。
3. ファイル内に C:\\Users\\<ユーザー名>\\my_module という行を追記します。

詳細な解説

はじめに

多くの場合、設定画面（GUI）からPYTHONPATHを編集すれば十分です。その方法については、Stack Overflowなどで丁寧に解説されています。
また、一時的に（そのセッションだけで）パスを変更したいだけであれば、コマンドで都度パスを追加する方法でも対応可能です。

手順1の補足：フォルダが見つからない場合

C:\Users\<ユーザー名>\Anaconda3\Lib\site-packages が存在しない場合は、C:\Users\<ユーザー名> の部分を、実際にAnaconda3がインストールされているパスに置き換えてください。

手順2の補足：.pthファイルの作成方法

Python 3.7を使用している場合は python37.pth というファイルを作成します。それ以外のバージョンの場合は、使用中のバージョンに合わせて python<XX>.pth という形式のファイル名にしてください。

• 自分のPythonバージョンがわからない場合：
  C:\Users\<ユーザー名>\Anaconda3\ 内で python<XX>.dll という形式のファイルを探してみてください。この <XX> の部分が、.pthファイルの命名に必要なバージョン番号です。
• Windowsの仕様上、.pth拡張子のファイルが作成できない場合：
  C:\Users\<ユーザー名>\Anaconda3\Lib\site-packages フォルダにはすでに .pth ファイルが存在します。いずれかをコピーし、ファイル名の先頭部分を書き換えるだけでOKです。
• 「.pth」ではなく「._pth」ファイルを作るべきという情報を見かけたら？
  ._pth ファイルは既存のパスを完全に置き換えてしまう点に注意が必要です。一方、.pth ファイルは既存のパスに内容を追加します。目的に応じて正しく使い分けましょう。

手順3の補足：.pthファイルへの記述方法

たとえば、インポートしたい SuperCoolClass が次の場所にあるとします。
C:\Users\<ユーザー名>\my_project_folder\my_awesome_file.py

この場合、新しく作成した python<XX>.pth ファイルをお好みのテキストエディタで開き、次の1行を追加します。
C:\\Users\\<ユーザー名>\\my_project_folder

• パスの区切りは、あの厄介な二重のバックスラッシュ「\\」で記述してください。
• 引用符「""」は不要です。付けないようにしましょう。

以上で設定は完了です。
以降は、どこからでも通常どおりインポートできるようになります。

from my_awesome_file import SuperCoolClass

おわりに

特筆すべき補足事項はありませんが、筆者が2時間悩んだ末に得た知識を、さらに1時間かけてこの記事としてまとめました。その時間が、読者の皆さんの貴重な時間の節約につながれば幸いです。