这是一款面向 Windows 用户的「系统目录智能迁移」工具，核心功能是把 桌面、文档、下载、图片、视频、音乐、收藏夹 等用户目录，从 C 盘搬到自定义的目标盘，同时通过修改注册表让系统识别新位置。对 SSD 容量吃紧的用户来说，这是个刚需。
我上次优化这个项目是在 2026 年 9 月 3 日。那次我们统一了版本号、修了 UPX 打包警告、修了 NSIS 的 BOM 编码问题，并加了一条「迁移不全就不改注册表」的保护。
这是一款面向 Windows 用户的「系统目录智能迁移」工具，核心功能是把 桌面、文档、下载、图片、视频、音乐、收藏夹 等用户目录，从 C 盘搬到自定义的目标盘，同时通过修改注册表让系统识别新位置。对 SSD 容量吃紧的用户来说，这是个刚需。
我上次优化这个项目是在 2026 年 9 月 3 日。那次我们统一了版本号、修了 UPX 打包警告、修了 NSIS 的 BOM 编码问题，并加了一条「迁移不全就不改注册表」的保护。
但近两个月陆续收到自己和朋友的反馈，核心就一句话："没有真实迁移。"
具体表现有两类：
原路径下还保留着同名目录——C 盘里的 桌面 文件夹还在，文件也没少。
目标路径下只建了一个同名空文件夹——比如 D:\UserData\桌面 存在，但里面啥都没有，也不是真正的系统目录。
迁移工具没真正把文件搬过去，这是致命问题。我开始翻代码。
迁移的主流程在 core/folder_mover.py 的 migrate_folder。它的逻辑是：从注册表读出当前路径 → 把该路径作为源目录 → 复制到目标 → 删源 → 改注册表。
问题在于，程序从头到尾没有校验"注册表里的路径是否真的存在、里面是否真的有文件"。
更糟的是，move_folder_contents 的执行顺序是这样的：
# 先建目标目录 Path(target).mkdir(parents=True, exist_ok=True) # 再判断源是否存在 if not os.path.exists(source): return True # 源不存在也返回成功于是当注册表指向的路径已经失效——比如上次迁移的盘符被拔掉、目标目录被删了、路径被手动改了——就会发生：
在目标盘建一个空文件夹（mkdir 成功）
发现源不存在，直接 return True
migrate_folder 拿到 True，高高兴兴地改了注册表
结果就是目标盘只剩一个空壳目录，C 盘的真实文件纹丝不动，注册表却已经被重定向。用户看到的正是"只建空文件夹 + 原路径文件还在"。
这就是两个现象的共同根因。
此外还有几个叠加因素，让"部分迁移"也时有发生：
os.walk 默认会吞掉无权限错误，整棵子树被静默跳过，文件一个没搬却报告成功；
只读文件（如 desktop.ini）在 os.remove 时必然失败，导致文件留在原地；
超过 260 字符的长路径直接报错；
没有"源目录 == 目标目录"的防呆，极端情况下可能自毁。
我把 folder_mover.py 的迁移逻辑整体重写了，但接口不变。核心思路是：只有文件真正搬完、源目录真正清空，才允许改注册表。
新增了 resolve_source_path，按优先级依次尝试「注册表当前路径」→「系统默认路径（%USERPROFILE%\xxx）」，优先返回"存在且确实有文件"的那个。
@staticmethod def resolve_source_path(folder_key, current_path): candidates = [current_path, RegistryHandler.get_default_path(folder_key)] existing = [p for p in candidates if os.path.isdir(p)] with_content = [p for p in existing if FolderMover._scan(p)[0] > 0] return with_content[0] if with_content else (existing[0] if existing else candidates[0])这是修复"假迁移"最关键的一笔——注册表路径失效时，自动去 C:\Users\<用户>\桌面 把真实文件搬过来。
move_folder_contents 改成：源目录不存在 / 没有文件 / 无法完整读取 → 直接失败，不创建目标目录。
total_files, scan_errors = self._scan(source) if total_files == 0: self.last_error = "源目录中没有任何文件" if not scan_errors else f"源目录无法完整读取（{scan_errors} 个子目录无权限）" return False # 确认有内容后才创建目标目录 Path(target).mkdir(parents=True, exist_ok=True)这是修复"假迁移"最关键的一笔——注册表路径失效时，自动去 C:\Users\<用户>\桌面 把真实文件搬过来。
move_folder_contents 改成：源目录不存在 / 没有文件 / 无法完整读取 → 直接失败，不创建目标目录。
total_files, scan_errors = self._scan(source) if total_files == 0: self.last_error = "源目录中没有任何文件" if not scan_errors else f"源目录无法完整读取（{scan_errors} 个子目录无权限）" return False # 确认有内容后才创建目标目录 Path(target).mkdir(parents=True, exist_ok=True)这就杜绝了"目标盘只剩空文件夹"的情况。
搬完之后不是直接宣布成功，而是再扫一遍源目录：
residual_files, residual_errors = self._scan(source) if residual_files > 0 or residual_errors > 0: self.last_error = f"源目录仍有 {residual_files} 个文件未迁出" return False同时 _scan 用 onerror 显式统计无法访问的子目录数量，不再让 os.walk 静默吞错。只要源目录还有文件残留，就判定迁移失败，注册表保持原状。
移动文件时先 os.chmod(src, stat.S_IWRITE) 解除只读属性，再 os.remove；
_long_path 对超过 240 字符的路径自动加 \\?\ 前缀；
_same_path 判断源 == 目标时直接拒绝，防止自毁。
新增 failure_reasons 字典，按文件夹记录真实失败原因（"源目录不存在""源目录中没有任何文件""源目录仍有 N 个文件未迁出"等），弹窗里逐项展示，用户一眼就能知道哪个文件夹为什么没成功，而不是只看到一个模糊的"部分完成"。
修完核心逻辑，还有两个体验问题：
原来迁移在 UI 线程同步执行，文件多时主窗口直接卡死，用户只能干等。我新增了 MigrationWorker(QThread)，把耗时的文件搬移放到子线程，进度和状态通过 Qt 信号回主线程更新：
class MigrationWorker(QThread): progress_changed = Signal(int) status_changed = Signal(str) finished_ok = Signal(dict) finished_err = Signal(str) ...驱动备份（FileRepository）有两个模式："备份"（System32 → 目标盘）和"恢复"（从备份回到系统）。但原代码对两个模式都执行 copy_file_repository(System32 → 目标盘)，导致"恢复"时又把系统驱动备份了一遍，方向完全反了。
修复方式很直接：当 mode == "restore" 时，把 FileRepository 从迁移任务中剔除，改走 handle_driver_restore（打开设备管理器 + 引导弹窗，由用户手动安装驱动）；"备份"模式行为不变。确认弹窗的文案也改成了"恢复本机驱动 ← 备份位置 …"，方向一目了然。
我写了两套沙箱测试脚本（全部放在 %TEMP%，测完删除，不污染项目）。
迁移逻辑测试（20 项全过）：源目录不存在、注册表路径失效回退到默认路径、源==目标、文件被占用、源目录为空、正常迁移——前五类场景均"不改注册表、不建空目录"。
线程与驱动方向测试（8 项全过）：后台线程迁移成功、进度信号正常、状态信号正常、源目录删除、恢复模式走引导流程且不执行文件复制、按钮状态恢复、备份模式仍正常复制。
之后重新打包（v1.4.013），冒烟启动 8 秒正常，日志确认 程序启动 v1.4.013。
这次修复给我的几点教训：
永远不要盲目信任外部数据源——注册表的值可能是过期的、可能指向不存在的路径。读出来之后必须做存在性校验和内容校验，校验不过就要么回退、要么明确失败。
"成功"的定义要严格——对迁移来说，"成功"的硬指标就是源目录被清空。只创建了目标目录、只复制了部分文件，都不能算成功，更不能据此改注册表。
静默错误是隐形杀手——os.walk 默认吞掉权限错误，会让"什么都没搬"伪装成"搬完了"。凡是可能静默失败的遍历操作，都要显式统计错误。
方向要明确——备份和恢复是相反操作，不能用同一条路径硬套。确认弹窗的文案方向（→ 还是 ←）也应该和实际行为一致，避免误导。
耗时操作必须离开 UI 线程——这是桌面应用的基本素养，否则再对的逻辑也会被"卡死"体验毁掉。
请 登录 后发表评论。
暂无评论，来说两句吧...