SVN 分支管理最佳实践 & SVN 与 Git 命令对照表

liuluyang530

780人浏览 · 2026-06-17 13:57:10

liuluyang530 · 2026-06-17 13:57:10 发布

第一部分：SVN 分支管理最佳实践

一、标准目录结构（约定优于配置）

SVN 本身不强制目录结构，但业界公认的标准布局是 trunk / branches / tags 三件套：

repository/
├── trunk/                    # 主干：主开发线，始终保持可用
│   ├── rtl/
│   ├── verification/
│   └── docs/
├── branches/                 # 分支：并行开发
│   ├── feature_uart/         # 特性分支
│   ├── bugfix_clk_issue/     # 缺陷修复分支
│   └── dev_team_a/           # 团队/个人分支
└── tags/                     # 标签：只读版本快照
    ├── v1.0_tapeout/         # 流片版本
    ├── v1.1_release/
    └── milestone_rtl_freeze/

大型项目（多模块）布局

repository/
├── project_soc/
│   ├── trunk/
│   ├── branches/
│   └── tags/
├── project_ip_uart/
│   ├── trunk/
│   ├── branches/
│   └── tags/
└── ...

每个独立可发布单元（IP/子系统）拥有自己的 trunk/branches/tags。

二、三类目录的职责

目录	职责	规则
trunk	主开发线，集成所有功能	保持随时可编译/可仿真，不放未完成的破坏性代码
branches	隔离开发，不影响主干	特性、修复、实验都在分支进行，完成后合并回 trunk
tags	版本快照，只读	创建后绝不修改，仅用于标记里程碑/发布/流片

三、分支策略（何时建分支）

1. 特性分支（Feature Branch）

为新功能开发创建，避免半成品污染主干：

svn copy https://repo/trunk \
         https://repo/branches/feature_axi_dma \
         -m "create feature branch for AXI DMA"

适用：开发周期长、影响范围大的新功能。

2. 缺陷修复分支（Bugfix Branch）

针对已发布版本修 bug，不引入主干新功能：

svn copy https://repo/tags/v1.0_release \
         https://repo/branches/bugfix_v1.0_clk \
         -m "fix clock bug on v1.0"

3. 发布分支（Release Branch）

发布前稳定化，主干可继续开发新功能：

svn copy https://repo/trunk \
         https://repo/branches/release_v2.0 \
         -m "create release branch v2.0"

4. 个人/团队分支

大团队隔离工作，减少互相干扰（但要定期同步主干）。

四、分支生命周期管理

         创建分支               定期同步trunk            合并回trunk        删除分支
trunk ─────●──────────────────────────●─────────────────────●──────────────►
            \                         ↑                     ↗
             \                   (merge trunk→branch)      /
branch        ●──────●──────●──────────────────●──────────●
              开发    开发    开发              开发完成

1. 创建分支

svn copy <trunk-url> <branch-url> -m "说明"
svn switch <branch-url>           # 切换工作副本到分支

2. 在分支上开发

# 正常 update / commit
svn up
svn ci -m "develop on branch"

3. 定期同步主干改动到分支（关键！）★

最重要的最佳实践：分支要定期合并 trunk 的更新，避免最后合并时冲突爆炸。

# 在分支工作副本中
svn merge https://repo/trunk         # 把 trunk 的新改动合进当前分支
svn ci -m "sync trunk changes to branch"

4. 分支合并回主干

# 切换到 trunk 工作副本
svn switch https://repo/trunk
svn up

# 合并分支（SVN 1.5+ 自动跟踪合并历史）
svn merge https://repo/branches/feature_axi_dma
svn ci -m "merge feature_axi_dma into trunk"

5. 删除已合并的分支

svn delete https://repo/branches/feature_axi_dma \
           -m "remove merged branch"

删除不丢历史，需要时可从历史版本恢复。

五、合并（Merge）的关键技巧

1. SVN 1.5+ 的自动合并跟踪

SVN 1.5 起引入 mergeinfo 属性，自动记录已合并的版本，避免重复合并：

svn merge <branch-url>            # 自动合并未合并的部分
svn mergeinfo <branch-url>        # 查看合并状态
svn mergeinfo --show-revs eligible <branch-url>  # 查看待合并版本

2. 合并指定版本范围

svn merge -r 100:150 <branch-url>     # 合并版本100到150
svn merge -c 120 <branch-url>         # 只合并版本120这一次提交
svn merge -c 120,125,130 <branch-url> # 合并多个特定版本

