Python 標準庫 shutil 提供高層檔案操作,支援複製檔案、目錄樹、保留中繼資料等。本文詳細介紹目錄複製的核心方法、參數細節、錯誤處理與進階模式。
import shutil
# 基本複製:src 目錄完整複製到 dst (dst 必須不存在)
shutil.copytree('src_dir', 'dst_dir')
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+)
)
# 忽略 .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)
# 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()))
# dirs_exist_ok=True 允許 dst 存在,內容合併 (同名檔案覆寫)
shutil.copytree('src', 'dst', dirs_exist_ok=True)
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,常用方案:
subprocess.run(['rsync', '-av', 'src/', 'dst/']) (Linux/macOS)robocopy (Windows)dirsync、pysync