Pythonで現在のディレクトリを取得・変更・一覧表示する方法【完全ガイド】

1. はじめに

Pythonでカレントディレクトリを操作するメリット

1. ファイルの読み書きがスムーズになる

2. 相対パスと絶対パスを適切に使い分けられる

3. プロジェクトの管理が簡単になる

この記事で学べること

• カレントディレクトリとは何か？
• カレントディレクトリの取得方法
• カレントディレクトリの変更方法
• カレントディレクトリ内のファイル一覧を取得する方法
• Pythonスクリプトが配置されているディレクトリを取得する方法
• よくある疑問（FAQ）とその解決策

まとめ

2. カレントディレクトリとは？

カレントディレクトリとは？

file_path = "data/sample.txt"

with open(file_path, "r") as file:
    content = file.read()

カレントディレクトリの役割

1. 相対パスの基準になる

• 相対パス：カレントディレクトリを基準としたパス 例: data/sample.txt（現在のディレクトリにある data フォルダ内の sample.txt にアクセス）
• 絶対パス：ルートディレクトリからの完全なパス 例: C:/Users/username/project/data/sample.txt（Windows） 例: /home/user/project/data/sample.txt（Linux・Mac）

2. スクリプトの実行環境を管理できる

3. プロジェクトの管理が容易になる

/home/user/project/
    ├── main.py  # 実行スクリプト
    ├── data/
    │   ├── sample.csv
    │   └── config.json
    ├── logs/
    │   ├── app.log
    └── src/
        ├── module1.py
        ├── module2.py

カレントディレクトリの確認方法

import os

current_directory = os.getcwd()
print("現在のカレントディレクトリ:", current_directory)

from pathlib import Path

current_directory = Path.cwd()
print("現在のカレントディレクトリ:", current_directory)

まとめ

• カレントディレクトリとは、Pythonスクリプトが基準とするフォルダのこと。
• 相対パスと絶対パスの違いを理解し、適切に使い分けることが重要。
• スクリプトの実行環境によってカレントディレクトリが変わるため、意識して管理する必要がある。
• os.getcwd() または Path.cwd() を使えば、現在のカレントディレクトリを確認できる。

Ad

3. カレントディレクトリの取得方法

カレントディレクトリの取得とは？

file_path = "data/sample.txt"

with open(file_path, "r") as file:
    content = file.read()

1. os モジュールを使ったカレントディレクトリの取得

✅ os.getcwd() を使う

import os

current_directory = os.getcwd()
print("現在のカレントディレクトリ:", current_directory)

✅ 出力例（Windows）

現在のカレントディレクトリ: C:\Users\username\project

✅ 出力例（Mac/Linux）

現在のカレントディレクトリ: /home/user/project

• os.getcwd() は 絶対パス（フルパス） を返すため、カレントディレクトリの確認がしやすい。
• Pythonの標準ライブラリ os に含まれているので、追加のインストールは不要。

2. pathlib モジュールを使ったカレントディレクトリの取得

✅ Path.cwd() を使う

from pathlib import Path

current_directory = Path.cwd()
print("現在のカレントディレクトリ:", current_directory)

✅ 出力例

現在のカレントディレクトリ: /home/user/project

• Path.cwd() は os.getcwd() と同じように カレントディレクトリの絶対パスを返す。
• Path オブジェクトを使うと、パス操作が直感的に扱いやすくなる（Path を使ったファイル操作と組み合わせるのに便利）。
• pathlib は Python 3.4 以降で導入されたモジュールのため、Python 2 では使用不可。

3. os.getcwd() と Path.cwd() の比較

• 新規プロジェクト → Path.cwd()（推奨）
• 古いコードとの互換性が必要 → os.getcwd()

4. カレントディレクトリを取得する際の注意点

1. Jupyter Notebook では __file__ 変数が使えない

• os.getcwd() や Path.cwd() は問題なく動作するが、__file__ を使ってカレントディレクトリを取得しようとするとエラーになる。

