文件路徑操作是 Python 日常開發的高頻需求。os.path 提供函數式接口,pathlib.Path (Py3.4+) 提供物件導向接口。本文整理最高頻操作的雙版本對照表,並補充 glob 模式匹配與實用技巧。
| 操作 | os.path | pathlib.Path | 說明 |
|---|---|---|---|
| 拼接路徑 | os.path.join(a, b, c) | Path(a) / b / c | 自動處理分隔符 |
| 分離目錄/文件 | os.path.split(p) | Path(p).parent, Path(p).name | 返回 (目錄, 文件名) |
| 分離擴展名 | os.path.splitext(p) | Path(p).stem, Path(p).suffix | 返回 (主名, .副檔名) |
| 取得目錄 | os.path.dirname(p) | Path(p).parent | |
| 取得文件名 | os.path.basename(p) | Path(p).name | |
| 轉絕對路徑 | os.path.abspath(p) | Path(p).resolve() | resolve 同時解析連結 |
| 規範化路徑 | os.path.normpath(p) | Path(p).resolve() 或 Path(p).absolute() | 解析 .. . 符號連結 |
| 判斷存在 | os.path.exists(p) | Path(p).exists() | |
| 判斷是文件 | os.path.isfile(p) | Path(p).is_file() | |
| 判斷是目錄 | os.path.isdir(p) | Path(p).is_dir() | |
| 獲取大小 | os.path.getsize(p) | Path(p).stat().st_size | 位元組 |
| 獲取修改時間 | os.path.getmtime(p) | Path(p).stat().st_mtime | 時間戳 |
| 當前工作目錄 | os.getcwd() | Path.cwd() | |
| 改變工作目錄 | os.chdir(p) | os.chdir(p) (Path 無此方法) | |
| 列出目錄 | os.listdir(p) | Path(p).iterdir() | 返回迭代器 |
| 遞歸列出 | os.walk(p) | Path(p).rglob('*') | rglob 返回所有文件 |
| 模式匹配 | glob.glob(pattern) | Path(dir).glob(pattern) | 支援 *, ?, [], ** |
# 當前文件所在目錄
BASE_DIR = Path(__file__).resolve().parent.parent
# 查找配置文件
config = BASE_DIR / 'config' / 'settings.yaml'
output_dir = Path('/var/log/myapp')
output_dir.mkdir(parents=True, exist_ok=True, mode=0o755)
for f in Path('.').glob('*.JPG'):
f.rename(f.with_suffix('.jpg'))
latest = max(Path('logs').glob('*.log'), key=lambda p: p.stat().st_mtime)
total = sum(f.stat().st_size for f in Path('data').rglob('*') if f.is_file())
print(f"{total / 1024**2:.1f} MB")
base = Path('/home/user/project')
target = Path('/home/user/project/src/main.py')
rel = target.relative_to(base) # src/main.py
| 模式 | 含義 | 範例匹配 |
|---|---|---|
* | 任意字符 (不含分隔符) | *.py, test_*.py |
** | 任意層級目錄 (含分隔符) | **/*.py 遞歸所有 .py |
? | 單個字符 | file?.txt |
[abc] | 字符集合 | [abc].txt |
[a-z] | 字符範圍 | [0-9].log |
# os.walk: 返回 (root, dirs, files) 三元組,適合需要目錄結構處理
for root, dirs, files in os.walk('src'):
# 可就地修改 dirs 列表控制遞歸 (如跳過 .git)
dirs[:] = [d for d in dirs if not d.startswith('.')]
for f in files:
print(os.path.join(root, f))
# Path.rglob: 直接產生所有匹配文件 Path 物件,適合扁平化處理
for f in Path('src').rglob('*.py'):
print(f)
Path(os.path.join(...)) 互操作無縫os.scandir() / os.walk() 略快於 pathlibstr(path_obj) 或 os.fspath(path_obj)將此對照表加入備忘錄,下次路徑操作不再查文檔,直接寫出專業級代碼。