在SVN（Subversion）版本控制系统中，cleanup命令用于修复工作副本（Working Copy）中的异常状态，例如因操作中断（如断电、进程强制终止）导致的锁定问题或未完成的事务，以下是详细的使用指南：
命令语法
svn cleanup [工作副本路径] [选项]
- 工作副本路径：可选参数，指定需清理的目录（默认为当前目录）。
- 常用选项：
--remove-unversioned：删除所有未版本控制的文件（慎用！）。--remove-ignored：删除被忽略的文件（如编译生成的临时文件）。--vacuum-pristines：清理冗余的缓存文件以释放空间。
使用场景与步骤
场景1：修复锁定问题
当执行svn update或svn commit时出现错误：
svn: E155004: Working copy 'xxx' locked解决步骤：
- 进入报错目录：
cd /path/to/your/working_copy
- 执行清理：
svn cleanup
SVN会自动释放锁并恢复事务一致性。
场景2：清理未版本控制的文件
删除工作副本中所有未添加到版本库的文件（如临时文件、编译产物）：
svn cleanup . --remove-unversioned
注意：此操作不可逆！建议先备份或确认文件无用。
场景3：深度清理（释放磁盘空间）
删除SVN内部冗余缓存（适用于大型项目）：
svn cleanup . --vacuum-pristines
注意事项
- 权限问题：
确保对工作副本有读写权限,否则清理可能失败。
- 网络操作无关：
cleanup仅修复本地工作副本，不会连接服务器。
- 失败处理：
- 若
cleanup后问题仍存在，尝试：- 重启计算机（释放系统级文件锁）。
- 手动删除
.svn目录中的tmp文件夹（需谨慎操作）。
- 若
- 备份重要数据：
- 使用
--remove-unversioned前，确保无未提交的重要文件。
- 使用
示例流程
# 尝试更新（模拟锁定错误） svn update # 输出错误：svn: E155004: Working copy '/project/trunk' locked # 执行清理 svn cleanup # 重新更新（恢复正常） svn update
何时不需要使用cleanup？
- 正常操作中未出现锁定错误。
- 文件冲突（需手动解决，
cleanup无法处理冲突）。
svn cleanup是修复本地工作副本的核心命令，适用于：
- 解除文件锁定
- 清理未版本控制的冗余文件
- 恢复中断的事务
重要提示：
该命令仅影响本地副本,不会修改版本库历史记录，若问题持续，请参考SVN官方文档或联系系统管理员。
引用说明： 参考Subversion 1.14官方手册（https://svnbook.red-bean.com/），确保信息的准确性与专业性。
原创文章，发布者：酷番叔，转转请注明出处：https://cloud.kd.cn/ask/9472.html
