SmartSVN 使用教程

什么是 SmartSVN？

SmartSVN 是一款功能强大且广受欢迎的跨平台 Subversion (SVN) 客户端，它提供了一个直观的图形用户界面，让你无需记忆复杂的命令行指令，就能轻松地管理代码版本、提交、更新、合并等操作。

核心优势：

• 图形化界面： 直观地查看仓库状态、文件差异。
• 智能感知： 能自动检测文件状态（已修改、已添加、冲突等）。
• 强大的合并工具： 提供可视化的合并冲突解决界面。
• 跨平台： 支持 Windows, macOS, Linux。
• 功能集成： 集成了日志查看、分支/标签管理、补丁生成等高级功能。

安装与初次配置

1. 下载与安装

   • 访问官方网站 https://www.smartsvn.com/。
   • 下载适合你操作系统的版本（有免费版和专业版，个人开发免费版功能已足够强大）。
   • 按照安装向导完成安装。

2. 初次启动与配置

   • 首次启动 SmartSVN，会弹出配置向导，你可以选择 "Skip Setup" 稍后配置。
   • 设置你的用户信息： 这是提交代码时用来标识身份的。
     • 菜单栏：Window -> Preferences (macOS: SmartSVN -> Preferences)。
     • 在左侧导航栏中找到 General -> User Information。
     • 输入你的 Name 和 Email，然后点击 OK。

核心操作流程

这是日常开发中最常用的几个步骤,建议按顺序执行。

检出项目

这是你第一次从 SVN 仓库获取代码到本地电脑的步骤。

