🐍 Python

Python pathlib クイックリファレンス

AIが生成するPythonコードでは、ファイルパスの操作にオブジェクト指向な標準ライブラリpathlibがよく使われます。このページはPython記事で基礎を押さえた人向けに、パス操作でよく使う機能を一覧にしたクイックリファレンスです。各項目をクリックすると、実行して確認済みのサンプルコードとあわせて詳しく解説したページに移動します。

パスの作成・結合

Path / /演算子 — パスを作り、結合する
PathとOS依存の文字列パスの違い — os.pathとの使い分け

パスの分解・変換

name / suffix / stem — パスの構成要素を取得する
with_name / with_suffix — 一部だけ変えた新しいパスを作る
resolve / absolute — 絶対パスに変換する

存在確認・作成

exists / is_file / is_dir — 存在と種別を確認する
mkdir / touch — ディレクトリ・空ファイルを作る

読み書き・走査

read_text / write_text — ファイルを読み書きする
glob / rglob — パターンに一致するファイルを検索する
iterdir — ディレクトリ内の一覧を取得する

Pathオブジェクトの共通の性質

パスを文字列ではなくオブジェクトとして扱う: /演算子でパスを結合でき、区切り文字(WindowsのバックスラッシュとLinux/Macのスラッシュ)の違いを自動的に吸収する
存在しないパスも表現できる: Pathオブジェクトを作る時点ではファイルシステムへのアクセスは発生しない。実際に存在するかはexists()で確認する

💡 ワンポイントアドバイス：古いos.pathベースのコードとの混在に注意

AIが生成したコードで、同じファイルのPathオブジェクトとos.path.join()で作った文字列パスが混在していることがあります。多くの標準ライブラリ関数はPathを直接受け取れますが、古いライブラリや一部の外部ライブラリは文字列を要求することがあり、その場合はstr(path)で明示的に変換する必要があります。詳しくはPathとOS依存の文字列パスの違いで解説しています。

日時の操作はdatetime クイックリファレンス、辞書の操作はdict クイックリファレンスもあわせてご覧ください。