萬盛學電腦網

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

Python 判斷文件/目錄存在的完整指南:os.path、pathlib、權限檢查、FTP 遠程檢測

檢查路徑是否存在、是文件還是目錄、是否可讀寫,是文件操作的前置必要步驟。Python 提供 os.path、pathlib (3.4+) 兩套 API,本文系統整理各類檢測場景、最佳實踐與陷阱避坑。

核心 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時間戳

基礎檢測模式

1. EAFP 風格 (Pythonic,推薦)


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("路徑是目錄非文件")

2. LBYL 風格 (顯式檢查)


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):
    ...

os.path.lexists():損壞連結也返回 True


import os
os.symlink('/nonexistent', 'broken_link')
os.path.exists('broken_link')   # False
os.path.lexists('broken_link')  # True (連結本身存在)

FTP/SFTP 遠程文件存在性檢測

FTP (ftplib)


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

SFTP (paramiko)


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("不存在")

常見陷阱

  • 競態條件 (TOCTOU): 檢查與使用之間文件狀態可能改變 → 採用 EAFP try/except
  • 相對路徑陷阱: os.getcwd() 可能變更 → 統一用絕對路徑 Path.resolve()
  • 大小寫敏感: Linux 區分大小寫,Windows 不區分 → 跨平台注意
  • 權限檢查不可靠: os.access 檢查實際 UID/GID,對 root/ACL/NFS 可能誤判 → 嘗試實際操作捕獲異常更可靠

pathlib 遷移清單


# 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 風格的文件系統代碼。

copyright © 萬盛學電腦網 all rights reserved