SVN如何进行版本控制管理

SVN版本控制管理全流程指南

一、SVN版本控制基础准备

SVN（Subversion）是一种集中式版本控制系统，核心功能是通过**版本库（Repository）**存储项目文件的所有历史版本，实现变更追踪、团队协作与版本回溯。在使用SVN前，需完成以下基础准备：

1. 安装SVN服务器与客户端

• 服务器端：根据操作系统选择安装包（如Linux通过sudo apt-get install subversion安装，Windows可使用TortoiseSVN或VisualSVN Server）。
• 客户端：Windows推荐TortoiseSVN（图形界面），Linux/macOS可使用命令行工具svn或Eclipse/IntelliJ IDEA等IDE的SVN插件。

2. 创建版本库（Repository）

版本库是SVN的核心，用于存储项目文件及历史记录。创建步骤如下：

• 在服务器上选择存储路径（如/var/svn或D:\svn_repos），执行命令：

  svnadmin create /path/to/repository_name
  

  执行后，系统会生成包含conf（配置文件）、db（数据库）、hooks（钩子脚本）等目录的版本库。

二、项目导入与本地工作副本获取

1. 导入项目到版本库

将本地项目文件导入版本库，初始化版本历史。命令格式：

svn import /local/project/path file:///path/to/repository_name/trunk -m "Initial import"

• file:///path/to/repository_name/trunk：指定版本库中的trunk目录（主开发线）。
• -m：提交信息，需简要描述导入内容（如“项目初始版本”）。

2. 检出项目到本地

开发者从版本库获取项目副本（工作副本），用于本地修改。命令格式：

svn checkout file:///path/to/repository_name/trunk /local/working_copy_path

或通过TortoiseSVN右键选择“Checkout”，输入版本库URL与本地目录路径。

三、日常版本控制操作

1. 修改与提交文件

• 修改文件：直接编辑本地工作副本中的文件，保存后文件会标记为“修改”状态（命令行中用svn status查看，图形界面中文件图标带感叹号）。
• 提交更改：将本地修改同步到版本库，命令：

  svn commit -m "Describe your changes (e.g., Fix login bug)"
  

  提交前建议先执行svn update（见下文），避免冲突。

2. 更新本地副本

从版本库获取最新版本，同步团队成员的修改。命令：

svn update

• 更新后会自动合并他人修改与本地修改（无冲突时）；若有冲突，需手动解决（见下文）。

3. 查看变更历史

• 查看提交记录：使用svn log命令，显示每次提交的版本号、作者、时间及信息。
• 查看文件差异：使用svn diff命令，对比本地修改与版本库版本的差异（如svn diff filename）。

四、分支与标签管理

1. 分支（Branch）：并行开发

分支是主开发线（trunk）的副本，用于开发新功能或修复bug，不影响主干稳定性。

• 创建分支：从trunk复制到branches目录，命令：

  svn copy file:///path/to/repository_name/trunk file:///path/to/repository_name/branches/new_feature -m "Create new feature branch"
  

• 切换分支：使用svn switch命令将本地工作副本切换到分支（如svn switch file:///path/to/repository_name/branches/new_feature）。
• 合并分支：将分支修改合并回trunk，命令：

  svn switch file:///path/to/repository_name/trunk  # 先切换到trunk
  svn merge file:///path/to/repository_name/branches/new_feature  # 合并分支
  

  合并后需解决冲突（见下文）。

2. 标签（Tag）：版本快照

标签用于标记项目的重要版本（如发布版、里程碑），是只读的，防止误修改。

• 创建标签：从trunk复制到tags目录，命令：

  svn copy file:///path/to/repository_name/trunk file:///path/to/repository_name/tags/release_1.0 -m "Tag release 1.0"
  

• 查看标签：使用svn list file:///path/to/repository_name/tags命令。

五、冲突解决

当多人同时修改同一文件时，SVN会标记冲突（文件中包含<<<<<<<、=======、>>>>>>>标记）。解决步骤：

1. 更新本地副本：svn update获取最新版本。
2. 手动解决冲突：编辑冲突文件，删除标记，保留正确内容（或合并双方修改）。
3. 标记冲突解决：svn resolved conflicted_file（如svn resolved main.py）。
4. 提交解决结果：svn commit -m "Resolve conflict in main.py"。

六、权限与安全管理

1. 配置用户与权限

• 添加用户：编辑版本库conf/passwd文件，在[users] section添加：

  username = password
  

• 设置权限：编辑conf/authz文件，定义用户/组对目录的访问权限（如[/]表示根目录）：

  [groups]
  developers = user1, user2
  
  [/]
  * = r  # 所有用户可读
  @developers = rw  # developers组可读写
  

• 启用权限：编辑conf/svnserve.conf文件，取消以下注释：

  anon-access = none  # 匿名用户无访问权限
  auth-access = write  # 认证用户可写
  password-db = passwd  # 使用passwd文件存储用户
  authz-db = authz  # 使用authz文件存储权限
  

2. 备份与恢复版本库

• 备份版本库：使用svnadmin dump命令导出版本库数据：

  svnadmin dump /path/to/repository_name > /backup/path/repository_name.dump
  

• 恢复版本库：使用svnadmin load命令导入备份数据：

  svnadmin load /new/path/to/repository_name < /backup/path/repository_name.dump
  

七、最佳实践

• 规范化提交信息：提交时务必填写清晰的描述（如“Fix login page CSS issue”），便于后续追溯。
• 定期更新：开发前先执行svn update，减少冲突概率。
• 合理使用分支：新功能或bug修复使用分支，避免直接影响trunk。
• 定期备份：每周或每日备份版本库，防止数据丢失。