新手SVN下载及安装教程 – wiki基地

作者： /

新手上路：Subversion (SVN) 下载与安装超详细图文教程

引言：告别混乱，拥抱版本控制！

在软件开发、文档协作、甚至个人项目管理中，你是否曾经遇到过这样的烦恼：
* 文件改来改去，不知道哪个版本是最终版？
* 不小心覆盖了重要修改，找不到历史记录？
* 多人协作时，互相覆盖对方的代码或文档？
* 想回溯到某个旧的功能版本，却无从下手？

如果答案是肯定的，那么恭喜你，你即将接触到解决这些问题的强大工具——版本控制系统（Version Control System, VCS）。

版本控制系统就像一个时光机和智能档案管理员。它能记录你每一次文件的修改，让你随时可以查看、比较、甚至恢复到任何一个历史版本。同时，它还能有效地协调多人之间的工作，确保每个人都在正确的基础上进行修改，并能方便地合并各自的成果。

Subversion (SVN) 就是一款广泛使用的集中式版本控制系统。虽然近年来分布式版本控制系统（如 Git）越来越流行，但 SVN 凭借其简单易懂、功能成熟的特点，在许多企业和团队中仍然扮演着重要的角色。对于新手来说，SVN 也是一个非常好的入门选择。

本篇文章将手把手教你如何下载并安装 SVN 的客户端工具，并进行一些基础的配置和使用演示，让你迈出版本控制的第一步。我们的主要目标是安装 SVN 的图形化客户端——TortoiseSVN，它在 Windows 系统上非常流行且易于使用。

准备工作：磨刀不误砍柴工

在开始下载和安装之前，请确保你具备以下条件：

  1. 一台运行 Windows 操作系统的电脑： TortoiseSVN 主要用于 Windows 系统。如果你使用 macOS 或 Linux，安装方式会有所不同（后续会简要提及）。
  2. 稳定的互联网连接： 用于下载安装文件。
  3. 管理员权限： 安装软件通常需要系统的管理员权限。请确保你有权限进行软件安装。
  4. 了解你的操作系统是 32 位还是 64 位： SVN 客户端通常会提供 32 位和 64 位的版本，你需要下载与你操作系统位数匹配的版本。如果不确定，可以通过以下方式查看（以 Windows 10 为例）：
    • 右键点击“此电脑”（或“我的电脑”），选择“属性”。
    • 在弹出的系统信息窗口中，查找“系统类型”一行，会显示“64 位操作系统”或“32 位操作系统”。

第一步：理解 SVN 的基本概念（客户端 vs. 服务器）

在深入安装之前，快速了解一下 SVN 的基本架构非常重要。

SVN 是一个集中式版本控制系统。这意味着：

  • 中央仓库 (Repository)： 所有的文件和历史版本都存储在一个位于服务器上的中央仓库中。这个仓库是团队协作的核心。
  • 客户端 (Client)： 开发者或用户通过客户端工具连接到中央仓库，将文件“检出”（Checkout）到本地进行修改，然后将修改的“提交”（Commit）回中央仓库。客户端还用于“更新”（Update）获取其他人的最新修改，以及查看历史记录、比较版本等操作。

本教程的重点在于安装 客户端。通常情况下，你在公司或团队中会连接到已有的 SVN 服务器。如果你是个人使用或者想搭建自己的服务器，那将是另一个更复杂的安装过程（需要安装 SVN 服务器软件，如 VisualSVN Server 等），不属于本教程范围。

我们将安装的 TortoiseSVN 就是一个非常流行的 Windows 客户端，它以 Windows 资源管理器（文件管理器）的集成方式提供 SVN 功能，操作直观便捷。

第二步：下载 TortoiseSVN 客户端

