檢查路徑是否存在、是文件還是目錄、是否可讀寫,是文件操作的前置必要步驟。Python 提供 os.path、pathlib (3.4+) 兩套 API,本文系統整理各類檢測場景、最佳實踐與陷阱避坑。
| 需求 | os.path (傳統) | pathlib.Path (現代) | 備註 |
|---|---|---|---|
| 路徑存在 | os.path.exists(p) | Path(p).exists() | 文件/目錄/連結均返回 True |
| 是文件 | os.path.isfile(p) | Path(p).is_file() | 不存在返回 False |
| 是目錄 | os.path.isdir(p) | Path(p).is_dir() | |
| 是連結 | os.path.islink(p) | Path(p).is_symlink() | |
| 是掛載點 | os.path.ismount(p) | Path(p).is_mount() | |
| 獲取大小 | os.path.getsize(p) | Path(p).stat().st_size | 目錄返回 0 |
| 獲取修改時間 | os.path.getmtime(p) | Path(p).stat().st_mtime | 時間戳 |
from pathlib import Path
path = Path('/home/user/data.txt')
try:
content = path.read_text(encoding='utf-8')
except FileNotFoundError:
print("文件不存在")
except PermissionError:
print("無讀取權限")
except IsADirectoryError:
print("路徑是目錄非文件")
import os
path = '/home/user/data.txt'
if os.path.exists(path):
if os.path.isfile(path):
if os.access(path, os.R_OK):
print("可讀文件")
else:
print("文件不可讀")
elif os.path.isdir(path):
print("是目錄")
else:
print("路徑不存在")
# os.makedirs (舊版需捕獲 OSError)
os.makedirs('/path/to/dir', exist_ok=True) # Python 3.2+
# pathlib (推薦)
Path('/path/to/dir').mkdir(parents=True, exist_ok=True)
import os
path = '/path/to/file.txt'
# 檢查文件可寫
if os.path.isfile(path) and os.access(path, os.W_OK):
...
# 檢查目錄可寫 (以便建立新文件)
dir_path = os.path.dirname(path) or '.'
if os.path.isdir(dir_path) and os.access(dir_path, os.W_OK):
...
import os
os.symlink('/nonexistent', 'broken_link')
os.path.exists('broken_link') # False
os.path.lexists('broken_link') # True (連結本身存在)
from ftplib import FTP, error_perm
def ftp_exists(ftp, path):
try:
# 嘗試獲取文件大小 (文件)
ftp.size(path)
return True, 'file'
except error_perm:
pass
try:
# 嘗試列出目錄內容 (目錄)
ftp.nlst(path)
return True, 'dir'
except error_perm:
return False, None
ftp = FTP('ftp.example.com')
ftp.login('user', 'pass')
exists, typ = ftp_exists(ftp, '/remote/path/file.txt')
import paramiko
ssh = paramiko.SSHClient()
ssh.connect('host', username='user', password='pass')
sftp = ssh.open_sftp()
try:
attr = sftp.stat('/remote/path')
if paramiko.S_ISDIR(attr.st_mode):
print("目錄")
else:
print("文件")
except FileNotFoundError:
print("不存在")
try/exceptos.getcwd() 可能變更 → 統一用絕對路徑 Path.resolve()os.access 檢查實際 UID/GID,對 root/ACL/NFS 可能誤判 → 嘗試實際操作捕獲異常更可靠
# os.path → pathlib.Path
os.path.join(a, b) → Path(a) / b
os.path.basename(p) → Path(p).name
os.path.dirname(p) → Path(p).parent
os.path.splitext(p) → Path(p).suffix, Path(p).stem
os.path.abspath(p) → Path(p).resolve()
os.path.relpath(p, start) → Path(p).relative_to(start)
glob.glob(pattern) → Path(dir).glob(pattern) / rglob(pattern)
掌握 pathlib 物件導向 API,能寫出更易讀、更安全、更符合現代 Python 風格的文件系統代碼。