1. コマンドラインでの実行環境によってカレントディレクトリが異なる

• Pythonスクリプトをどの環境で実行するかによってカレントディレクトリが異なる場合がある。
• 例えば、VSCodeのターミナルとWindowsのコマンドプロンプトではカレントディレクトリが異なる可能性がある。

1. os.chdir() で変更すると os.getcwd() の値が変わる

• カレントディレクトリを変更すると、以降の os.getcwd() の結果が変わるため、意図しない動作を避けるために注意が必要。

まとめ

• Pythonでカレントディレクトリを取得する方法は、os.getcwd() と Path.cwd() の2つがある。
• 従来の os.getcwd() はシンプルで使いやすく、互換性が高い。
• Path.cwd() は pathlib モジュールの一部で、オブジェクト指向のパス操作に適している。
• 新しいプロジェクトでは Path.cwd() を推奨。
• Jupyter Notebook や異なる実行環境での挙動の違いに注意が必要。

4. カレントディレクトリの変更方法

1. os.chdir() を使ったカレントディレクトリの変更

✅ os.chdir() の基本的な使い方

import os

# 現在のカレントディレクトリを表示
print("変更前のカレントディレクトリ:", os.getcwd())

# カレントディレクトリを変更
os.chdir("/path/to/new/directory")  # 変更するディレクトリを指定

# 変更後のカレントディレクトリを表示
print("変更後のカレントディレクトリ:", os.getcwd())

✅ 実行結果（変更前後の確認）

変更前のカレントディレクトリ: /home/user/project
変更後のカレントディレクトリ: /home/user/project/new_folder

• os.chdir("パス") を使うと、スクリプトの実行中の作業ディレクトリを変更できる。
• 変更後は、すべての相対パスが 新しいカレントディレクトリを基準 に処理される。

2. 絶対パスと相対パスでの os.chdir()

✅ 絶対パスを使う

os.chdir("/home/user/project/new_folder")  # Linux / Mac
os.chdir("C:\Users\username\project\new_folder")  # Windows

• フルパスを指定するため、どの環境でも確実に変更できる。
• 推奨される方法。

✅ 相対パスを使う

os.chdir("new_folder")  # カレントディレクトリ内の "new_folder" に移動
os.chdir("../")  # 1つ上のディレクトリに移動
os.chdir("../../")  # 2つ上のディレクトリに移動

• 現在のカレントディレクトリを基準 に変更できるため、スクリプトの移植性が高くなる。
• ただし、カレントディレクトリが不明確な場合は意図しない動作をする可能性がある。

3. os.chdir() のエラーハンドリング

✅ エラーハンドリングの例

import os

new_directory = "/path/to/nonexistent/directory"

# ディレクトリが存在するか確認してから変更
if os.path.exists(new_directory):
    os.chdir(new_directory)
    print("カレントディレクトリを変更しました:", os.getcwd())
else:
    print("エラー: 指定されたディレクトリが存在しません。")

✅ 実行結果（ディレクトリが存在しない場合）

エラー: 指定されたディレクトリが存在しません。

• os.path.exists(パス) を使って、ディレクトリが存在するかどうかを事前に確認する。
• 存在しないディレクトリを指定すると、FileNotFoundError が発生 するため、例外処理を組み込むとエラーを防げる。

4. カレントディレクトリを元に戻す方法

✅ 元のカレントディレクトリを保存しておく

import os

# 現在のカレントディレクトリを保存
original_directory = os.getcwd()

# 別のディレクトリに変更
os.chdir("/path/to/new/directory")
print("変更後のカレントディレクトリ:", os.getcwd())

# 元のディレクトリに戻す
os.chdir(original_directory)
print("元のカレントディレクトリに戻しました:", os.getcwd())

✅ 実行結果

変更後のカレントディレクトリ: /home/user/new_folder
元のカレントディレクトリに戻しました: /home/user/project

