如何使用TortoiseSVN的离线模式查看本地缓存日志

先说一个很多人问我的问题：TortoiseSVN能不能离线查日志？能，但有前提。它不是那种“完全断网也能凭空变出历史记录”的神器，而是依赖本地缓存——你之前成功连接过服务器、并且下载过日志数据，离线模式下看的其实就是这些缓存。

怎么判断缓存有没有？很简单。右键项目文件夹 → TortoiseSVN → Show Log。如果弹出一个对话框问：“你想使用缓存中的数据吗？”，那就说明缓存确实存在，只是当前网络连不上或者认证失败了。这时候你有两个选择：点“立即离线”，这次用完就算；或者点“永远离线”，TortoiseSVN会记住你的偏好，以后默认就走缓存模式，省得每次都多问一句。

但要注意，如果你之前从来没成功加载过日志——比如刚拉下项目、或者缓存被人清空了——那离线模式下就是一片空白，或者显示“No log entries found”。说白了，缓存只存了你过去实际浏览过的那部分历史，不是整个仓库的完整日志。

手动触发缓存重建

有时候缓存文件本身可能损坏或者过期，导致离线日志不完整。遇到这种情况，可以主动刷新缓存试试：

• 右键项目 → TortoiseSVN → Revision Graph，等图表加载完成（哪怕只显示几条分支线就行），然后关闭窗口。
• 再执行一次 Show Log，系统通常会自动触发一次后台缓存同步。
• 如果还是不行，进 Settings → Sa ved Data，找到“Log cache”对应的 Clear 按钮，点一下清空缓存，之后再重新加载一次日志。

这套操作下来，缓存基本就能恢复正常状态。

离线状态下能看哪些内容

缓存日志里到底存了什么？以下字段是完整的——前提是当初加载时服务器确实返回了这些信息：

• 版本号（Revision）、作者（Author）、提交时间（Date）
• 完整的日志消息（Message），包括换行和中文，只要当时编码正常就没问题
• 变更文件列表（Paths），但注意，这里只显示文件名和路径，不提供具体的差异内容（diff）
• 关联的分支或标签信息，比如来自 trunk 还是 branches/release-v2

需要特别提醒的是：离线模式下你无法查看某次提交的具体文件内容差异，也不能还原旧版本，更跳不到那些从未加载过的远古修订版本。能做的基本就是看看“谁、在什么时候、改了哪些文件、说了什么”，对于日常快速回顾来说够用了。

让离线日志更实用的小技巧

既然离线模式依赖缓存，那最好的办法就是“提前喂饱它”。日常使用中养成几个习惯，能让断网时的体验好得多：

• 定时打开 Show Log，并手动滚动到底部，让 TortoiseSVN 自动加载更多页。默认情况下它只缓存最近100条，拉到底会自动追加，这样离线时能看到的范围就更广。
• 在 Settings → Log Cache 中勾选“Cache log messages for all revisions”（需要较新版本支持），启用全量缓存——一劳永逸。
• 配合 tsvn:logtemplate 模板使用，确保每次提交都带结构化信息。离线查阅时，清晰的日志格式能帮你快速定位关键修改。

说到底，离线模式只是个“查不了新数据”的状态，而不是“完全没法用”的状态。真正的问题在于你的缓存有没有提前准备好——日常用的时候顺手加载一下，关键时刻就能省不少事。