萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 文件路徑與目錄操作核心函數速查:os.path 與 pathlib 完整對照表

文件路徑操作是 Python 日常開發的高頻需求。os.path 提供函數式接口,pathlib.Path (Py3.4+) 提供物件導向接口。本文整理最高頻操作的雙版本對照表,並補充 glob 模式匹配與實用技巧。

核心操作對照表

操作os.pathpathlib.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)支援 *, ?, [], **

實用代碼片段

1. 專案根目錄定位


# 當前文件所在目錄
BASE_DIR = Path(__file__).resolve().parent.parent

# 查找配置文件
config = BASE_DIR / 'config' / 'settings.yaml'

2. 安全建立輸出目錄


output_dir = Path('/var/log/myapp')
output_dir.mkdir(parents=True, exist_ok=True, mode=0o755)

3. 批量重命名 (擴展名統一小寫)


for f in Path('.').glob('*.JPG'):
    f.rename(f.with_suffix('.jpg'))

4. 尋找最近修改的文件


latest = max(Path('logs').glob('*.log'), key=lambda p: p.stat().st_mtime)

5. 計算目錄總大小


total = sum(f.stat().st_size for f in Path('data').rglob('*') if f.is_file())
print(f"{total / 1024**2:.1f} MB")

6. 相對路徑計算


base = Path('/home/user/project')
target = Path('/home/user/project/src/main.py')
rel = target.relative_to(base)  # src/main.py

glob 模式速查

模式含義範例匹配
*任意字符 (不含分隔符)*.py, test_*.py
**任意層級目錄 (含分隔符)**/*.py 遞歸所有 .py
?單個字符file?.txt
[abc]字符集合[abc].txt
[a-z]字符範圍[0-9].log

os.walk vs Path.rglob


# 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)

遷移建議

  • 新專案 首選 pathlib:類型提示友好、鏈式調用、方法發現性好
  • 舊代碼漸進遷移:Path(os.path.join(...)) 互操作無縫
  • 需高效能大量掃描:os.scandir() / os.walk() 略快於 pathlib
  • 字符串路徑交互處:str(path_obj) 或 os.fspath(path_obj)

將此對照表加入備忘錄,下次路徑操作不再查文檔,直接寫出專業級代碼。

copyright © 萬盛學電腦網 all rights reserved