• 変更前に original_directory = os.getcwd() で元のディレクトリを保存しておけば、os.chdir(original_directory) で簡単に戻せる。
• 複数のスクリプトを組み合わせて動かす場合は、戻す処理を忘れると意図しないファイル操作の原因になる ので注意。

5. os.chdir() の影響範囲に注意

✅ 例：カレントディレクトリを変更した後の問題

import os

# 別のディレクトリに変更
os.chdir("/path/to/new/directory")

# 他のスクリプトがカレントディレクトリに依存している場合
with open("config.json", "r") as file:
    config = file.read()  # 意図しないエラーが発生する可能性あり

まとめ

• os.chdir() を使うことで、カレントディレクトリを変更できる。
• 変更時には絶対パスを使うのが安全だが、相対パスも活用できる。
• エラーハンドリングを入れて、存在しないディレクトリに変更しないようにする。
• 元のカレントディレクトリを保存しておくことで、簡単に元に戻せる。
• カレントディレクトリの変更はスクリプト全体に影響するため、意図しないエラーに注意が必要。

Ad

5. カレントディレクトリ内のファイル一覧を取得する方法

1. os.listdir() を使ったファイル一覧の取得

✅ os.listdir() の基本的な使い方

import os

# カレントディレクトリ内のファイルとフォルダを取得
files_and_folders = os.listdir()

print("カレントディレクトリの内容:", files_and_folders)

✅ 実行結果（例）

カレントディレクトリの内容: ['file1.txt', 'file2.csv', 'images', 'script.py']

• os.listdir() は ファイルだけでなく、フォルダも含めて一覧を取得 する。
• 取得したリストには拡張子付きのファイル名が含まれる ため、ファイルをフィルタリングする必要がある。

2. os.listdir() でファイルのみを取得

✅ ファイルのみ取得する方法

import os

# カレントディレクトリ内のファイルのみを取得
files = [f for f in os.listdir() if os.path.isfile(f)]

print("カレントディレクトリ内のファイル:", files)

✅ 実行結果（例）

カレントディレクトリ内のファイル: ['file1.txt', 'file2.csv', 'script.py']

• os.path.isfile(f) を使って、フォルダを除外し、ファイルのみを抽出 している。
• リスト内包表記を使うことで、簡潔に記述できる。

3. os.listdir() で特定の拡張子のファイルを取得

✅ .txt ファイルのみ取得

import os

# カレントディレクトリ内の .txt ファイルのみ取得
txt_files = [f for f in os.listdir() if f.endswith('.txt')]

print(".txt ファイルの一覧:", txt_files)

✅ 実行結果（例）

.txt ファイルの一覧: ['file1.txt', 'notes.txt']

• f.endswith('.txt') を使って .txt で終わるファイルのみを抽出 している。
• '.csv' や '.log' など、他の拡張子にも応用可能。

4. pathlib を使ったファイル一覧の取得

✅ Path.iterdir() を使ったファイル一覧取得

from pathlib import Path

# カレントディレクトリ内のファイルとフォルダを取得
files_and_folders = list(Path.cwd().iterdir())

print("カレントディレクトリの内容:", files_and_folders)

✅ 実行結果（例）

カレントディレクトリの内容: [PosixPath('file1.txt'), PosixPath('file2.csv'), PosixPath('images'), PosixPath('script.py')]

• Path.cwd().iterdir() を使うと カレントディレクトリ内のアイテムを Path オブジェクトとして取得 できる。
• リスト形式に変換すると、扱いやすくなる。

5. pathlib でファイルのみを取得

✅ ファイルのみ取得する方法

from pathlib import Path

# カレントディレクトリ内のファイルのみ取得
files = [f for f in Path.cwd().iterdir() if f.is_file()]

print("カレントディレクトリ内のファイル:", files)

✅ 実行結果（例）

カレントディレクトリ内のファイル: [PosixPath('file1.txt'), PosixPath('file2.csv'), PosixPath('script.py')]