• 通过欢迎界面

  1. 启动 SmartSVN，点击 "Checkout" 按钮。
  2. 在弹出的对话框中：
     • URL: 输入 SVN 仓库的项目地址 (svn://server.com/project/trunk)。
     • Destination: 选择你希望将代码保存在本地的文件夹路径。
     • Authentication: 如果仓库需要用户名和密码,勾选并填入。
  3. 点击 OK 开始下载。

• 通过菜单栏

  1. 菜单栏选择 Repository -> Checkout...。
  2. 后续步骤与方法一相同。

下载完成后，你会看到一个包含项目文件的文件夹，打开这个文件夹，里面会有一个名为 .svn 的隐藏文件夹,它记录了本地与仓库的关联信息。

更新

在开始修改代码之前，总是先执行更新，以确保你拿到的是最新的版本,避免覆盖他人的修改。

• 操作方法：
  1. 在 SmartSVN 的 "Repositories" 视图中,右键点击你的项目仓库。
  2. 选择 Update。
  3. 或者，直接在你本地项目文件夹的空白处右键，选择 SVN Update。

SmartSVN 会自动下载所有最新的更改，更新完成后，它会显示一个日志,告诉你哪些文件被更新了。

修改与提交

这是你日常工作的核心环节：修改代码并提交到仓库。

• 修改文件：

  • 使用你喜欢的编辑器（如 VS Code, IntelliJ IDEA）打开项目中的文件并进行修改。
  • 重要： 修改完成后，不要直接保存，回到 SmartSVN。

• 查看修改：

  1. 在 SmartSVN 的 "Working Copy" 视图中，你会看到被修改的文件通常以蓝色加粗字体显示。
  2. 右键点击该文件，选择 Show Diff 或 Compare with Repository。
  3. 这会打开一个对比窗口，左边是你的本地修改，右边是仓库中的原始版本,这能帮助你确认修改是否正确。

• 标记要提交的文件：

  1. 在 "Working Copy" 视图中，右键点击你想要提交的文件（或文件夹）。
  2. 选择 Mark for Commit (或直接按快捷键 Ctrl+M / Cmd+M)。
  3. 被标记的文件会变成绿色,并带有一个对勾标记。

• 编写提交信息并提交：

  1. 在下方的 "Commit Message" 输入框中，清晰、简洁地描述你这次修改的内容,这是非常重要的好习惯！
  2. 确保你要提交的文件在列表中（通常已经自动包含）。
  3. 点击上方的 Commit 按钮（或按 Ctrl+T / Cmd+T）。

解决冲突

当你的本地修改和他人提交的修改作用于文件的同一部分时，就会发生冲突,这是协作开发中的常见情况。

• 冲突的识别：

  • 当你执行 Update 时，如果发生冲突，SmartSVN 会提示你。
  • 在 "Working Copy" 视图中，冲突的文件会显示为红色,并有一个感叹号图标。

• 解决冲突的步骤：

  1. 不要直接覆盖！ 首先打开冲突文件查看内容，文件中会有类似以下的标记：

     <<<<<<< .mine
     // 你的代码
     =======
     // 仓库中的最新代码
     >>>>>>> .r12345

  2. 手动编辑： 使用你的编辑器，手动删除这些标记，并保留你需要的代码,或者将两边的代码合并成一个合理的版本。
  3. 使用内置合并工具（推荐）：
     • 在 "Working Copy" 视图中右键点击冲突文件。
     • 选择 Resolve -> Edit Conflict...。
     • SmartSVN 会打开一个可视化的三向合并工具，你可以清晰地看到你的版本、仓库版本和共同祖先版本，通过点击按钮来选择保留哪一部分的代码,非常直观。
  4. 标记冲突已解决：
     • 手动编辑或使用合并工具完成后,右键点击该文件。
     • 选择 Mark as Resolved。
     • 文件的图标会从红色变为正常颜色。
  5. 提交： 你可以像正常修改一样，Mark for Commit 并 Commit 你的解决方案了。

高级功能

查看日志

查看项目或文件的完整修改历史。

• 操作方法：
  • 在 "Repositories" 或 "Working Copy" 视图中,右键点击一个文件或文件夹。
  • 选择 Show Log。
• 日志视图功能：
  • 查看版本详情： 点击任意一个版本号，下方会显示该次提交的详细信息（作者、时间、提交信息）。
  • 查看差异： 选中两个版本，右键选择 Compare Revisions,可以查看这两个版本之间的所有改动。
  • 还原到旧版本： 选中一个旧版本，右键选择 Update to Revision，可以将文件或文件夹还原到那个版本（这不会创建新版本，只是本地回退）。

创建分支与标签

分支用于开发新功能或修复 Bug，标签用于标记重要的版本（如 v1.0, v2.0）。

• 操作方法：
  1. 在 "Repositories" 视图中，右键点击你想要基于哪个路径创建分支/标签的文件夹（通常是 trunk）。
  2. 选择 Branch / Tag...。
  3. 在弹出的对话框中：
     • To URL: 输入新分支或标签的完整路径（svn://server.com/project/branches/my-feature）。
     • Create Copy as: 选择 Branch 或 Tag。
     • Log Message: 为这次创建操作写一个说明。
  4. 点击 OK。

合并

这是分支开发的核心操作，将分支上的修改合并回主干（trunk）或其他分支。

• 操作方法（从分支合并到主干）：
  1. 准备工作： 确保你的本地 trunk 是最新版本 (Update)。
  2. 在 "Repositories" 视图中，右键点击你本地的 trunk 文件夹。
  3. 选择 Merge...。
  4. 在 "Merge" 向导中：
     • Source URL 1: 选择你的分支在仓库中的地址（svn://server.com/project/branches/my-feature）。
     • From Revision: 输入你开始分支时的版本号（可以通过 Show Log 查看）。
     • To Revision: 输入你想要合并到主干之前的最后一个版本号（通常是分支的 HEAD）。
     • Target URL: 会自动填入你本地的 trunk 路径。
  5. 点击 OK，SmartSVN 会计算差异并尝试自动合并。
  6. 检查与提交： 合并后，检查 "Working Copy" 视图中哪些文件被标记为修改，确认无误后，编写提交信息并 Commit,这次提交就是将分支的修改正式集成到了主干。

最佳实践与技巧

1. 先更新，再修改，再提交： 这个流程是协作开发的黄金法则,能有效减少冲突。
2. 写清晰的提交信息： 好的提交信息（如 "Fix bug in user login validation"）能让团队成员快速了解你的工作。
3. 频繁提交： 不要把所有修改攒在一起一次性提交，每天完成一个小功能或修复一个小 Bug 就提交一次。
4. 善用日志： 遇到问题不确定是哪个版本引入的时，第一时间 Show Log。
5. 备份你的工作： 在进行重大修改或合并前，可以先 Export 一个副本作为备份。

常见问题

• Q: 我修改了一个文件，但为什么它在 SmartSVN 里没有变色？

  A: 可能是文件被其他程序锁定，或者你没有在正确的项目文件夹中打开 SmartSVN，确保你的项目是通过 "Checkout" 获取的,并且文件没有被其他编辑器打开。

• Q: Commit 时提示 "Out of date" 是什么意思？

  • A: 表示在你提交之前，有人已经修改并提交了同一个文件，你需要先执行 Update，解决可能出现的冲突，然后再 Commit。

• Q: 我不小心提交了错误的代码，怎么办？

  • A: 不要慌！可以通过 Show Log 找到错误的那个版本，右键选择 Revert to this Revision，这会把你本地的文件恢复到那个提交前的状态，然后你重新修改正确的代码，再提交一次即可，这相当于在历史记录中做了一个“撤销”。

希望这份教程能帮助你快速上手 SmartSVN！多加练习,很快你就能熟练掌握它的所有功能。