【Python】パス(path)を追加する方法

公開：2025年3月6日更新：2026年4月6日

CodeCampが提供するDX人材育成が可能なプログラミングやITが学べる公開講座

Pythonでパス(path)を追加する基本的な方法
環境変数PYTHONPATHを使用したパス(path)を追加する方法
sys.path.insert()を使用した優先度の高いパス(path)を追加する方法

Pythonでパス(path)を追加する基本的な方法

Pythonでパスを追加するには、主にsys.path.append()メソッドを使用します。sys.path.append()メソッドによって、Pythonが検索するモジュールやパッケージのディレクトリリストにパスを追加することが可能です。以下のサンプルコードでは、カレントディレクトリと親ディレクトリをパスに追加する方法を示しています。

【サンプルコード】
import sys
import os

# カレントディレクトリを追加
current_dir = os.getcwd()
if current_dir not in sys.path:
    sys.path.append(current_dir)

# 親ディレクトリを追加
parent_dir = os.path.dirname(current_dir)
if parent_dir not in sys.path:
    sys.path.append(parent_dir)

# 追加されたパスを確認
print(sys.path)

【実行結果】
['/home/user/python', '/usr/lib/python3.9', '/usr/lib/python3.9/lib-dynload', '/home/user/.local/lib/python3.9/site-packages', '/usr/local/lib/python3.9/dist-packages', '/usr/lib/python3/dist-packages', '/home/user/python', '/home/user']

sys.path.append()メソッドは、指定したパスをPythonの検索パスリストの末尾に追加します。末尾に追加することによって、追加したディレクトリ内のモジュールやパッケージをインポートできるようになります。ただし、この方法で追加したパスは現在のPythonセッションでのみ有効であることに注意が必要です。

Python研修一覧はこちら

目的に合うPython研修を一覧形式から探したい方は、ぜひご利用ください。

Python研修を比較する

Java研修一覧はこちら

目的に合うJava研修を一覧形式から探したい方は、ぜひご利用ください。

Java研修を比較する

PHP研修一覧はこちら

目的に合うPHP研修を一覧形式から探したい方は、ぜひご利用ください。

PHP研修を比較する

新入社員研修

目的に合う新入社員研修を一覧形式から探したい方は、ぜひご利用ください。

新入社員研修を比較する

全ての研修からも探したい方はこちら

環境変数PYTHONPATHを使用したパス(path)を追加する方法

環境変数PYTHONPATHを設定することによってPythonのパスを永続的に追加できます。この方法はシステム全体でパスを共有する場合や複数のプロジェクトで同じパスを使用する場合に適しています。以下のサンプルコードでは、Pythonスクリプト内でPYTHONPATHを設定する方法を示しています。

【サンプルコード】
import os
import sys

# 新しいパスを設定
new_path = "/path/to/your/module"

# 既存のPYTHONPATHに新しいパスを追加（重複確認あり）
if 'PYTHONPATH' in os.environ:
    paths = os.environ['PYTHONPATH'].split(os.pathsep)
    if new_path not in paths:
        os.environ['PYTHONPATH'] = new_path + os.pathsep + os.environ['PYTHONPATH']
else:
    os.environ['PYTHONPATH'] = new_path

# 設定されたPYTHONPATHを確認
print(os.environ['PYTHONPATH'])

# 実際にsys.pathに反映されていることを確認
print(sys.path)

【実行結果】
/path/to/your/module:/existing/python/path
['/home/user/python', '/path/to/your/module', '/usr/lib/python3.9', ...]

上記のサンプルコードでは、os.environディクショナリを使用してPYTHONPATH環境変数を操作しています。新しいパスを既存のPYTHONPATHの先頭に追加することによって、そのパスが優先的に検索されるようになります。ただし、このスクリプトで設定したPYTHONPATHは、スクリプトの実行中のみ有効であることに留意してください。

sys.path.insert()を使用した優先度の高いパス(path)を追加する方法

sys.path.insert()メソッドを使用することによって、指定したインデックスにパスを挿入できる為、特定のパスを検索順序の最優先に設定することが可能です。以下のサンプルコードでは、複数のパスを追加し、その優先順位を制御する方法を示しています。

【サンプルコード】
import sys

# パスを追加する前に重複確認をする関数
def add_path_if_not_exists(index, path):
    if path not in sys.path:
        if index < len(sys.path):
            sys.path.insert(index, path)
        else:
            sys.path.append(path)

# 最優先で検索されるパスを追加
add_path_if_not_exists(0, '/path/to/high/priority')

# 2番目に優先されるパスを追加
add_path_if_not_exists(1, '/path/to/medium/priority')

# 最後に検索されるパスを追加
add_path_if_not_exists(len(sys.path), '/path/to/low/priority')

# 追加されたパスを確認
print(sys.path)

【実行結果】
['/path/to/high/priority', '/path/to/medium/priority', '/usr/lib/python3.9', '/usr/lib/python3.9/lib-dynload', '/home/user/.local/lib/python3.9/site-packages', '/usr/local/lib/python3.9/dist-packages', '/usr/lib/python3/dist-packages', '/path/to/low/priority']

sys.path.insert()メソッドの第一引数には挿入位置のインデックスを指定します。0を指定することによって、そのパスが最優先で検索されます。

特定のモジュールやパッケージを優先的にインポートすることが可能ですが、システムのデフォルトパスよりも優先度を上げることによって、予期せぬ動作を引き起こす可能性があることに注意が必要です。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。