17370845950

Python代码目录同步需基于SHA-256哈希比对（非时间戳），区分新增、待删、需更新、跳过四类文件；支持安全/强制/预览三种模式，自动建目录、写后校验、三类日志记录及断点续传。

用 Python 自动识别两个代码目录的版本差异并同步文件，核心在于比对文件内容（而非仅修改时间）、安全覆盖或跳过、保留操作日志。关键不是简单复制粘贴，而是建立可复验、可回退、有上下文的同步逻辑。

比对：用哈希而非时间戳判断真实差异

文件修改时间容易被篡改或不同步，直接用 os.path.getmtime() 可靠性低。应逐个计算文件的 SHA-256（大文件可分块读取），生成“路径 → 哈希值”字典。对两个目录分别构建这样的字典后，再做集合运算：

• 只在源目录存在 → 标记为“新增”
• 只在目标目录存在 → 标记为“待删除”（默认不自动删，需开关控制）
• 同名但哈希不同 → 标记为“需更新”
• 同名且哈希相同 → 跳过

同步：按策略执行，不盲目覆盖

同步动作必须可配置。典型策略包括：

• 安全模式（默认）：只复制新增和更新文件；跳过目标中已存在且不同的文件，并记录冲突路径
• 强制覆盖模式：覆盖目标中所有差异文件，同步前自动备份原文件为 filename.bak
• 差异预览模式：只输出将要执行的操作列表，不写磁盘（适合上线前确认）

每次写入前检查目标父目录是否存在，自动 os.makedirs(..., exist_ok=True)；写入后校验哈希一致性，失败则抛异常并中断流程。

记录与容错：每步留痕，支持断点续传

同步过程生成三类日志：

• summary.log：汇总统计（共处理 X 文件，更新 Y 个，跳过 Z 个）
• details.log：逐行记录每个文件的操作类型、路径、哈希变化、耗时
• backup_manifest.json（启用备份时）：记录被覆盖文件的原始路径、备份路径、原始哈希，便于回滚

若中途失败，脚本可读取 details.log 最后一行，定位上次完成项，支持从该位置继续（需额外加偏移参数）。

使用示例：一行命令完成日常同步

封装为命令行工具，例如：

python sync_code.py --src ./v2.1 --dst ./prod --mode safe --log-dir ./logs

支持参数：--dry-run（预览）、--backup（启用备份）、--exclude "*.pyc,__pycache__"（忽略模式）。配置文件（sync_config.yaml）可预设常用路径和规则，避免重复输入。

基本上就这些。不复杂但容易忽略细节——比如大文件哈希性能、中文路径编码、符号链接处理。把哈希比对做扎实，后续所有策略才有意义。