3. 反向合并（撤销某次提交）

svn merge -c -120 <url>               # 撤销版本120的改动（负号）
svn merge -r 120:119 <url>            # 等效写法

4. 预演合并（试运行，不实际改动）★

svn merge --dry-run <branch-url>      # 只显示会发生什么，不真正合并

强烈建议：正式合并前先 --dry-run 看看影响范围。

5. 合并后必检

svn status                        # 查看冲突和改动
# 解决冲突...
svn diff                          # 确认合并结果正确
# 编译/仿真验证后再提交
svn ci -m "merge xxx"

六、Tag 标签最佳实践

1. 创建标签（里程碑/流片）

svn copy https://repo/trunk \
         https://repo/tags/v1.0_tapeout_20240115 \
         -m "tag for v1.0 tapeout"

2. Tag 命名规范建议

场景	命名示例
版本发布	v1.0, v2.1.3
流片	v1.0_tapeout_20240115
RTL 冻结	rtl_freeze_milestone1
回归基线	regression_baseline_w12

3. Tag 铁律

⚠️ Tag 创建后绝对不要修改！ Tag 是某一时刻的只读快照，修改 tag 会破坏可追溯性。如需基于 tag 改动，应从 tag 创建分支。

# 从 tag 创建修复分支（正确做法）
svn copy https://repo/tags/v1.0 \
         https://repo/branches/fix_v1.0 \
         -m "branch from v1.0 for hotfix"

七、芯片团队特有最佳实践

实践	说明
流片打 Tag	每次 tapeout 必须打 tag，永久固化版本
RTL 冻结 Tag	验证/后端介入前冻结 RTL 版本
回归基线管理	每周/每日回归对应一个 tag/revision，便于复现
二进制文件锁定	库/版图/文档在分支上也要 svn lock
分支命名带日期/负责人	如 dev_zhang_20240115，便于管理
大文件慎合并	二进制不可 merge，分支策略上避免多分支同改一个二进制

八、分支管理常见误区与建议

误区	正确做法
长期不合并 trunk	定期同步，至少每周一次
分支存活过久	功能完成尽快合并并删除，避免"僵尸分支"
直接在 trunk 上做大改动	大改动开分支，保护主干稳定
修改 tag	tag 只读，要改就从 tag 开分支
不写合并说明	合并提交注明来源分支和版本范围
合并前不 dry-run	先 --dry-run 预演
合并后不验证	合并后编译/仿真通过再提交

第二部分：SVN 与 Git 命令对照表

一、核心概念差异（先理解再对照）

维度	SVN	Git
架构	集中式（中央仓库）	分布式（每人完整仓库）
提交	直接提交到中央服务器	先本地 commit，再 push 到远程
版本号	全局递增整数（r123）	40 位哈希（a3f5e9c...）
离线工作	受限（需连服务器）	完全支持
分支成本	较重（服务器端副本）	极轻量（指针）
暂存区	无	有（staging area）

最大区别：Git 的 commit 是本地操作，需要 push 才到远程；SVN 的 commit 直接到中央服务器。

二、基础操作对照

操作	SVN	Git
获取仓库	svn checkout <url>	git clone <url>
更新代码	svn update	git pull
查看状态	svn status	git status
查看差异	svn diff	git diff
添加文件	svn add <file>	git add <file>
删除文件	svn delete <file>	git rm <file>
移动/重命名	svn move <a> <b>	git mv <a> <b>
提交	svn commit -m "msg"	git commit -m "msg" + git push
查看历史	svn log	git log
查看文件历史	svn log <file>	git log <file>
逐行作者	svn blame <file>	git blame <file>

三、提交流程对照（核心差异）

SVN（两步）

svn add new.v               # 1. 添加新文件
svn commit -m "add new.v"   # 2. 直接提交到服务器

Git（四步）

git add new.c               # 1. 添加到暂存区
git commit -m "add new.c"   # 2. 提交到本地仓库
git pull                    # 3. 同步远程（合并）
git push                    # 4. 推送到远程仓库

SVN 一次 commit = Git 的 commit + push。

四、撤销操作对照

操作	SVN	Git
撤销工作区改动	svn revert <file>	git checkout -- <file><br>或 git restore <file>
撤销所有改动	svn revert -R .	git checkout -- .<br>或 git restore .
撤销暂存	（无暂存区概念）	git reset HEAD <file><br>或 git restore --staged <file>
撤销某次提交	svn merge -c -N .	git revert <commit>
回退到旧版本	svn up -r N	git reset --hard <commit>
清理锁定	svn cleanup	（一般不需要）

