萬盛學電腦網

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

Python shutil 複製整個目錄:完整指南與進階用法

Python 標準庫 shutil 提供高層檔案操作,支援複製檔案、目錄樹、保留中繼資料等。本文詳細介紹目錄複製的核心方法、參數細節、錯誤處理與進階模式。

核心方法:copytree


import shutil

# 基本複製:src 目錄完整複製到 dst (dst 必須不存在)
shutil.copytree('src_dir', 'dst_dir')

關鍵參數 (Python 3.8+)


shutil.copytree(
    src, dst,
    symlinks=False,      # True: 複製符號連結本身;False: 複製連結指向的檔案
    ignore=None,         # 忽略模式函數 (如 shutil.ignore_patterns)
    copy_function=shutil.copy2,  # 複製函數
    ignore_dangling_symlinks=False, # 忽略損壞符號連結
    dirs_exist_ok=False  # True: 允許 dst 存在並合併 (3.8+)
)

常用模式

1. 忽略特定檔案/目錄


# 忽略 .git、__pycache__、*.pyc、.DS_Store
shutil.copytree(
    'src', 'dst',
    ignore=shutil.ignore_patterns('.git', '__pycache__', '*.pyc', '.DS_Store')
)

# 自訂忽略邏輯
def ignore_pyc(dirname, filenames):
    return [f for f in filenames if f.endswith('.pyc') or f == '__pycache__']

shutil.copytree('src', 'dst', ignore=ignore_pyc)

2. 自訂複製行為 (保留/不保留中繼資料)


# copy2: 複製內容 + 權限 + 時間戳 + 延伸屬性 (預設)
shutil.copytree(src, dst, copy_function=shutil.copy2)

# copy: 僅複製內容 + 權限
shutil.copytree(src, dst, copy_function=shutil.copy)

# 自訂:只複製內容
shutil.copytree(src, dst, copy_function=lambda s,d: open(d,'wb').write(open(s,'rb').read()))

3. 合併到現有目錄 (Python 3.8+)


# dirs_exist_ok=True 允許 dst 存在,內容合併 (同名檔案覆寫)
shutil.copytree('src', 'dst', dirs_exist_ok=True)

4. 複製單一檔案


shutil.copy('src/file.txt', 'dst/file.txt')      # 內容 + 權限
shutil.copy2('src/file.txt', 'dst/file.txt')     # 內容 + 權限 + 時間戳
shutil.copyfile('src/file.txt', 'dst/file.txt')  # 僅內容
shutil.copyfileobj(open('src','rb'), open('dst','wb')) # 檔案物件串流複製

錯誤處理


import errno

try:
    shutil.copytree('src', 'dst')
except FileExistsError:
    print("目標目錄已存在")
except OSError as e:
    if e.errno == errno.ENOTDIR:
        print("來源不是目錄")
    elif e.errno == errno.EACCES:
        print("權限不足")
    else:
        raise

進階:複製並壓縮


import shutil, tarfile

# 複製並打包為 tar.gz
shutil.make_archive('backup', 'gztar', 'src_dir')
# 產生 backup.tar.gz

同步目錄 (rsync 風格)

標準庫無內建 rsync,常用方案:

  • subprocess.run(['rsync', '-av', 'src/', 'dst/']) (Linux/macOS)
  • robocopy (Windows)
  • 第三方庫:dirsync、pysync

最佳實踐

  • 大量檔案複製前先檢查磁碟空間 `shutil.disk_usage(dst)`。
  • 生產環境備份建議加上時間戳:`dst_{datetime.now():%Y%m%d_%H%M%S}`。
  • 權限敏感場景務必用 `copy2` 保留 metadata。
  • 符號連結處理根據需求設定 `symlinks` 參數。
copyright © 萬盛學電腦網 all rights reserved