现在，让我们开始下载安装文件。

  1. 打开你的网页浏览器： 输入 TortoiseSVN 的官方网站地址：https://tortoisesvn.net/

    • 请务必从官方网站下载，以确保软件的安全性和最新版本。

  2. 寻找下载页面： 在 TortoiseSVN 网站的主页上，你会看到一个明显的“Download”或“下载”按钮或链接。点击它。

    • 网站界面可能会更新，但通常下载链接很容易找到。

  3. 选择合适的版本： 进入下载页面后，你会看到多个下载选项。

    • 重要提示： 你需要选择与你操作系统位数（32 位或 64 位）匹配的版本。通常会看到类似“Download TortoiseSVN 1.x.x – 64-bit”和“Download TortoiseSVN 1.x.x – 32-bit”的链接（其中 1.x.x 是当前的版本号）。

    • 确认你的系统位数后，点击对应版本的下载链接。

    • 你可能还会看到“Language Packs”（语言包）的下载选项。如果你需要将 TortoiseSVN 的界面语言设置为中文或其他语言，可以在下载完主程序后再下载对应的语言包。主程序安装完成后，再安装语言包。我们将在后续的安装步骤中说明如何应用语言包。

  4. 选择下载源： 点击下载链接后，通常会跳转到一个镜像列表页面，或者直接开始下载。如果出现镜像列表，选择一个靠近你地理位置的下载源（例如，选择一个中国的镜像或国际镜像）。点击链接即可开始下载 .msi 格式的安装文件。

  5. 等待下载完成： 安装文件通常不大，下载速度很快。下载完成后，你会在浏览器的下载目录或你指定的保存位置找到一个名为 TortoiseSVN-1.x.x.xxxx-x64.msi 或 TortoiseSVN-1.x.x.xxxx-x32.msi 的文件（文件名中的数字和 x64/x32 会根据版本和位数有所不同）。

第三步：安装 TortoiseSVN 客户端 (Windows)

下载完成后，就可以开始安装了。安装过程非常简单，按照向导一步步操作即可。

  1. 运行安装文件： 找到下载好的 .msi 文件，双击运行它。

    • 如果你的系统启用了用户账户控制 (UAC)，可能会弹出一个提示框询问是否允许此应用对你的设备进行更改。请点击“是”继续。

  2. 进入安装向导： 屏幕上会显示 TortoiseSVN 的欢迎界面。

    • 点击 “Next >”（下一步）按钮。

  3. 接受许可协议： 接下来是用户许可协议 (End-User License Agreement)。请仔细阅读（或至少快速浏览），然后勾选 “I accept the terms in the License Agreement”（我接受许可协议中的条款）。

    • 点击 “Next >”（下一步）按钮。

  4. 选择安装组件： 这是安装过程中的一个重要步骤。你可以选择需要安装哪些组件。

    • 组件说明：

      • TortoiseSVN: 这是核心的图形化客户端程序，必须安装。
      • Command Line Client Tools: 命令行客户端工具。如果你计划使用命令行来执行 SVN 操作（对于有经验的用户很有用，但新手可能不需要），可以选择安装。对于大多数新手和使用 TortoiseSVN 图形界面的用户来说，这不是必需的，但安装也无妨。
      • Shell Extension: 这是 TortoiseSVN 的精髓所在！它让 SVN 功能集成到 Windows 资源管理器中，让你可以在文件或文件夹上右键点击直接进行 SVN 操作。这个组件强烈建议安装。
      • Language Packs: 语言包。如果你之前下载了语言包（.msi 文件），安装完主程序后还需要单独安装语言包。这里的选项是让你选择是否预留安装语言包的选项，通常保持默认即可。
      • Help Files: 帮助文件。包含 TortoiseSVN 的详细文档。建议安装，遇到问题时可以查阅。

    • 建议： 对于新手，建议保持默认选择（通常包括 TortoiseSVN、Shell Extension 和 Help Files，有时也包括命令行工具）。这些默认选项已经足够满足日常使用需求。

    • 点击 “Next >”（下一步）按钮。

  5. 选择安装路径： 接下来是选择 TortoiseSVN 的安装目录。

    • 默认路径通常在 C:\Program Files\TortoiseSVN\（64 位系统）或 C:\Program Files (x86)\TortoiseSVN\（32 位系统）。
    • 对于大多数用户来说，保持默认路径即可。如果你有特殊的安装需求，可以点击 “Change…”（更改）按钮选择其他路径。

    • 确保你选择的硬盘分区有足够的空间。

    • 点击 “Next >”（下一步）按钮。

  6. 准备安装： 安装向导会显示你选择的安装选项和路径，确认无误后。

    • 点击 “Install”（安装）按钮开始安装过程。

  7. 等待安装完成： 安装程序会开始复制文件并配置系统。这个过程通常很快。你会看到一个进度条显示安装进度。

  8. 安装完成： 安装完成后，向导会显示安装成功的消息。

    • 你可能会看到一个选项，询问是否要重启电脑。对于 TortoiseSVN 的 Shell Extension 能够正常工作，重启电脑是非常推荐的。有时不重启也能工作，但为了确保 SVN 的右键菜单和图标叠加能够正确显示，建议选择 “Yes, restart the computer now”（是的，现在重启电脑）。

    • 点击 “Finish”（完成）按钮。

    • 如果选择了重启，系统会立即开始重启过程。请保存你正在进行的工作。