五、分支与标签对照

操作	SVN	Git
创建分支	svn copy <trunk> <branch> -m "..."	git branch <name>
切换分支	svn switch <branch-url>	git checkout <name><br>或 git switch <name>
创建并切换	svn copy ... + svn switch ...	git checkout -b <name>
查看分支	svn list <branches-url>	git branch
合并分支	svn merge <branch-url>	git merge <branch>
删除分支	svn delete <branch-url> -m "..."	git branch -d <name>
创建标签	svn copy <trunk> <tag> -m "..."	git tag <name>
查看标签	svn list <tags-url>	git tag

关键差异：SVN 的分支/标签本质是目录拷贝（用 copy 命令）；Git 的分支是轻量指针，标签是特定提交的引用。

六、查看与比较对照

操作	SVN	Git
查看仓库文件内容	svn cat <url>	git show <commit>:<file>
列出远程内容	svn list <url>	git ls-tree <branch>
比较两版本	svn diff -r 100:200	git diff <c1> <c2>
比较分支	svn diff <url1> <url2>	git diff <b1> <b2>
合并预演	svn merge --dry-run	git merge --no-commit --no-ff
查看合并状态	svn mergeinfo <url>	git log --merges

七、冲突处理对照

操作	SVN	Git
冲突标记	状态 C	状态 UU（both modified）
解决后标记	svn resolve --accept working <file>	git add <file>
用我的版本	svn resolve --accept mine-full	git checkout --ours <file>
用对方版本	svn resolve --accept theirs-full	git checkout --theirs <file>

八、忽略文件对照

SVN

svn propset svn:ignore "*.log" .
svn propset svn:ignore -F ignore_list .

Git

# 创建 .gitignore 文件，写入：
*.log
*.o
build/

Git 用 .gitignore 文件（更直观）；SVN 用 svn:ignore 属性。

九、独有命令（无直接对应）

SVN 独有

命令	功能	Git 类比
svn lock/unlock	文件加锁（独占编辑）	git lfs lock（需 LFS）
svn cleanup	清理工作副本锁	一般不需要
svn co <子目录>	部分检出	git sparse-checkout（较新）

Git 独有

命令	功能	SVN 类比
git stash	临时储藏改动	无（只能用补丁）
git rebase	变基	无
git cherry-pick	挑拣单个提交	svn merge -c N 类似
git reflog	引用日志	无
git add -p	部分暂存	无
git push/pull	远程同步	SVN 自动（集中式）

十、典型工作流对照

日常修改提交

SVN：

svn up                          # 更新
# 修改文件...
svn st                          # 看状态
svn ci -m "fix bug"             # 提交（直接到服务器）

Git：

git pull                        # 更新
# 修改文件...
git status                      # 看状态
git add .                       # 暂存
git commit -m "fix bug"         # 本地提交
git push                        # 推送到远程

创建特性分支开发

SVN：

svn copy <trunk> <branch> -m "new feature"
svn switch <branch>
# 开发、提交...
svn switch <trunk>
svn merge <branch>
svn ci -m "merge feature"

Git：

git checkout -b feature
# 开发、提交...
git checkout main
git merge feature
git push

十一、思维方式转换提示

如果你习惯 SVN，用 Git 要记住	如果你习惯 Git，用 SVN 要记住
commit 是本地的，要 push 才上传	commit 直接上传到服务器
分支是廉价的，随便建	分支是目录拷贝，相对重
有暂存区，先 add 再 commit	没有暂存区，add 只针对新文件
版本是哈希，不是递增数字	版本是全局递增整数
用 .gitignore 文件	用 svn:ignore 属性
pull = fetch + merge	update 直接合并

十二、命令对照速查表（汇总）

功能	SVN	Git
检出/克隆	svn co <url>	git clone <url>
更新	svn up	git pull
状态	svn st	git status
添加	svn add	git add
提交	svn ci -m	git commit -m + git push
差异	svn diff	git diff
日志	svn log	git log
撤销改动	svn revert	git restore
删除	svn rm	git rm
移动	svn mv	git mv
建分支	svn copy	git branch
切分支	svn switch	git switch
合并	svn merge	git merge
打标签	svn copy ...tags/	git tag
作者追溯	svn blame	git blame
加锁	svn lock	git lfs lock