Pythonのpathlibの使い方|Pathでファイル・フォルダーを操作する方法と注意点
Python でファイルやフォルダーを扱うとき、昔は os.path.join() や os.listdir() など、文字列を受け取る関数を組み合わせて書いていました。今は標準ライブラリの pathlib を使うと、パスを 1 つの「物」として扱えて、短く読みやすく書けます。
この記事では、Windows 11 の Python 3.12 で実際に動かした結果つきで、次のことを解説します。
Pathの作り方と、/でパスをつなぐ方法- ファイル名・拡張子・親フォルダーの取り出し方
- フォルダーの作成、一覧(glob・rglob・walk)、名前の変更と削除
- 「どこで実行しても動く」パスの書き方(
__file__を基準にする) - Windows の
\の落とし穴と、os.path との対応表
サンプルは、練習用の空のフォルダーに sample.py などの名前で保存し、PowerShell でそのフォルダーに移動してから py sample.py で実行してください。削除の例もあるので、大事なファイルがあるフォルダーでは試さないでください。
pathlib とは:パスを「文字列」ではなく「物」として扱う
パスとは、C:\Users\user\Documents\memo.txt のような、ファイルやフォルダーの場所を表す文字列のことです。pathlib は Python 3.4 から標準で入っているモジュールで、パスを Path という型の値(オブジェクト)として扱います。
文字列のままだと「ファイル名を取り出す」「存在を確かめる」「中身を読む」をそれぞれ別のモジュールの関数で行いますが、Path なら p.name・p.exists()・p.read_text() のように、すべてパスの値から呼び出せます。インストールは不要で、from pathlib import Path と書くだけで使えます。
Path の作り方と / 演算子
Path は、文字列を渡して作ります。フォルダー名とファイル名は /(割り算の記号)でつなげます。
from pathlib import Path
p = Path("data") / "2026" / "report.csv"
print(p)
print(repr(p))
print(Path("data", "2026", "report.csv"))
print(p.as_posix())
data\2026\report.csv
WindowsPath('data/2026/report.csv')
data\2026\report.csv
data/2026/report.csv
Windows で Path() を作ると WindowsPath になり、print すると区切りが \ で表示されます。Linux や Mac では PosixPath になり、区切りは / です。コードには / を書いておけば、OS に合わせて区切りを変えてくれるのが pathlib の便利な点です。as_posix() を使うと、Windows でも / 区切りの文字列が得られます(URL やログに書くときに便利です)。
ファイル名・拡張子・親フォルダーを取り出す
パスの部品は、属性(カッコを付けずに読む値)で取り出せます。
from pathlib import Path
p = Path("data") / "2026" / "report.csv"
print(p.name)
print(p.stem)
print(p.suffix)
print(p.parent)
print(p.parent.parent)
print(p.parts)
q = Path("archive.tar.gz")
print(q.suffix, q.suffixes, q.stem)
report.csv
report
.csv
data\2026
data
('data', '2026', 'report.csv')
.gz ['.tar', '.gz'] archive.tar
| 属性 | 意味 | data\2026\report.csv の場合 |
|---|---|---|
| name | 最後の部分(ファイル名) | report.csv |
| stem | name から最後の拡張子を除いたもの | report |
| suffix | 最後の拡張子(. 付き) | .csv |
| parent | 1 つ上のフォルダー | data\2026 |
| parts | 区切りごとに分けたタプル | (‘data’, ‘2026’, ‘report.csv’) |
archive.tar.gz のように拡張子が 2 つあると、suffix は最後の .gz だけで、stem は archive.tar になる点に注意してください。
部品を入れ替えた新しいパスは with_ で始まるメソッドで作れます。元の p は変わりません。
from pathlib import Path
p = Path("data") / "2026" / "report.csv"
print(p.with_suffix(".xlsx"))
print(p.with_name("summary.csv"))
print(p.with_stem("report_old"))
data\2026\report.xlsx
data\2026\summary.csv
data\2026\report_old.csv
存在の確認とフォルダーの作成:exists・mkdir
Path を作っただけでは、ファイルは作られず、実在するかどうかも調べません。実在は exists()(ファイルでもフォルダーでも True)、is_file()(ファイルなら True)、is_dir()(フォルダーなら True)で確かめます。存在しないパスでは 3 つとも False で、エラーにはなりません。
from pathlib import Path
base = Path("practice")
print(base.exists())
(base / "logs" / "2026" / "10").mkdir(parents=True, exist_ok=True)
(base / "logs" / "2026" / "10").mkdir(parents=True, exist_ok=True)
print(base.exists(), base.is_dir(), base.is_file())
try:
(base / "a" / "b").mkdir()
except FileNotFoundError as e:
print("FileNotFoundError:", e)
try:
(base / "logs").mkdir()
except FileExistsError as e:
print("FileExistsError:", e)
f = base / "memo.txt"
f.write_text("hello\n", encoding="utf-8")
print(f.exists(), f.is_file(), f.is_dir())
print(Path("nothing.txt").exists(), Path("nothing.txt").is_file())
False
True True False
FileNotFoundError: [WinError 3] 指定されたパスが見つかりません。: 'practice\\a\\b'
FileExistsError: [WinError 183] 既に存在するファイルを作成することはできません。: 'practice\\logs'
True True False
False False
mkdir() の 2 つの引数の意味は次のとおりです。
- parents=True:途中のフォルダー(practice・logs・2026)がなければ一緒に作る。省略(False)すると、親がないときに FileNotFoundError
- exist_ok=True:すでにフォルダーがあっても FileExistsError にしない。2 回目の mkdir がエラーにならなかったのはこのため
公式ドキュメントにあるとおり、この組み合わせは Linux の mkdir -p と同じ動きです。ただし、同じ名前のファイルがすでにあるときは、exist_ok=True でも FileExistsError になります。「出力先のフォルダーを用意する」ときは、まず mkdir(parents=True, exist_ok=True) と書くのが定番です。
フォルダーの中身を一覧する:iterdir・glob・rglob・walk
次のような練習用のフォルダー構成を作って、一覧の取り方を比べます。
project
├── Data.CSV
├── main.py
├── README.md
├── src
│ ├── app.py
│ ├── util.py
│ └── data
│ └── sample.csv
└── tests
└── test_app.py
from pathlib import Path
root = Path("project")
for rel in ["main.py", "README.md", "src/app.py", "src/util.py",
"src/data/sample.csv", "tests/test_app.py", "Data.CSV"]:
p = root / rel
p.parent.mkdir(parents=True, exist_ok=True)
p.write_text("x\n", encoding="utf-8")
print("--- iterdir")
for p in sorted(root.iterdir()):
print(p, "dir" if p.is_dir() else "file")
print("--- glob *.py")
for p in sorted(root.glob("*.py")):
print(p)
print("--- rglob *.py")
for p in sorted(root.rglob("*.py")):
print(p)
print("--- glob **/*.csv")
for p in sorted(root.glob("**/*.csv")):
print(p)
--- iterdir
project\Data.CSV file
project\main.py file
project\README.md file
project\src dir
project\tests dir
--- glob *.py
project\main.py
--- rglob *.py
project\main.py
project\src\app.py
project\src\util.py
project\tests\test_app.py
--- glob **/*.csv
project\Data.CSV
project\src\data\sample.csv
- iterdir():そのフォルダーの直下にあるものを全部(ファイルもフォルダーも)返す
- glob(“*.py”):直下から、パターンに合うものだけを返す。
*は「任意の文字列」 - rglob(“*.py”):サブフォルダーの中まで探す。
glob("**/*.py")と同じ意味(**は「このフォルダーとその下のすべてのフォルダー」)
公式ドキュメントには「iterdir は順不同で返す」とあるため、例では sorted() で並べています。表示の順番に頼る処理を書くときは、必ず並べ替えてください。また、大きなフォルダー(ドライブ全体など)で ** を使うと、とても時間がかかることがあります。
rglob("*") はフォルダーも返すので、ファイルだけほしいときは [p for p in root.rglob("*") if p.is_file()] のように is_file() で絞り込みます(この構成では 7 件)。また、Windows ではファイル名の大文字・小文字を区別しないため、glob("*.csv") で Data.CSV も見つかります。区別したいときは、Python 3.12 で追加された case_sensitive=True を指定します(この例では 0 件になります)。
フォルダーごとにたどる:Path.walk(3.12 以降)
from pathlib import Path
root = Path("project")
for dirpath, dirnames, filenames in root.walk():
print(dirpath, sorted(dirnames), sorted(filenames))
project ['src', 'tests'] ['Data.CSV', 'README.md', 'main.py']
project\src ['data'] ['app.py', 'util.py']
project\src\data [] ['sample.csv']
project\tests [] ['test_app.py']
walk() は os.walk() の pathlib 版で、「フォルダーのパス・その中のフォルダー名・その中のファイル名」の組を、フォルダーごとに返します。dirpath が Path なので、dirpath / name でそのままファイルのパスを作れます。Python 3.11 以前にはないメソッドなので、古い環境でも動かす必要があるなら rglob か os.walk を使います。
コマンドラインで同じようにファイルを探す方法は「findコマンドの使い方」で解説しています。
ファイルの読み書き:read_text・write_text
ファイル全体の読み書きは、Path のメソッドで 1 行で書けます。Windows では encoding=”utf-8″ を必ず指定してください(省略すると日本語版 Windows では cp932 になり、文字化けの原因になります)。
from pathlib import Path
d = Path("reports")
d.mkdir(exist_ok=True)
p = d / "sales.txt"
p.write_text("sales.txt\n", encoding="utf-8")
print(p.read_text(encoding="utf-8").strip())
with p.open(encoding="utf-8") as f:
print(f.readline().strip())
with open(p, encoding="utf-8") as f:
print(f.read().strip())
print(p.stat().st_size)
sales.txt
sales.txt
sales.txt
11
1 行ずつ処理したいときは p.open() を使います。組み込みの open() にも Path をそのまま渡せるので、str(p) に変換する必要はありません。stat().st_size はファイルサイズ(バイト数)で、10 文字なのに 11 になっているのは、Windows では改行 \n が \r\n(2 バイト)で書き込まれるためです。encoding や改行の詳しい扱いは「Pythonのファイル読み書き」を参照してください。
名前の変更・移動・削除
| メソッド | すること | 注意 |
|---|---|---|
| rename(新しいパス) | 名前の変更・移動 | Windows では移動先にファイルがあると FileExistsError |
| replace(新しいパス) | 名前の変更・移動 | 移動先にファイルがあっても黙って上書き |
| unlink() | ファイルを削除 | ないと FileNotFoundError。missing_ok=True で無視 |
| rmdir() | 空のフォルダーを削除 | 中身があると OSError |
| shutil.rmtree(パス) | フォルダーを中身ごと削除 | ごみ箱に入らず、元に戻せない |
from pathlib import Path
d = Path("trash")
d.mkdir(exist_ok=True)
a = d / "a.txt"
b = d / "b.txt"
a.write_text("A\n", encoding="utf-8")
b.write_text("B\n", encoding="utf-8")
try:
a.rename(b)
except FileExistsError as e:
print("FileExistsError:", e)
new = a.replace(b)
print(new, a.exists(), b.read_text(encoding="utf-8").strip())
c = b.rename(d / "c.txt")
print(c, b.exists(), c.exists())
try:
d.rmdir()
except OSError as e:
print(type(e).__name__, e)
c.unlink()
try:
c.unlink()
except FileNotFoundError as e:
print("FileNotFoundError:", e)
c.unlink(missing_ok=True)
d.rmdir()
print(d.exists())
FileExistsError: [WinError 183] 既に存在するファイルを作成することはできません。: 'trash\\a.txt' -> 'trash\\b.txt'
trash\b.txt False A
trash\c.txt False True
OSError [WinError 145] ディレクトリが空ではありません。: 'trash'
FileNotFoundError: [WinError 2] 指定されたファイルが見つかりません。: 'trash\\c.txt'
False
replace() のあと b.txt の中身が「A」になっているとおり、元の b.txt の中身は消えています。rename() と replace() は新しいパスの Path を返すので、続けて使うときは戻り値を変数に入れます(元の変数 a や b は古い場所を指したままです)。なお、公式ドキュメントによると Linux などの Unix 系では、rename() でも移動先のファイルを黙って上書きします。OS によって動きが違うので、上書きしたくないときは先に exists() で確かめましょう。
中身ごと消す shutil.rmtree は慎重に
pathlib には、中身のあるフォルダーをまとめて消すメソッドはありません。標準ライブラリの shutil.rmtree() を使います。
from pathlib import Path
import shutil
t = Path("tree") / "sub" / "deep"
t.mkdir(parents=True, exist_ok=True)
(t / "x.txt").write_text("x", encoding="utf-8")
shutil.rmtree(Path("tree"))
print(Path("tree").exists())
False
rmtree はごみ箱を通さずに、確認なしでフォルダーを丸ごと消します。Linux の rm -rf と同じくらい危険で、変数の中身が空だったり相対パスの基準がずれていたりすると、思ってもいないフォルダーを消してしまいます。使う前に消す対象を print(target.resolve()) で表示して確かめ、ユーザーの入力をそのまま渡さず、作業用フォルダーの中だけを対象にしてください。
実例:.txt ファイルの名前の先頭に日付を付ける
reports フォルダーに sales.txt・stock.txt・memo.md がある状態で、.txt だけ名前を変えます。
from pathlib import Path
d = Path("reports")
today = "20261018"
for f in sorted(d.glob("*.txt")):
new = f.with_stem(f"{today}_{f.stem}")
f.rename(new)
print(f.name, "->", new.name)
print(sorted(x.name for x in d.iterdir()))
sales.txt -> 20261018_sales.txt
stock.txt -> 20261018_stock.txt
['20261018_sales.txt', '20261018_stock.txt', 'memo.md']
sorted() で先にリストにしてから名前を変えているのがポイントです。一覧を取りながら同じフォルダーの中身を変えると、公式ドキュメントにあるとおり、変えたファイルが一覧に含まれるかどうかは決まっていません。
絶対パスと相対パス:resolve・absolute・relative_to
C:\ から始まるパスを絶対パス、data\a.txt のように途中から書くパスを相対パスといいます。相対パスは「今いるフォルダー(カレントディレクトリ)」から探されます。以下の出力では、実際のフォルダーの場所を C:\Users\user\work に置き換えています。
from pathlib import Path
p = Path("tool/../tool/config/./settings.ini")
print(p)
print(p.absolute())
print(p.resolve())
print(Path("no_such/file.txt").resolve())
try:
Path("no_such/file.txt").resolve(strict=True)
except FileNotFoundError as e:
print("FileNotFoundError")
print(p.is_absolute(), p.resolve().is_absolute())
tool\..\tool\config\settings.ini
C:\Users\user\work\tool\..\tool\config\settings.ini
C:\Users\user\work\tool\config\settings.ini
C:\Users\user\work\no_such\file.txt
FileNotFoundError
False True
Path()を作った時点で.は消えますが、..は残りますabsolute()は前にカレントディレクトリを付けるだけで、..は残しますresolve()は..やシンボリックリンクを解決した、正式な絶対パスを返します。存在しなくてもエラーにならず、strict=Trueのときだけ FileNotFoundError になります
逆に、絶対パスから相対パスを作るのが relative_to() です。
from pathlib import Path
full = Path.cwd() / "tool" / "config" / "settings.ini"
print(full.relative_to(Path.cwd()))
try:
Path("tool/config").relative_to("project")
except ValueError as e:
print("ValueError:", e)
print(Path("tool/config").relative_to("project", walk_up=True))
tool\config\settings.ini
ValueError: 'tool\\config' is not in the subpath of 'project'
..\tool\config
relative_to() は、基準のフォルダーの「中」にないパスでは ValueError になります。Python 3.12 で追加された walk_up=True を付けると、.. を使った相対パスを返します。
スクリプトの場所を基準にする:Path(__file__)
「自分の PC では動くのに、別のフォルダーから実行すると FileNotFoundError になる」というトラブルの原因の多くは、相対パスの基準がカレントディレクトリであることです。次の構成で確かめます。
work
└── tool
├── app.py
└── config
└── settings.ini
from pathlib import Path
print("cwd :", Path.cwd())
here = Path(__file__).resolve().parent
print("here :", here)
cfg = here / "config" / "settings.ini"
print(cfg.exists())
print(Path("config/settings.ini").exists())
これを tool\app.py として保存し、work フォルダーで py tool\app.py、tool フォルダーで py app.py と、2 か所から実行した結果です。
=== work フォルダーで実行
cwd : C:\Users\user\work
here : C:\Users\user\work\tool
True
False
=== tool フォルダーで実行
cwd : C:\Users\user\work\tool
here : C:\Users\user\work\tool
True
True
Path("config/settings.ini") は、実行する場所によって見つかったり見つからなかったりします。一方、__file__(実行中のスクリプト自身のパス)から作った here は、どこで実行しても同じです。スクリプトと一緒に置く設定ファイルやデータは Path(__file__).resolve().parent を基準にすると覚えておきましょう。コマンドライン引数で受け取ったパスは、逆にカレントディレクトリ基準のままで構いません。
Windows のパス:\ と / と raw 文字列
Windows のパスをコピーしてそのまま文字列に書くと、\ が「エスケープ(特別な文字の始まり)」として解釈されてしまいます。
from pathlib import Path
print(Path("C:\new\table.txt"))
print(Path(r"C:\new\table.txt"))
print(Path("C:/new/table.txt"))
C:
ew able.txt
C:\new\table.txt
C:\new\table.txt
1 つ目は \n が改行、\t がタブになり、パスが壊れています。"C:\data\memo.txt" のように意味のない組み合わせ(\d)だと、Python 3.12 では SyntaxWarning: invalid escape sequence '\d' という警告が出ます。対策は次のどちらかです。
- 文字列の前に
rを付けた raw 文字列にする:r"C:\new\table.txt" - 区切りを
/で書く:"C:/new/table.txt"(Windows の Path でも正しく扱われる)
PureWindowsPath:他の OS のパスを計算だけする
PureWindowsPath と PurePosixPath は、ファイルには一切触らず、パスの文字列の計算だけをするクラスです。どの OS でも使えるので、Linux のサーバーで Windows のパスを分解する、といったときに使います。
from pathlib import PureWindowsPath, PurePosixPath
w = PureWindowsPath(r"C:\Users\user\Documents\memo.txt")
print(w.drive, w.root, w.anchor)
print(w.parts)
print(w.as_posix())
print(PureWindowsPath("C:/Users/user") == PureWindowsPath(r"c:\users\USER"))
print(PurePosixPath("/home/user") == PurePosixPath("/home/USER"))
print(PureWindowsPath(r"\\server\share\docs\a.txt").drive)
C: \ C:\
('C:\\', 'Users', 'user', 'Documents', 'memo.txt')
C:/Users/user/Documents/memo.txt
True
False
\\server\share
Windows のパスどうしは大文字・小文字を区別せずに比べられ、POSIX(Linux など)のパスは区別されます。\\server\share のようなネットワーク上の共有フォルダー(UNC パス)も、drive として扱われます。
os.path との対応表
古いコードや記事で見かける os・os.path の関数と、pathlib の書き方の対応です(公式ドキュメントの対応表から、よく使うものを抜き出しました)。
| os・os.path | pathlib |
|---|---|
| os.path.join(a, b) | Path(a) / b |
| os.path.basename(p) | p.name |
| os.path.dirname(p) | p.parent |
| os.path.splitext(p) | p.stem、p.suffix |
| os.path.exists(p) | p.exists() |
| os.path.isfile(p) / isdir(p) | p.is_file() / p.is_dir() |
| os.path.isabs(p) | p.is_absolute() |
| os.path.abspath(p) | p.absolute() |
| os.path.realpath(p) | p.resolve() |
| os.path.relpath(p, start) | p.relative_to(start) |
| os.path.expanduser(“~”) | Path.home()、p.expanduser() |
| os.getcwd() | Path.cwd() |
| os.listdir(p) | p.iterdir() |
| os.walk(p) | p.walk()(3.12 以降) |
| os.mkdir / os.makedirs | p.mkdir() / p.mkdir(parents=True) |
| os.rename / os.replace | p.rename() / p.replace() |
| os.remove(p) | p.unlink() |
| os.rmdir(p) | p.rmdir() |
| os.stat(p) | p.stat() |
Python 3.12 で追加・変更された点
公式ドキュメント(What’s New In Python 3.12 と pathlib のページ)で確認した、pathlib の主な変更です。3.11 以前の環境では使えないので注意してください。
| 追加・変更 | 内容 |
|---|---|
| Path.walk() | os.walk() のようにフォルダーをたどる(追加) |
| relative_to(…, walk_up=True) | .. を使った相対パスを返せる(引数の追加) |
| glob()・rglob()・match() の case_sensitive | 大文字・小文字の区別を指定できる(引数の追加) |
| Path.is_junction() | Windows のジャンクションかどうかを調べる(追加) |
| Path.exists(follow_symlinks=…) | シンボリックリンクをたどるかどうかを指定できる(引数の追加) |
よくある間違いと直し方
| 症状・エラー | 原因 | 直し方 |
|---|---|---|
| TypeError: can only concatenate str (not “WindowsPath”) to str | 文字列と Path を + でつないだ | / でつなぐ。文字列がほしいなら str(p) + “_backup” |
| パスに改行やタブが入る・SyntaxWarning | “C:\new” の \ がエスケープになった | r”C:\new” か “C:/new” と書く |
| 別の場所から実行すると FileNotFoundError | 相対パスの基準がカレントディレクトリ | Path(__file__).resolve().parent を基準にする |
| mkdir で FileNotFoundError / FileExistsError | 親フォルダーがない / すでにある | mkdir(parents=True, exist_ok=True) |
| rmdir で OSError(ディレクトリが空ではありません) | 中身が残っている | 中身を消してから。丸ごと消すなら shutil.rmtree(要注意) |
| rename で FileExistsError(Windows) | 移動先に同名のファイルがある | 上書きしてよいなら replace() |
| walk() で AttributeError になる | Python 3.11 以前 | py –version で確認。rglob か os.walk を使う |
| TypeError: unsupported operand type(s) for +: ‘WindowsPath’ and ‘str’ | Path(“data”) + “/a.txt” のように Path に + を使った | Path(“data”) / “a.txt” |
なお、"data" / Path("a.txt") のように、左が文字列でも右が Path なら / でつなげます(結果は data\a.txt)。
よくある質問
os.path と pathlib、どちらを使えばよいですか?
新しく書くコードなら pathlib をおすすめします。パスの結合・分解・存在確認・読み書きが 1 つの型で済み、Windows と Linux の区切りの違いも気にせずに済むからです。既存のコードが os.path で書かれていれば、無理に書き換える必要はありません。両方とも標準ライブラリで、混ぜて使っても問題ありません(os.path の関数にも Path を渡せます)。
ファイルやフォルダーをコピーするには?
Python 3.12 の pathlib にはコピーのメソッドがないため、shutil.copy2(元, 先)(ファイル)や shutil.copytree(元, 先)(フォルダー)を使います。どちらも Path を引数に渡せます。zip などにまとめたいときは「tar・zipで圧縮・展開する方法」も参考にしてください。
まとめ
- パスは
Path("data") / "a.csv"のように / でつなぎ、部品は name・stem・suffix・parent で取り出す - フォルダーは
mkdir(parents=True, exist_ok=True)、一覧は glob・rglob・walk(3.12 以降) - replace() と shutil.rmtree() は確認なしで上書き・削除する。対象を print してから実行する
- スクリプトの隣のファイルは
Path(__file__).resolve().parentを基準にし、Windows のパスは r”…” か / で書く
関連する記事・ツール
- Pythonのファイル読み書き|open・with・encoding指定と文字化けの直し方
- PythonでCSVを読み書きする方法|csvモジュールとExcelの文字化け・空行対策
- Pythonの例外処理入門|try・except・finally・raiseの使い方
- findコマンドの使い方|名前・日付・サイズで探す方法とxargsとの組み合わせ
- tar・zipで圧縮・展開する方法|LinuxとWindowsのコマンド・文字化け対策
- Pythonのargparseの使い方|コマンドライン引数の受け取り方を実例で解説
- Pythonのglobとfnmatchでファイルを探す|**とrecursiveの注意点