第四步：安装语言包（可选，如果需要中文界面）

如果你希望 TortoiseSVN 的界面显示为中文，你需要额外下载并安装中文语言包。

  1. 找到并运行语言包安装文件： 在你之前下载 TortoiseSVN 主程序的地方，找到对应的中文语言包 .msi 文件（例如 TortoiseSVN-1.x.x.xxxx-zh_CN.msi）。双击运行它。

  2. 语言包安装向导： 语言包的安装过程比主程序简单得多。通常只有欢迎界面、许可协议和安装完成界面。

    • 点击 “Next >”（下一步）。
    • 接受许可协议，点击 “Next >”（下一步）。
    • 点击 “Install”（安装）。
    • 等待安装完成，点击 “Finish”（完成）。

  3. 配置 TortoiseSVN 使用中文界面： 语言包安装完成后，你需要告诉 TortoiseSVN 使用这个语言包。

    • 在桌面上或任意文件夹中，右键点击空白区域。
    • 在弹出的右键菜单中，你会看到一个新的子菜单项 “TortoiseSVN”。将鼠标悬停在其上方，会弹出二级菜单。
    • 在二级菜单中，点击 “Settings”（设置）。
    • 在弹出的 TortoiseSVN Settings 窗口中，找到左侧导航栏的 “General”（通用）选项。
    • 在右侧的通用设置中，找到 “Language:”（语言）下拉菜单。
    • 点击下拉菜单，选择 “简体中文(中国) [zh_CN]” 或你安装的其他语言。

    • 点击窗口底部的 “OK”（确定）按钮。

    • 重要提示： 更改语言设置后，可能需要重启电脑或者至少重启 Windows 资源管理器（可以通过任务管理器结束 explorer.exe 进程再运行新任务 explorer.exe，但重启电脑更彻底）才能看到界面语言的完全改变。

第五步：验证安装是否成功

安装完成后，最直观的验证方法就是查看 Windows 资源管理器的右键菜单和文件/文件夹图标。

  1. 重启电脑： 如果之前安装完成时选择了重启，或者手动进行了重启，请忽略此步。如果还没重启，强烈建议重启电脑。

  2. 打开 Windows 资源管理器： 随便打开一个文件夹窗口。

  3. 右键点击空白区域或任意文件/文件夹： 在弹出的上下文菜单中，你应该能看到：

    • 一个名为 “SVN Checkout…”（SVN 检出）的选项。
    • 一个名为 “TortoiseSVN” 的子菜单项。将鼠标悬停在上面，会弹出更多的 SVN 相关操作菜单，如 “Update”（更新）、”Commit”（提交）、”Settings”（设置）等。

如果这些选项出现在右键菜单中，说明 TortoiseSVN 的 Shell Extension 已经成功集成到了 Windows 资源管理器，安装基本成功了！

此外，你还可以在文件和文件夹上看到 TortoiseSVN 的图标叠加（Overlay Icons），这些图标会指示文件的 SVN 状态（例如，绿色的勾表示文件与仓库版本一致，红色的叹号表示文件有修改）。这些图标可能需要稍等片刻才会完全显示出来，或者在首次连接到 SVN 仓库后才会出现。

第六步：TortoiseSVN 的基本使用演示（初体验）

安装并验证成功后，你就可以开始使用 TortoiseSVN 连接到 SVN 仓库进行版本控制了。这里我们演示两个最基本的操作：检出 (Checkout) 和 提交 (Commit)。

  • 前提： 你需要有一个 SVN 仓库的 URL 地址。这个地址通常由你的项目管理员或团队成员提供。它类似于 svn://服务器地址/仓库名称/项目路径 或 https://服务器地址/svn/仓库名称/项目路径。

操作一：检出 (Checkout) 仓库到本地

