PythonでWindowsのファイルパスを書く方法
PythonでWindowsのファイルパスを書くときに、バックスラッシュ（\）の扱いでつまずいたので整理します。
結論としては、ちょっとした確認なら raw文字列、実際の処理では pathlib を使うのがおすすめです。
何が起きるのか
Windowsのパスは次のように \ を使います。
C:\Users\joji\Desktop\hoge.txt
ただし、Pythonの文字列では \ はエスケープ文字としても使われます。たとえば \n は改行、\t はタブとして扱われます。
そのため、Windowsのパスをそのまま書くと意図しない文字列になることがあります。
方法1: バックスラッシュを2つ書く
\ 自体を文字として扱いたい場合は、\\ と2つ書きます。
filepath = "C:\\Users\\joji\\Desktop\\hoge.txt"
print(filepath)
# C:\Users\joji\Desktop\hoge.txt
確実ですが、パスが長くなると少し読みにくいです。
方法2: raw文字列を使う
文字列の先頭に r を付けると、バックスラッシュをほぼそのまま扱えます。
filepath = r"C:\Users\joji\Desktop\hoge.txt"
print(filepath)
# C:\Users\joji\Desktop\hoge.txt
短いメモや固定パスを書くときは、この方法が分かりやすいです。
ただし、raw文字列は末尾を1つのバックスラッシュで終われません。
# これはエラーになる
# filepath = r"C:\Users\joji\Desktop\"
末尾に \ が必要な場合は、次のように書きます。
filepath = r"C:\Users\joji\Desktop" + "\\"
方法3: スラッシュで書く
Windowsでも、多くのPython処理では / 区切りのパスを扱えます。
filepath = "C:/Users/joji/Desktop/hoge.txt"
\ のエスケープを気にしなくてよいので、簡単なスクリプトではこれでも十分です。
方法4: pathlibを使う
ファイルやフォルダを扱う処理では、pathlib を使うと安全で読みやすくなります。
from pathlib import Path
filepath = Path("C:/Users/joji/Desktop/hoge.txt")
print(filepath.name) # hoge.txt
print(filepath.parent) # C:\Users\joji\Desktop
フォルダとファイル名をつなげるときも、文字列連結より分かりやすいです。
from pathlib import Path
desktop = Path.home() / "Desktop"
filepath = desktop / "hoge.txt"
print(filepath)
Path.home() を使うと、ユーザー名を直接書かずにホームフォルダを取得できます。
まとめ
| 書き方 | 例 | 使いどころ |
|---|---|---|
\\ を使う |
"C:\\Users\\joji" |
仕組みを理解するにはよい |
| raw文字列 | r"C:\Users\joji" |
固定パスを短く書きたいとき |
| スラッシュ | "C:/Users/joji" |
手軽に書きたいとき |
| pathlib | Path.home() / "Desktop" |
ファイル操作を書くとき |
個人的には、最初はraw文字列で覚えて、ファイル操作が増えてきたら pathlib に寄せるのがよさそうです。