• f.is_file() を使うことで、フォルダを除外し、ファイルのみを取得 できる。
• Path オブジェクトを扱うことで、ファイルのパスを簡単に操作できる。

6. os.listdir() vs pathlib の比較

• レガシーコード → os.listdir()（シンプルで速い）
• 新しいプロジェクト → pathlib.Path().iterdir()（オブジェクト指向で使いやすい）

まとめ

• os.listdir() を使えば、カレントディレクトリ内のファイルやフォルダを簡単に取得できる。
• os.path.isfile() を使えば、フォルダを除外してファイルのみを取得可能。
• pathlib.Path().iterdir() を使えば、オブジェクト指向のパス操作ができ、より直感的にファイルを扱える。

6. 実行中のスクリプトのディレクトリを取得する方法

1. __file__ 変数を使ったスクリプトのディレクトリ取得

✅ __file__ を使った基本的な取得方法

import os

# スクリプトの絶対パスを取得
script_path = os.path.abspath(__file__)

# スクリプトが配置されているディレクトリを取得
script_directory = os.path.dirname(script_path)

print("スクリプトの絶対パス:", script_path)
print("スクリプトの配置ディレクトリ:", script_directory)

✅ 実行結果（例）

スクリプトの絶対パス: /home/user/project/script.py
スクリプトの配置ディレクトリ: /home/user/project

• __file__ 変数は、Pythonスクリプトのファイルパスを格納する特殊変数。
• os.path.abspath(__file__) を使うことで、スクリプトの絶対パスを取得 できる。
• os.path.dirname(パス) を使うことで、スクリプトの配置ディレクトリを取得 できる。

• __file__ は Jupyter Notebook では利用できない。
• __file__ はスクリプトファイルがある場合にのみ使用できるため、Jupyter Notebook 上ではエラーが発生する。
• Notebook内で実行する場合は os.getcwd() を使用する。

2. pathlib を使ったスクリプトのディレクトリ取得

✅ pathlib を使ったスクリプトディレクトリの取得

from pathlib import Path

# スクリプトの配置ディレクトリを取得
script_directory = Path(__file__).resolve().parent

print("スクリプトの配置ディレクトリ:", script_directory)

✅ 実行結果（例）

スクリプトの配置ディレクトリ: /home/user/project

• Path(__file__).resolve() は、スクリプトの絶対パスを取得する。
• .parent を使うことで、スクリプトの親ディレクトリ（配置フォルダ）を取得できる。
• オブジェクト指向で直感的に書けるため、新しいプロジェクトでは pathlib を推奨。

3. スクリプトのディレクトリをカレントディレクトリに設定する

✅ os.chdir() を使ったカレントディレクトリの変更

import os

# スクリプトの配置ディレクトリを取得
script_directory = os.path.dirname(os.path.abspath(__file__))

# カレントディレクトリをスクリプトの配置場所に設定
os.chdir(script_directory)

print("カレントディレクトリをスクリプトの配置場所に設定しました:", os.getcwd())

✅ 実行結果（例）

カレントディレクトリをスクリプトの配置場所に設定しました: /home/user/project

• os.chdir(スクリプトのディレクトリ) を使うことで、カレントディレクトリをスクリプトの配置フォルダに変更できる。
• 相対パスを使用するプログラムが、どこで実行しても正しく動作するようになる。

import os

# Jupyter Notebook の場合は `__file__` が使えないので、カレントディレクトリを直接取得
script_directory = os.getcwd()
print("Jupyter Notebook 上のカレントディレクトリ:", script_directory)

4. スクリプトのディレクトリを使用する実用例

✅ スクリプトのディレクトリを基準にファイルを開く

import os

# スクリプトの配置ディレクトリを取得
script_directory = os.path.dirname(os.path.abspath(__file__))

# データファイルのパスを設定（スクリプトと同じフォルダにある "data.txt" を開く）
file_path = os.path.join(script_directory, "data.txt")

# ファイルを開く
with open(file_path, "r") as file:
    content = file.read()

