如何为SVN Dump文件添加导入时会被忽略的注释？

数据老陈

2026-5-15

如何在SVN Dump文件中添加不影响导入的注释？

当然可以给SVN Dump文件加手动操作注释，但你之前用的方式不符合SVN Dump的格式规范，才触发了报错。

SVN Dump文件有严格的格式规则：每一行要么是键: 值格式的头部字段，要么是空行，要么是节点内容/属性数据。你写的## 我的手动操作提示 ##既不是合法的键值头字段（缺少冒号分隔），也不符合注释规范，所以svnadmin load会把它判定为畸形的头部信息，直接抛出错误。

这里有两种靠谱的方式添加会被导入工具忽略的注释：

用#开头的单行注释（官方支持）
SVN的svnadmin load命令会自动忽略所有以#开头的行，这是官方预留的注释方式。不过要注意注释的位置：
- 可以放在Dump文件的最开头
- 可以放在两个版本记录、或者两个节点记录之间的空行区域
- 绝对不能插在某一个记录的头部字段中间（比如Revision-number:和Prop-content-length:这类行之间），否则还是会触发格式错误
举个正确的示例：
```
# 2024-05-20 手动修改：调整版本10的节点路径，修复导入冲突
SVN-fs-dump-format-version: 3

# 开始导入版本10
Revision-number: 10
Prop-content-length: 156
Content-length: 156
...
```
临时嵌入注释到属性块（不推荐，会被导入）
如果你想给某个版本加关联注释，也可以把内容塞进版本的svn:log属性里，但这样注释会被永久导入到SVN仓库中，不是被忽略的临时备注。如果只是记录自己的手动操作细节，还是用第一种#注释的方式更合适。