svn cleanup 是做什么的？

svn cleanup 是一个“清理”或“解锁”命令，当你对 SVN 仓库进行操作（如 update, commit, switch 等）时，如果操作因为某些原因被意外中断（例如网络断开、电脑死机、程序崩溃），SVN 会在你的工作副本中留下一些“锁”或“临时”状态。

这些“锁”会阻止你后续对工作副本进行其他操作，SVN 会提示你“工作副本锁定”或“文件或目录被锁定，可能被其他程序占用”。

svn cleanup 的核心作用就是移除这些由中断操作留下的锁定和临时状态，让你的工作副本恢复到干净、可操作的状态。

何时需要使用 svn cleanup？

当你遇到以下情况时，通常就需要运行 svn cleanup 了：

1. 操作被中断：最常见的场景，比如你正在 svn update，突然断网了，当你重新连接，再次运行 svn update 或其他命令时，SVN 会提示你工作副本被锁定。
2. SVN 进程被强制终止：在 Windows 上，你用任务管理器结束了 svn.exe 进程；在 Linux/macOS 上，你用 kill -9 强制杀掉了 svn 进程，这会导致 SVN 无法正常释放它占用的资源。
3. 遇到“Working copy locked”错误：这是最直接的信号，SVN 明确告诉你，某个工作副本正在被另一个 SVN 进程使用,你需要先清理它。
4. 删除了未版本控制的文件：有时，SVN 在操作过程中会生成一些临时文件（如 .svn/tmp 目录下的文件），如果你不小心删除了这些文件，可能会导致 SVN 状态混乱，运行 cleanup 有时可以修复。

如何使用 svn cleanup？

基本用法

清理当前目录及其所有子目录下的工作副本。

svn cleanup

清理指定目录

如果你想清理另一个路径下的工作副本,可以指定该路径。

svn cleanup /path/to/your/working_copy

强制清理 (--force 或 -f)

这是一个非常重要的选项，默认情况下，svn cleanup 只会清理 SVN 自己留下的“锁”，但如果 SVN 进程崩溃后，有些文件可能被操作系统或其他进程“锁定”了，导致 svn cleanup 本身也无法完成。

这时，就需要使用 --force (或其简写 -f) 选项，它会尝试强制删除这些文件,并释放所有资源。

警告：使用 --force 是安全的，因为它只会删除 SVN 自己产生的临时文件，不会影响你自己的代码文件，但如果你的工作副本本身就有问题（比如文件损坏），强制清理可能会导致数据丢失,所以请确保你了解自己在做什么。

svn cleanup --force

递归清理 (--recursive 或 -r)

svn cleanup 默认就是递归的，会清理指定目录下的所有子目录，所以通常不需要显式地加上 -r，但为了明确意图,你也可以加上。

svn cleanup -r

实际工作流程示例

假设你遇到了问题：

1. 初始状态：你在你的项目目录 my_project 中。

   cd /path/to/my_project

2. 执行更新（被中断）：你开始更新代码,但网络断了。

   svn update
   # 输出类似：Updating '.':
   # A         new_file.txt
   # 然后网络中断，命令卡住或失败。

3. 再次尝试操作（失败）：网络恢复后,你想再次更新。

   svn update
   # 输出错误：svn: E155036: Please execute the 'cleanup' command in '/path/to/my_project' to remove all working copy locks.
   # 或者：svn: E155010: Unable to lock the working directory '/path/to/my_project/.svn'

4. 执行清理：根据错误提示，运行 svn cleanup。

   svn cleanup
   # 如果一切顺利，它会输出：
   # Cleanup took, (real time)

5. 再次尝试操作（成功）：清理完成后，你的工作副本已经解锁，现在可以正常进行任何 SVN 操作了。

   svn update
   # 正常执行更新...

常见问题与解决方案 (FAQ)

问：svn cleanup 之后还是提示锁定怎么办？

答：这通常意味着有另一个 SVN 进程（可能是你之前忘记关闭的，或者是某个 IDE/工具后台运行的）正在占用这个工作副本。

1. 检查并关闭进程：
   • Windows: 打开任务管理器，查找 svn.exe 或 TortoiseSVN 相关进程,并结束它们。
   • Linux/macOS: 在终端运行 ps aux | grep svn 查找 SVN 进程，然后用 kill <PID> 结束它们。
2. 使用强制清理：确保关闭了所有相关进程后，再运行 svn cleanup --force。

问：svn cleanup 会删除我的代码文件吗？

答：绝对不会。svn cleanup 只会清理 SVN 管理的内部文件和锁，它不会、也不能删除你自己的项目文件（如 .java, .py, .txt 等）,它删除的只是临时文件和释放锁。

svn cleanup 是 SVN 用户工具箱中最基础也最重要的命令之一,掌握它能帮你解决绝大多数与工作副本锁定相关的问题。