本文介绍如何使用 python 动态遍历预定义的文件夹名列表，自动检测源路径是否存在，并在目标路径已存在时先删除再完整复制，实现灵活、可扩展的多目录同步逻辑。
本文介绍如何使用 python 动态遍历预定义的文件夹名列表，自动检测源路径是否存在，并在目标路径已存在时先删除再完整复制，实现灵活、可扩展的多目录同步逻辑。
在项目构建或工作区初始化过程中，常需将多个特定子目录（如 src、public、specs、assets 等）从源路径（如 ../source/xxx/）批量复制到工作区（如 workspace/xxx/），且要求若目标目录已存在，则先彻底清除再重新复制，确保内容完全一致。
直接为每个目录编写重复逻辑不仅冗余，还难以维护。更优方案是将待同步的目录名抽象为列表，通过循环统一处理。以下是推荐的实现方式：
✅ 推荐写法：简洁、可扩展、语义清晰
import os
import shutil
from os.path import join
def copy_and_replace(directory):
# 定义需同步的子目录名列表（可随时增删）
folder_names = ["src", "public", "specs", "assets"]
for name in folder_names:
source = join('..', 'source', directory, name)
target = join('workspace', directory, name)
try:
# 仅当源目录存在时才执行操作（避免无意义报错）
if not os.path.isdir(source):
print(f"Skip: source directory not found — {source}")
continue
# 若目标已存在，先删除
if os.path.isdir(target):
shutil.rmtree(target)
print(f"✓ Removed existing target: {target}")
# 执行复制
shutil.copytree(source, target)
print(f"✓ Copied successfully: {source} → {target}")
except OSError as e:
print(f"✗ Error copying '{name}' for '{directory}': {e.strerror} ({e.errno})")? 关键设计说明
- folder_names 列表驱动：所有待同步目录集中管理，新增如 docs 或 tests 只需追加字符串，无需修改逻辑。
- 源存在性校验（os.path.isdir(source)）：避免对缺失目录执行 copytree 导致异常；src 虽“总存在”，但统一检查更健壮。
- 目标存在性判断与清理：确保每次都是干净覆盖，防止残留旧文件。
- 异常捕获精细化：按目录粒度捕获错误，不影响其他目录的复制流程。
- 路径构造使用 os.path.join 或 pathlib.Path：保障跨平台兼容性（Windows/Linux/macOS 路径分隔符自动适配）。
⚠️ 注意事项
- shutil.copytree() 要求目标路径必须不存在（这是其设计约束），因此必须先 rmtree 再复制——不可省略判断与清理步骤。
- 若某目录在源中为空（仅含空子目录），copytree 仍能正确处理；但若 source/name 是文件而非目录，会抛出 NotADirectoryError，建议在生产环境补充类型校验。
- 如需支持符号链接保留、忽略规则（如 .git）、或增量同步，应改用 shutil.copytree(..., symlinks=True, ignore=...) 或升级至 pathlib + 自定义遍历逻辑。
✅ 总结
通过将目录名抽象为配置化列表并封装通用复制逻辑，代码复用率显著提升，维护成本大幅降低。该模式适用于 CI/CD 初始化脚本、本地开发环境搭建、多模块项目资源同步等典型场景，兼具清晰性、鲁棒性与可扩展性。