print("ファイルの内容:", content)

✅ 実行結果（例）

ファイルの内容: これはスクリプトのディレクトリ内にあるファイルの内容です。

• os.path.join(script_directory, "ファイル名") を使うことで、スクリプトの配置場所を基準にファイルを開くことができる。
• スクリプトの実行場所に関係なく、常に同じディレクトリのファイルを参照できるため、移植性が向上する。

まとめ

• スクリプトの配置ディレクトリを取得するには、__file__ を使う。
• Python 3.4 以降では pathlib.Path(__file__).resolve().parent を使うとより直感的。
• os.chdir() を使うことで、スクリプトのディレクトリをカレントディレクトリに設定できる。
• Jupyter Notebook では __file__ が使えないため、os.getcwd() を使用する。
• スクリプトのディレクトリを基準にファイルを開くことで、移植性の高いコードが書ける。

7. よくある質問（FAQ）

Q1: os.getcwd() と os.path.abspath('.') は何が違うのですか？

✅ 回答

• os.getcwd() は 現在のカレントディレクトリを絶対パスで取得 します。
• os.path.abspath('.') も現在のディレクトリを取得しますが、引数として指定されたパス（この場合は "."）の絶対パスを返します。

import os

print("os.getcwd():", os.getcwd())  
print("os.path.abspath('.'):", os.path.abspath('.'))

os.getcwd(): /home/user/project
os.path.abspath('.'): /home/user/project

• 通常のカレントディレクトリ取得には os.getcwd() を使用するのが推奨されます。

Q2: os.chdir() を使ってカレントディレクトリを変更すると、スクリプト全体に影響がありますか？

✅ 回答

• はい、os.chdir() を使うと、Pythonプロセス全体のカレントディレクトリが変更されます。
• そのため、スクリプトの途中でカレントディレクトリを変更すると、ファイルパスの解決が意図しない結果になる可能性があります。

import os

print("変更前:", os.getcwd())
os.chdir('/tmp')  # ディレクトリを変更
print("変更後:", os.getcwd())

# 変更前のディレクトリにあったファイルを開こうとするとエラーになる可能性がある
with open("config.json", "r") as file:
    content = file.read()

import os

original_directory = os.getcwd()  # 元のディレクトリを保存
os.chdir('/tmp')  # 一時的に変更

# 変更後の処理を実行

os.chdir(original_directory)  # 元のディレクトリに戻す
print("元のディレクトリに戻しました:", os.getcwd())

• 一時的にカレントディレクトリを変更する場合は、元のディレクトリを保存しておくのがベストプラクティスです。

Q3: pathlib と os、どちらを使うべきですか？

✅ 回答

• 新しいプロジェクトでは pathlib を使用するのが推奨（オブジェクト指向で書きやすい）。
• Python 2との互換性が必要なら os モジュールを使う。

Q4: os.listdir() でファイル一覧を取得すると、フォルダとファイルが混ざります。ファイルだけを取得できますか？

✅ 回答

import os

files = [f for f in os.listdir() if os.path.isfile(f)]
print("カレントディレクトリ内のファイル:", files)

from pathlib import Path

files = [f for f in Path.cwd().iterdir() if f.is_file()]
print("カレントディレクトリ内のファイル:", files)

• pathlib を使うと、より直感的なコードになるため、新しいプロジェクトでは pathlib を推奨。

Q5: __file__ を使うとエラーが出ます。なぜですか？

✅ 回答

• __file__ 変数は、Pythonスクリプトがファイルとして実行された場合にのみ使用可能 です。
• Jupyter Notebook では __file__ 変数が定義されていないため、エラーが発生します。

import os

script_directory = os.getcwd()  # カレントディレクトリを取得
print("Jupyter Notebook のディレクトリ:", script_directory)

• Jupyter Notebook では カレントディレクトリを os.getcwd() で取得する のがベストプラクティス。

