Python
PR

Pythonのpathlibの使い方|Pathでファイル・フォルダーを操作する方法と注意点

Pythonのpathlibの使い方|Pathでファイル・フォルダーを操作する方法と注意点
hr
記事内に商品プロモーションを含む場合があります

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
stemname から最後の拡張子を除いたものreport
suffix最後の拡張子(. 付き).csv
parent1 つ上のフォルダー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.pathpathlib
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.makedirsp.mkdir() / p.mkdir(parents=True)
os.rename / os.replacep.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”…” か / で書く

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました