如何使用SVN对StarUML 5项目及UML图表进行版本管理

完全可以基于SVN实现StarUML UML图表的全流程变更追踪，核心前提是你使用的是StarUML 2.0及以上版本——该版本之后的StarUML项目文件（.mdj后缀）本质是结构化JSON纯文本，不是不可读的二进制格式，SVN可以直接识别文本差异，支持逐行比对、冲突合并，完全能满足单张图表粒度的版本管理需求。

• 搭建SVN仓库标准目录结构
  建议给UML资产单独建SVN仓库，或者在现有仓库下开辟独立目录，不要和业务代码混放，推荐结构如下：

  uml-assets/
  ├── trunk/    # 主干，存放当前迭代正式生效的所有UML图表
  ├── branches/ # 分支，存放架构重构、大需求迭代阶段的临时修改版本
  └── tags/     # 标签，存放对应版本发版节点的UML快照归档
  

• 配置本地提交忽略规则
  StarUML运行时会生成本地缓存、临时备份文件，这类文件不需要提交到仓库，在项目根目录新建.svnignore文件写入以下忽略规则：

  *.tmp
  *.backup
  ~$*.mdj
  .DS_Store
  Thumbs.db
  

  执行命令配置SVN忽略属性：svn propset svn:ignore -F .svnignore .
• 规范提交与追踪操作
  • 每次提交只对应单一变更点，提交说明必须明确标注修改的图表名称、变更内容，比如“调整订单创建流程时序图的超时节点配置”“新增数据权限模块类图”，不要用“更新UML”这类模糊描述。
  • 查看历史变更时直接执行svn diff [版本号] [文件路径]，就能看到.mdj文件的逐行差异，对应JSON结构里的diagram节点、图元属性变化，就能精准定位到某张图的具体修改点。
  • 多人协作场景下，提交前先执行svn update拉取最新远端版本，若出现文本冲突，直接对比冲突段的JSON内容，确认两边修改后合并即可，不会出现二进制文件冲突只能整份覆盖的问题。

• 不需要把单张UML图拆成独立文件存储，保持单项目一个.mdj主文件即可。StarUML的JSON结构会给每张图表分配独立的节点ID，SVN的差异比对可以自动定位到单张图的变更，拆成零散文件反而会提高维护成本。
• 每次给代码版本打tag时，同步给UML仓库打对应tag，备注清楚该版本的架构、需求对应关系，后续回溯版本演进时可以直接拉取对应快照，不用逐翻提交记录。
• 做变更评审时，可以直接导出SVN生成的diff片段，评审人不需要打开StarUML就能确认具体修改的元素，评审效率比传递整份项目文件高很多。

注意：如果你用的是StarUML 1.x老版本，项目文件为二进制格式，SVN只能存储文件快照、无法比对细粒度变更，建议先升级到2.0以上版本再做版本化管理。

内容的提问来源于stack exchange，提问作者Frank