SmartSVN for Mac 完整教程

SmartSVN 是一款功能强大且用户友好的图形化 SVN 客户端，特别适合 Mac 用户，它将复杂的 Subversion 命令行操作转化为直观的图形界面，极大地提高了版本控制的工作效率。

本教程将分为以下几个部分：

1. 准备工作：安装和配置。
2. 首次使用：检出项目：如何从 SVN 服务器获取你的第一个项目。
3. 日常核心操作：最常用的更新、提交、解决冲突等。
4. 高级功能与技巧：分支、标签、比较等强大功能。
5. 常见问题与故障排除：解决你可能遇到的问题。
6. 。

准备工作

在开始之前,请确保你的 Mac 环境已经准备就绪。

1 安装 SmartSVN

1. 下载：访问 SmartSVN 官方网站。
2. 选择版本：
   • SmartSVN: 这是商业版，功能最全，需要购买许可证，它提供 30 天的全功能免费试用。
   • SmartSVN-OSX: 这是基于 GPL 的开源版本，功能相对基础，但对于个人用户或简单项目来说完全够用。
3. 安装：下载 .dmg 文件后，将其挂载，将 SmartSVN.app 拖拽到你的 Applications 文件夹即可。

2 首次启动与配置

1. 启动 SmartSVN：从 Applications 文件夹中打开 SmartSVN。
2. 设置许可证：如果是商业版，首次启动时会提示你输入许可证密钥，你可以选择试用或输入已购买的许可证。
3. 配置用户信息：这是非常重要的一步！它将告诉 SVN 是谁在提交代码。
   • 进入菜单栏 SmartSVN -> Preferences... (或使用快捷键 )。
   • 在左侧导航栏中,选择 Subversion -> Configuration。
   • 点击右侧的 Edit... 按钮，会打开一个配置文件。
   • 找到 [helpers] 部分，确保 editor-cmd 和 diff-cmd 已经设置为你熟悉的 Mac 编辑器和比较工具（Sublime Text, VS Code, FileMerge 等）。
   • 返回 Preferences，选择 Subversion -> Authorisation。
   • 你可以配置你的 SVN 用户名和密码，你可以选择在每次操作时输入，或者让 SmartSVN 不推荐在公共电脑上使用记住密码）。

首次使用：检出项目

“检出”是指将 SVN 仓库中的项目下载到你的本地 Mac 上。

1. 启动“检出向导”：

   
   （图片来源网络，侵删）
   • 你可以在欢迎界面点击 Checkout。
   • 或者,在菜单栏选择 File -> New -> Checkout from SVN...。

2. 输入仓库 URL：

   • 在弹出的窗口中,输入你的 SVN 仓库地址。https://svn.example.com/project/trunk。
   • 点击 OK。

3. 认证：

   • 如果你的仓库需要用户名和密码,系统会弹出认证窗口，输入你之前配置好的用户名和密码。
   • 勾选 Save authentication 可以让 SmartSVN 方便下次使用。

4. 选择要检出的路径：

   • SmartSVN 会列出仓库中的目录结构（如 trunk, branches, tags）。
   • 你希望将主开发代码检出到 trunk，选中 trunk。
   • 在下方的 Local Directory 字段中，选择一个本地路径来存放项目，选择你的 Documents 文件夹下的一个新文件夹 MyProject。

5. 完成检出：

   
   （图片来源网络，侵删）
   • 点击 OK，SmartSVN 就会开始从服务器下载项目文件。
   • 下载完成后,项目文件夹会自动在 SmartSVN 的“仓库浏览器”中打开。

日常核心操作

这是你每天都会用到的功能。

1 更新

在你开始修改代码之前,务必先更新，以确保你拥有的是最新的版本，避免不必要的冲突。

• 操作：
  • 在左侧的 Repository 视图中，右键点击你的项目根目录。
  • 选择 Update (或使用快捷键 ⌥U)。
• 结果：SmartSVN 会从服务器拉取所有最新的更改，并显示在日志中。

2 提交

当你完成了一部分修改,需要将它们上传到服务器时，就需要提交。

• 操作：
  1. 在文件浏览器中,你会看到文件状态图标：
     • 绿色对勾：已添加到 SVN 但未提交。
     • 蓝色问号：本地新增的文件，需要先“添加”。
     • 红色感叹号：文件被修改过。
     • A (黄色)：文件被标记为“添加”。
     • M (黄色)：文件被标记为“修改”。
  2. 右键点击已修改或已添加的文件（或项目根目录），选择 Commit... (或使用快捷键 ⌘K)。
  3. 在弹出的窗口中：
     • Message：必须填写清晰、简洁的提交信息，说明你这次修改了什么，这是团队协作的关键！
     • Files：确认你要提交的文件列表。
  4. 点击 OK 或 Commit。

3 添加新文件/文件夹

当你创建了新的文件或文件夹,需要告诉 SVN 管理它们。

