必须用svn原生重命名机制才能保留历史记录，即通过tortoisesvn右键→重命名或命令行svn move执行原子性移动操作，并立即提交父目录，严禁直接在资源管理器改名后提交。
直接在资源管理器里改名再提交，SVN会把文件当作全新对象处理，历史记录就断了。要保留全部修改日志，必须用SVN原生的重命名机制——本质是原子性的“移动+记录”，不是简单改名。
图形界面操作（TortoiseSVN）
这是最常用也最直观的方式，适用于日常开发场景：
- 右键点击待重命名的文件或文件夹 → 选择 TortoiseSVN → 重命名（不是系统自带的“重命名”）
- 在弹出框中输入新名称，确认后文件图标会变成红色“已修改”状态
- 必须对包含该文件/文件夹的父目录执行提交（单独提交该文件会失败）
- 提交时填写有意义的日志，例如“rename utils.py to helpers.py”
- 重命名文件夹后不要做其他操作，立即提交；否则更新时可能引发树冲突
命令行操作（svn move）
适合批量处理、CI脚本或无GUI环境：
- 先切换到工作副本根目录或目标文件所在目录
- 执行：svn move old_name new_name（支持相对路径，如
svn move src/old/ src/new/） - 这条命令会同时标记删除旧路径、添加新路径，本地状态即更新
- 随后运行：svn commit -m "rename..."，-m 参数不可省略
- 注意：svn move 是原子操作，不能拆成 svn delete + svn add，否则历史会丢失
关键注意事项
很多问题其实源于忽略这些细节：
- 大小写敏感：在Linux服务器上，a.txt 和 A.txt 是两个不同文件，重命名前务必确认库中不存在同名但大小写不同的项
- 未提交的本地修改：操作前确保工作副本干净，否则重命名可能和已有变更产生冲突
- 一次性重命名多个项：不建议批量操作多个文件或嵌套文件夹，容易触发校验失败或状态错乱
- 查看历史：重命名后想追溯原始记录，可用 svn log --stop-on-copy 文件路径，它会停在复制起点
常见异常与应对
遇到报错不用慌，多数情况有明确解法：
- 提示“拒绝访问”或“node not found”：通常是目标路径不在版本控制下，检查父目录是否已纳入SVN，或路径拼写是否有误
- 更新后出现两个同名文件夹（旧名+新名）：说明只提交了 rename，没删旧引用，需手动右键旧文件夹 → Revert 或 Delete 后再次提交
- 提交失败后状态混乱：执行 svn cleanup 清理工作副本锁，再重新操作