检出操作是将远程 SVN 仓库中的文件复制到你的本地电脑上，创建一个“工作副本”（Working Copy）。

  1. 在你的本地电脑上，选择一个你想要存放项目文件的空文件夹（或者新建一个文件夹）。注意： 这个文件夹最好是空的，或者只包含你打算纳入版本控制的文件。不要直接在已经有大量无关文件的文件夹里进行检出。

  2. 右键点击这个文件夹的空白区域。

  3. 在右键菜单中，选择 “SVN Checkout…”（SVN 检出…）。

  4. 弹出一个名为“Checkout”的对话框。

    • URL of repository: 在这里输入你要检出的 SVN 仓库的 URL 地址。
    • Checkout directory: 这个输入框会自动填写你右键点击的文件夹路径。你可以修改它，但通常保持默认即可。
    • Checkout depth: 检出深度。通常保持默认的 “Fully recursive”（完全递归），这意味着会检出仓库中指定路径下的所有文件和子文件夹。
    • Revision: 你可以选择检出仓库的哪个版本。通常选择 “HEAD revision”（最新版本），表示检出仓库中最新的文件。如果你想回溯到某个历史版本，可以选择 “Revision” 并输入版本号，或者点击右侧的按钮选择特定日期或日志。对于新手，保持 HEAD 版本即可。

  5. 点击 “OK” 按钮。

  6. TortoiseSVN 会开始连接仓库并下载文件。可能会弹出一个窗口要求输入用户名和密码，这是连接到私有 SVN 仓库所需的身份验证。输入你的 SVN 账号信息。

  7. 下载完成后，会弹出一个显示操作结果的窗口。如果一切顺利，会显示“Completed”或“成功”等信息。

  8. 关闭结果窗口。现在打开你检出的文件夹，你会看到仓库中的文件已经被下载到了本地。同时，这些文件和文件夹的图标上会叠加 TortoiseSVN 的状态图标（通常是绿色的勾，表示它们是工作副本的一部分且与仓库最新版本一致）。

操作二：提交 (Commit) 你的修改

当你对工作副本中的文件进行了修改、添加或删除了文件后，你需要将这些变更提交回 SVN 仓库，以便与团队成员共享并记录这些历史变更。

  1. 在你的工作副本文件夹中，对文件进行修改、新建文件或删除文件。

  2. 你会注意到，修改过的文件图标可能会变成红色的叹号，新添加的文件图标可能会变成蓝色的问号。这些图标表示文件状态与仓库不一致。

  3. 右键点击你的工作副本文件夹（或者你修改过的特定文件/文件夹）。右键点击文件夹通常是提交所有在当前文件夹及其子文件夹中的修改。

  4. 在右键菜单中，选择 “SVN Commit…”（SVN 提交…）。

  5. 弹出一个名为“Commit”的对话框。

    • Message: 这是一个非常重要的区域！你需要在这里输入本次提交的日志信息。好的日志信息应该简要描述你本次提交做了哪些修改。例如：“实现了用户登录功能”、“修复了首页的显示问题”、“更新了项目的README文档”。清晰的日志信息有助于你和团队成员以后理解历史版本。强烈建议认真填写日志信息！
    • 在下方，你会看到一个列表，显示了所有被修改、添加、删除的文件。默认情况下，所有有变动的文件都会被勾选，表示它们将被包含在本次提交中。你可以根据需要取消勾选某些不想提交的文件。
    • 对于新添加的文件（图标是蓝色的问号），你需要先将它们“加入”到版本控制中。在 Commit 对话框中，新文件通常会显示在列表中，并带有“add”标记。确保它们被勾选即可。或者，你也可以在 Commit 之前，右键点击新文件，选择 “TortoiseSVN” -> “Add” 将其先加入到版本控制的跟踪列表中。

  6. 确认日志信息和要提交的文件列表后，点击 “OK” 按钮。

  7. TortoiseSVN 会开始将你的修改上传到 SVN 仓库。这个过程可能需要一些时间，取决于你的修改量和网络速度。可能会再次要求输入用户名和密码。

  8. 提交完成后，会弹出一个显示操作结果的窗口。如果一切顺利，会显示版本号增加的信息（例如，“New revision: 123”）。这意味着你的修改已经成功保存到了中央仓库，并生成了一个新的版本（Revision）。

  9. 关闭结果窗口。现在查看你的工作副本文件夹，修改过的文件图标应该变回绿色的勾了，表示它们与仓库中的最新版本一致。

通过这两个基本操作，你已经完成了 SVN 版本控制中最核心的“获取最新代码”（Checkout/Update）和“保存我的修改”（Commit）的过程。

第七步：SVN 安装在 macOS 或 Linux 系统上的简要说明