Q6: os.chdir() を使わずにスクリプトのディレクトリを基準にファイルを開く方法はありますか？

✅ 回答

• os.chdir() を使うとカレントディレクトリ全体が変わってしまうため、スクリプトのディレクトリを基準にしたファイルパスを指定するのが良い方法です。

import os

script_directory = os.path.dirname(os.path.abspath(__file__))
file_path = os.path.join(script_directory, "data.txt")

with open(file_path, "r") as file:
    content = file.read()

from pathlib import Path

script_directory = Path(__file__).resolve().parent
file_path = script_directory / "data.txt"

with file_path.open("r") as file:
    content = file.read()

• Python 3.4 以降なら pathlib を使う方が直感的で扱いやすい。

まとめ

• os.getcwd() と os.path.abspath('.') の違いを理解することで、より柔軟なカレントディレクトリ操作が可能。
• os.chdir() でカレントディレクトリを変更すると、スクリプト全体に影響があるため注意が必要。
• Python 3.4以降の新しいプロジェクトでは pathlib を使うのが推奨される。
• Jupyter Notebook では __file__ が使えないため、os.getcwd() を使用する。
• スクリプトのディレクトリを基準にファイルを開くことで、移植性の高いコードが書ける。

8. まとめ

1. カレントディレクトリとは？

• カレントディレクトリ（作業ディレクトリ）とは、Pythonスクリプトが基準としているフォルダのこと。
• 相対パス はカレントディレクトリを基準に指定されるため、適切に管理しないとファイルが見つからないエラーが発生する。

2. カレントディレクトリの取得方法

import os
print(os.getcwd())  # 現在のカレントディレクトリを取得

from pathlib import Path
print(Path.cwd())  # 現在のカレントディレクトリを取得

3. カレントディレクトリの変更方法

import os
os.chdir("/new/directory")  # カレントディレクトリを変更

• カレントディレクトリを変更すると、以降のファイル操作の基準が変わるため注意が必要。
• 変更前のディレクトリを保存しておくことで、元に戻すことが可能。

original_directory = os.getcwd()
os.chdir("/new/directory")
os.chdir(original_directory)  # 元に戻す

4. カレントディレクトリ内のファイル一覧を取得

import os
print(os.listdir())  # ファイルとフォルダの一覧を取得

from pathlib import Path
print(list(Path.cwd().iterdir()))  # ファイルとフォルダの一覧を取得

• 特定の拡張子のみ取得する方法

txt_files = [f for f in Path.cwd().iterdir() if f.suffix == '.txt']
print(txt_files)  # .txtファイルのみリストアップ

5. 実行中のスクリプトのディレクトリを取得

import os
print(os.path.dirname(os.path.abspath(__file__)))  # スクリプトの配置ディレクトリを取得

from pathlib import Path
print(Path(__file__).resolve().parent)  # スクリプトの配置ディレクトリを取得

• Jupyter Notebook では __file__ が使えないため、代わりに os.getcwd() を使用する。

6. よくある質問（FAQ）のポイント

• os.getcwd() と os.path.abspath('.') はどちらもカレントディレクトリを取得するが、os.getcwd() を使うのが一般的。
• os.chdir() でディレクトリを変更するとスクリプト全体に影響があるため注意が必要。
• Python 3.4以降では pathlib の使用が推奨（オブジェクト指向で使いやすい）。
• os.listdir() で取得した一覧から ファイルのみを取得するには os.path.isfile() や Path.is_file() を使用。
• スクリプトのディレクトリを基準にファイルを開くことで、移植性の高いコードを作成可能。

7. この記事を活かす場面

• ファイル操作を伴うPythonプログラム（ログ管理、データ分析、スクレイピングなど）。
• スクリプトの移植性を高めるためのベストプラクティス。
• ディレクトリ変更による影響を理解し、適切に管理するスキルの向上。

8. 最後に

参考文献

• Python公式ドキュメント（os モジュール）
• Python公式ドキュメント（pathlib モジュール）

Ad