• 操作：
  • 在 Finder 中找到你的项目文件夹，创建新文件。
  • 返回 SmartSVN，刷新视图（F5），你会看到一个蓝色的问号图标。
  • 右键点击这个新文件,选择 Add to Version Control。
  • 接下来像正常提交一样,填写提交信息并提交。

4 解决冲突

这是协作中最常见的问题,当两个人同时修改了同一个文件的同一行时，SVN 无法自动合并，就会产生冲突。

• 冲突的表现：文件状态会变为红色 C (Conflict)，双击打开文件，你会看到类似下面的标记：

  <<<<<<< .mine
  // 你的代码
  =======
  // 服务器上的代码
  >>>>>>> .r12345

• 解决步骤：
  1. 理解冲突：仔细查看 <<<<<<< 和 >>>>>>> 之间的内容，理解双方的修改。
  2. 手动合并：编辑文件，删除所有的 SVN 冲突标记 (<<<<<<<, , >>>>>>>)，并手动保留你需要的代码，或者将双方的代码整合起来。
  3. 标记为已解决：合并完成后，在 SmartSVN 中右键点击该文件，选择 Mark Resolved。
  4. 提交：现在这个文件的状态会变为 M (Modified)，你可以正常提交了。

高级功能与技巧

1 分支

分支是用于开发新功能或修复 Bug 的强大工具，它不会影响主代码线。

• 创建分支：
  1. 在 Repository Browser 中，右键点击你想基于的路径（通常是 trunk）。
  2. 选择 Branch/Tag...。
  3. 在 To URL 字段中，输入新的分支名称，https://svn.example.com/project/branches/my-new-feature。
  4. 勾选 Create branch。
  5. 填写提交信息,点击 OK。
• 切换到分支：
  1. 在左侧 Repository 视图中，右键点击你的本地项目。
  2. 选择 Switch/Cop...。
  3. 在 To URL 中，输入你刚刚创建的分支 URL。
  4. SmartSVN 会用分支的代码替换你本地的 trunk 代码。
• 合并分支：
  1. 假设你在 my-new-feature 分支上开发完成了，需要合并回 trunk。
  2. 确保你在 trunk 的本地工作副本上（使用 Switch 切换回来）。
  3. 右键点击项目根目录,选择 Merge...。
  4. 选择 From a single URL，然后选择你的分支 URL 作为源。
  5. 选择 To a single URL，然后选择 trunk 的 URL 作为目标。
  6. SmartSVN 会计算出差异并应用，检查结果，确认无误后提交。

2 比较

SmartSVN 的比较功能非常直观。

• 与版本库比较：
  • 右键点击一个本地已修改的文件。
  • 选择 Compare with Repository Revision...。
  • 一个窗口会左右并排显示：左边是你的本地修改，右边是服务器上的最新版本，差异会用高亮颜色标出。
• 比较两个版本：
  • 在 Repository Browser 中，右键点击一个文件。
  • 选择 Show Log。
  • 在日志窗口中,按住 键点击两个不同的版本号。
  • 右键点击选中的版本,选择 Compare Revisions...。

3 日志查看

查看一个文件或整个项目的提交历史。

• 操作：
  • 右键点击任意文件或目录。
  • 选择 Show Log。
• 功能：
  • 你可以看到所有的提交记录、作者、时间和提交信息。
  • 可以双击某条记录来查看具体的修改内容。
  • 可以右键点击某条记录,选择 Update to Revision 将你的工作副本回退到那个特定的版本。

常见问题与故障排除

Q: 我提交了一个大文件，后悔了，想从历史中删除它，怎么办？

A: SVN 不支持直接历史删除（这是为了安全），但你可以通过“删除并重新提交”的方式实现效果，这个过程被称为“ obliterate ”，通常需要管理员权限或使用特定工具。强烈建议不要随意操作，这会破坏所有人的工作副本。 最好的方法是联系你的 SVN 管理员。

Q: 提交时提示 "Entry '...' is out of date"

A: 这意味着在你提交之前，别人已经修改并提交了相同的文件，你需要先 Update 你的本地副本，解决可能出现的冲突，然后再 Commit。

Q: 忘记了提交信息，或者提交信息写错了

A: SmartSVN 本身不提供修改历史提交信息的功能，你需要使用命令行 svn 工具，这是一个比较复杂的操作，通常不推荐新手尝试，如果只是想补充信息，可以再提交一次。

SmartSVN for Mac 是一个极其高效的 SVN 管理工具，通过本教程，你应该已经掌握了：

• 基础工作流：检出 -> 更新 -> 修改 -> 添加 -> 提交。
• 冲突处理：识别冲突 -> 手动合并 -> 标记已解决。
• 核心高级功能：使用分支进行独立开发，以及使用比较和日志来追踪代码变更。

最佳实践：

• 先更新，后提交：养成这个好习惯。
• 写好提交信息：清晰的信息是团队协作的基石。
• 善用分支：为每个新功能或 Bug 修复创建独立的分支。

随着你使用次数的增加,你会越来越熟悉 SmartSVN 的各种快捷键和右键菜单，从而将你的版本控制工作流程提升到一个新的高度。