虽然本教程主要聚焦于 Windows 和 TortoiseSVN，但 SVN 是跨平台的。在 macOS 和 Linux 系统上安装 SVN 客户端通常更侧重于命令行工具，或者使用不同的图形化客户端。

  • macOS:
    • 命令行工具： SVN 命令行工具通常预装在 macOS 中，或者可以通过安装 Xcode Command Line Tools 获得。打开终端（Terminal）输入 svn --version 可以查看是否已安装。
    • 图形化客户端： macOS 上没有 TortoiseSVN，但有一些第三方的图形化客户端可用，例如 SnailSVN、Cornerstone、Versions 等。这些通常需要在 Mac App Store 或开发者网站下载安装。安装过程类似于普通 Mac 应用的安装。
  • Linux:
    • 命令行工具： SVN 命令行工具通常可以通过系统的包管理器进行安装。例如，在基于 Debian 的系统（如 Ubuntu）上，打开终端输入 sudo apt update && sudo apt install subversion 即可安装。在基于 Red Hat 的系统（如 Fedora, CentOS）上，使用 sudo dnf install subversion 或 sudo yum install subversion。
    • 图形化客户端： Linux 上也有一些图形化 SVN 客户端，如 RapidSVN、或是集成在某些 IDE（如 Eclipse, NetBeans）中的 SVN 插件。安装方式取决于具体的客户端和你的 Linux 发行版。

无论在哪个系统上，SVN 的核心概念和命令行操作是相似的。图形化客户端只是提供了更友好的用户界面。

第八步：常见问题与故障排除

  • 右键菜单没有 TortoiseSVN 选项：
    • 确保你安装了 Shell Extension 组件。
    • 最常见的原因是没有重启电脑。请重启电脑后再次查看。
    • 如果重启无效，尝试卸载 TortoiseSVN 并重新安装，确保勾选 Shell Extension，并在安装完成后重启。
    • 检查是否与其他Shell扩展冲突（较少见）。
  • 文件/文件夹图标没有显示叠加状态：
    • 这可能是正常现象，图标叠加可能需要稍等片刻，或者在首次 Checkout 仓库后才会出现。
    • 确保你的 Windows 版本支持图标叠加，并且没有达到系统限制（Windows 对图标叠加的数量有限制）。
    • 在 TortoiseSVN Settings -> Icon Overlays 中检查设置是否正确。
    • 重启电脑。
  • 连接 SVN 仓库时提示认证失败：
    • 检查你输入的用户名和密码是否正确。注意区分大小写。
    • 确认 SVN 仓库的 URL 是否正确。
    • 确认你的账号是否有访问该仓库的权限。
    • 可能是网络问题或防火墙阻止了连接。
  • Commit 或 Update 失败：
    • 检查网络连接是否正常。
    • 确认 SVN 仓库服务器是否正常运行。
    • 如果是 Commit 失败，可能是你尝试提交的文件与仓库中的最新版本有冲突（通常在 Update 操作时会提示冲突）。在这种情况下，你需要先进行 Update 操作，解决冲突后再 Commit。
    • 检查你的工作副本是否干净（没有锁定或错误状态）。可以使用 TortoiseSVN 的 “Clean up”（清理）功能尝试解决。
  • 安装语言包后界面仍是英文：
    • 确保你在 TortoiseSVN Settings 中正确选择了安装的语言。
    • 确保你安装的语言包版本与 TortoiseSVN 主程序版本兼容。
    • 重启电脑或重启 Windows 资源管理器。

结论：版本控制，迈向高效协作的第一步

恭喜你！通过本教程的学习，你已经成功下载并安装了 Subversion 客户端 TortoiseSVN，并了解了如何进行最基本的版本控制操作：检出和提交。

这仅仅是版本控制世界的冰山一角。SVN 还有许多其他强大的功能，如：
* Update (更新): 获取仓库中其他人的最新修改。
* Diff (比较差异): 查看你的工作副本与仓库版本之间的修改内容。
* Show Log (查看日志): 查看仓库的所有提交历史和日志信息。
* Revert (回滚): 撤销本地的修改，回到上一个状态。
* Branching and Merging (分支与合并): 创建独立的分支进行开发，完成后再合并回主线。

掌握这些功能将让你更高效地管理代码和文档，无论是个人项目还是团队协作。

下一步的学习建议：

  1. 实践： 尝试连接到一个测试仓库，进行多次修改、提交、更新等操作，熟悉流程。
  2. 查阅文档： TortoiseSVN 的官方文档非常详细，是学习高级功能的宝库。你也可以查看 SVN 官方书籍《Version Control with Subversion》（在线免费阅读）。
  3. 了解更多概念： 深入理解工作副本、仓库、版本号、冲突、分支、标签等概念。
  4. 学习命令行： 如果你对命令行不抵触，学习 SVN 的命令行操作能让你更深刻地理解其工作原理。

版本控制是现代软件开发和协同工作不可或缺的技能。希望本教程能为你打开版本控制的大门，祝你在使用 SVN 的过程中顺利高效！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部