Pythonのos.path.join徹底解説！初心者向けパス結合ガイド

Pythonのos.path.joinメソッドは、1つ以上のパス名を1つのパスに結合します。このメソッドは、os.walk()などのosモジュールのメソッドと組み合わせて、ファイルやフォルダの最終的なパスを生成する際によく使われます。os.path.join()は、必要なスラッシュ（/）を自動的にパスに挿入してくれる便利な機能です。

Python os.path.joinの使い方

Pythonでファイルを扱っていると、「パスの迷路」にはまってしまうことがあります。

ファイルを操作するには、そのファイルが存在するディレクトリを指定する必要があります。これは思ったよりも簡単ですが、正しいパスを指定しないとプログラムは正常に動作しません。

この記事では、ファイルパスの各要素を1つの完全なパスに結合するメソッド「os.path.join」について解説します。具体的なコード例を2つ紹介しながら、このメソッドの基本的な使い方を見ていきましょう。

ファイルパスとは？

ファイルパスとは、ファイル名とフォルダ名をつなぎ合わせた一連の文字列です。この名前の連なりによって、コンピュータのOS（オペレーティングシステム）上の特定の場所へアクセスできます。

次のパスを例に見てみましょう。

/Users/James/tutorials

このパスは「tutorials」というフォルダを指しています。このフォルダ内の特定のファイルやディレクトリにアクセスしたい場合は、ファイル名を使って指定します。

/Users/James/tutorials/README.md

Pythonでは、こうしたファイルパスを手動で記述することもできますが、実用的とは言えません。そこで登場するのがos.path.joinです。

Python os.path.joinとは？

os.path.joinは、複数のパス名を1つの完全なパスに結合するメソッドです。つまり、パスの各部分を手動でハードコードする代わりに、複数の要素をまとめて1つのパスにマージできます。

この関数を使用するには、まずosライブラリをコードにインポートします。

import os

次に、os.path.join()メソッドの構文を見てみましょう。os.path.join関数は、1つに結合したいパスのリストを受け取ります。

os.path.join(path1, path2...)

path1、path2、およびそれ以降の引数は、1つのパスに結合したいパスを表します。

path = os.path.join("/Users/James/tutorials", "index.html")
print(path)

このコードは /Users/James/tutorials/index.html を返します。os.path.joinメソッドは、指定した絶対パス（/Users/James/tutorials）を起点として、その末尾にindex.htmlを追加します。

便利なことに、os.path.joinメソッドは必要に応じてスラッシュ（/）（「ディレクトリセパレータ」と呼ばれます）を自動的に挿入します。これにより、パス名を手動で連結するよりもはるかに簡単に、しかも安全にファイルパスを組み合わせられます。

os.path.joinのPythonサンプルコード

ここでは、現在の作業ディレクトリ内にある「tutorials/web/」フォルダの中の「index.html」ファイルへのパスを作成してみましょう。

まず、osライブラリをインポートします。

import os

次に、ファイルパスを追加するために、現在の作業ディレクトリを取得します。

cwd = os.getcwd()

これにより、現在の作業ディレクトリである /Users/James/tutorials が取得されます。「tutorials」フォルダはユーザーのホームディレクトリ内にあります。この情報をもとに、作業ディレクトリの末尾に「tutorials/web」を追加してみましょう。

web_tutorials = os.path.join(cwd, "tutorials/web")
print(web_tutorials)

このコードは /Users/James/tutorials/web を返します。コードによってパス名の各要素が1つに結合され、パス名の間にスラッシュ（/）が自動的に挿入されました。このパスは、既存のパス内にある「web」フォルダを指しています。

Python os.path.join：フォルダ内のファイル一覧を取得する

次に、os.path.joinメソッドを使って、フォルダ内のすべてのファイルの完全なパスを取得してみましょう。ここでは、ファイルシステム上の「Desktop」フォルダにあるすべてのファイルを一覧表示します。このフォルダはドライブ上の「/Users/James/」ディレクトリに配置されています。

まず、osライブラリをインポートし、検索対象のディレクトリを定義します。

import os

cwd = os.getcwd()
desktop = os.path.join(cwd, "Desktop")

このコードは、現在の作業ディレクトリを基準としたDesktopフォルダのファイルパスを生成します。次に、Pythonのos.listdir()メソッドを使って、このフォルダ内のすべてのファイルのリストを取得します。

files = os.listdir(desktop)

このメソッドは、Desktopフォルダ内に存在するすべてのファイル名のリストを返します。ただし、ファイルのパス自体は含まれません。このファイルリストが得られたので、コンソールにすべて表示してみましょう。os.path.joinとPythonのforループを使って、各ファイルの完全なパスを出力します。

for f in files:
	print(os.path.join(desktop, f))

このコードは、Desktopフォルダ内のすべてのファイルをループ処理し、各ファイル名をDesktopフォルダのパス名と結合します。実行結果は以下の通りです。

/Users/James/Desktop/.DS_Store
/Users/James/Desktop/Notes.md
/Users/James/Desktop/To-dos.md

デスクトップには.DS_Store、Notes.md、To-dos.mdの3つのファイルがあります。os.path.join()を使うことで、各ファイルの完全なパスを簡単に生成できました。

まとめ

os.path.joinメソッドは、パス名の各要素を組み合わせて完全なパス名を作成します。

このメソッドを使えば、2つ以上のパスの要素を簡単に結合できます。os.path.joinは、必要に応じてスラッシュ（/）を自動的にパス名に挿入してくれるため、OSごとのパス形式の違いを意識せずに済み、手動での文字列連結によるミスも防げます。

Pythonプログラミングについてさらに学びたい方は、Python学習ガイドもぜひ参考にしてください。