SVN从零到一：第一步，下载与环境搭建 – wiki基地

作者： /

SVN从零到一：第一步，下载与环境搭建

引言：为何我们仍需谈论SVN？

在代码版本控制的浩瀚星空中，Git以其分布式模型的灵活性和强大的分支能力，无疑成为了最耀眼的明星。然而，在企业级应用、特别是对权限管理、操作简易性和中心化管理有严格要求的场景下，Subversion（简称SVN）依然占据着不可或TAM的地位。它就像一位沉稳可靠的元老，凭借其清晰的逻辑、直观的操作和严谨的权限控制，为无数项目团队的稳定协作提供了坚实的基石。

对于许多初入职场的开发者、项目管理人员或是需要进行文档版本控制的团队来说，SVN往往是他们接触的第一个版本控制系统。它的学习曲线相对平缓，核心概念易于理解，是入门版本控制思想的绝佳途径。

本系列文章《SVN从零到一》旨在为完全没有版本控制经验的“小白”用户，提供一份从入门到基本熟练的完整教程。而本文作为系列的第一步，将以最详尽、最细致的方式，手把手带你完成SVN环境的下载与搭建。我们将从理解SVN的核心架构开始，到选择并安装服务器端，再到配置客户端，最终成功检出（Checkout）你的第一个版本库。这不仅仅是一个技术操作指南，更是一次打牢地基、构建知识体系的旅程。让我们现在就出发，迈出坚实的第一步。

第一章：概念先行，理解SVN的核心架构

在动手之前，我们必须先建立正确的认知模型。所谓“磨刀不误砍柴工”，理解SVN的工作原理，能让你在后续的操作中知其然，更知其所以然。

SVN采用的是客户端/服务器（Client/Server）模型。你可以将其想象成一个中央图书馆：

  • 服务器（Server）：就是那个唯一的、权威的中央图书馆。它保存着所有书籍（项目文件）的每一个版本，从第一版草稿到最终修订版，都井井有条地存放在书架上。这个“图书馆”在SVN中被称为版本库（Repository）。它是所有数据的核心，集中存储和管理。
  • 客户端（Client）：就是每一位读者（开发者）。当你需要工作时，你不会把整个图书馆搬回家，而是从图书馆借阅（检出 – Checkout）你需要的书籍（项目文件）的最新版本。你借回家的这些书籍，就叫做工作副本（Working Copy）。
  • 你的工作：你在自己的书桌上（本地电脑）对借来的书籍（工作副本）进行修改、批注、添加新章节。这个过程完全在你自己的空间里，不会影响图书馆里的原书，也不会影响其他正在阅读的读者。
  • 提交（Commit）：当你完成修改，认为这个版本可以作为新的正式版本时，你会将你修改后的书籍带回图书馆，让管理员（SVN服务器）将其作为最新版本入库，并贴上一个新的版本标签。这个过程就是提交。提交后，图书馆里的这本书就更新了，其他读者下次来借阅时，就会拿到这个最新的版本。
  • 更新（Update）：如果在你修改期间，有其他同事也向图书馆提交了他们修改的版本，那么你手头的书就不是最新的了。你需要回到图书馆，将别人更新的内容同步到你自己的书上。这个过程就是更新。

核心术语小结：

  • Repository (版本库)：位于服务器端，是存储所有文件历史版本和元数据的中央数据库。
  • Working Copy (工作副本)：位于客户端（你的电脑），是你当前工作的项目目录，包含了从版本库中某个特定版本检出文件的本地拷贝。
  • Checkout (检出)：从服务器上的版本库获取一个全新的工作副本到本地。这是你开始工作的第一步。
  • Commit (提交)：将你在工作副本中所做的更改（新增、修改、删除文件）发送回服务器的版本库，形成一个新的版本（Revision）。
  • Update (更新)：从服务器的版本库获取其他人提交的最新更改，并合并到你自己的工作副本中，以保持与中央版本库同步。
  • Revision (版本号)：每次成功的提交都会在版本库中创建一个新的“快照”，并为其分配一个唯一的、递增的整数，即版本号。它是追溯历史的依据。

理解了这个模型，你就会明白，我们搭建环境需要做两件事：1. 建立中央图书馆（安装SVN服务器）；2. 办理借书证并学会借书（安装SVN客户端）。

第二章：服务器端的抉择与下载

搭建SVN服务器有多种方案，从在Apache上通过模块配置，到使用独立的SVN服务。对于初学者而言，我们强烈推荐使用集成了图形化管理界面的软件包，它能极大地降低配置的复杂性。

在Windows环境下，VisualSVN Server 是当之无愧的首选。

为什么选择VisualSVN Server？

  1. 安装简便：它是一个独立的安装包，包含了所有需要的组件（包括Apache和Subversion），通过向导式安装，几分钟内就能搭建一个功能完善的SVN服务器。
  2. 图形化管理：提供了一个类似Windows管理控制台（MMC）的图形界面，创建版本库、管理用户和用户组、分配权限等操作都可通过鼠标点击完成，无需编辑复杂的配置文件。
  3. 安全可靠：默认强制使用HTTPS协议，确保数据在传输过程中的安全。
  4. 无缝集成：可以与Windows域认证集成，对于企业环境非常友好。

下载步骤：

  1. 打开你的浏览器，访问VisualSVN的官方网站：https://www.visualsvn.com/
  2. 在网站首页，通常能很明显地看到 “Download” 或 “VisualSVN Server” 的链接，点击进入下载页面。
  3. 在下载页面，你会看到不同版本的VisualSVN Server。选择最新的Standard Edition（标准版）。标准版对于个人和大多数中小型团队来说是完全免费的，并且功能已经足够强大。
  4. 根据你的Windows操作系统是32位还是64位，选择对应的安装包进行下载。如今绝大多数电脑都是64位系统，如果不确定，可以右键点击“此电脑”或“我的电脑” -> “属性” 查看。
  5. 将下载好的 .msi 安装文件保存到你的电脑上，比如桌面或者一个专门的下载文件夹。

至此，服务器端的“原材料”已经准备就绪。

第三章：手把手教你安装SVN服务器（以VisualSVN Server为例）

现在，让我们开始“建造”我们的中央图书馆。请双击刚刚下载的 VisualSVN-Server-x.x.x-x64.msi 文件，启动安装向导。

Step 1: 欢迎界面
启动安装程序后，会看到一个欢迎界面。直接点击 “Next” 继续。

Step 2: 许可协议
阅读（或直接略过）最终用户许可协议，勾选 “I accept the terms in the License Agreement”，然后点击 “Next”。

Step 3: 选择组件
这是关键的一步。你会看到两个选项：
* VisualSVN Server and Administration Tools: 这是服务器本身及其图形化管理工具，是必须安装的核心部分。
* Subversion Command-Line Tools: 这是SVN的命令行工具。强烈建议勾选此项。虽然我们主要使用图形界面，但有时命令行工具在进行批量操作或脚本自动化时非常有用。

保持默认的全选状态，点击 “Next”。

Step 4: 配置安装选项 (最关键的一步!)
这个界面需要你做出几个重要决定，请务必仔细阅读和理解。

  • Installation location: 这是VisualSVN Server程序本身的安装路径。通常保持默认的 C:\Program Files\VisualSVN Server 即可。如果你想安装到其他盘符（如D盘），也可以修改。
  • Repositories location: 这是你的版本库（所有项目数据）的存放位置。这是一个至关重要的设置。强烈不建议将其放在C盘（系统盘）。因为版本库会随着项目的提交不断增大，放在系统盘可能会导致系统空间不足。建议选择一个空间充裕、数据安全的非系统盘，例如 D:\SVN_Repositories。请务必为你的版本库数据规划一个独立的、清晰的目录。
  • Server Port: 这是服务器监听网络请求的端口号。VisualSVN Server默认推荐使用 443 (标准的HTTPS端口) 或 8443。使用标准HTTPS端口的好处是，在大多数网络环境下（如公司防火墙）都可以直接访问，而无需特殊配置。如果你的电脑上443端口已被其他程序（如IIS、Skype）占用，安装程序会自动建议一个备用端口，如8443。对于初学者，接受默认建议即可。
  • Authentication: 这是身份验证模式的选择。
    • Use Subversion authentication: 使用SVN自己的用户和密码系统。你将在VisualSVN Server Manager中手动创建用户和设置密码。这是初学者的最佳选择，因为它简单、独立，不依赖任何外部系统。
    • Use Windows authentication: 使用Windows系统的账户进行认证。这在企业域环境中非常有用，但对于个人或小团队学习，前者更方便。

我们的推荐配置：
* Repositories location: D:\SVN_Repositories (或你选择的非系统盘)
* Server Port: 接受默认建议 (如 443 或 8443)
* Authentication: 选择 Use Subversion authentication

确认无误后，点击 “Next”。

Step 5: 开始安装
安装向导会显示你的配置摘要。检查一遍，然后点击 “Install” 开始安装过程。安装过程可能需要几分钟，请耐心等待。

Step 6: 完成安装
当看到 “Completed the VisualSVN Server Setup Wizard” 的界面时，恭喜你，SVN服务器已经成功安装在你的电脑上了！保持 “Start VisualSVN Server Manager” 勾选，点击 “Finish”。

此时，VisualSVN Server Manager的图形化管理界面会自动打开。你会在系统托盘区（右下角）看到一个新的绿色图标，代表SVN服务正在运行。

第四章：创建你的第一个“宝库”——版本库

服务器已经建好，现在我们要在“图书馆”里开辟第一个书架区域，也就是创建第一个版本库（Repository）。

  1. 打开VisualSVN Server Manager。
  2. 在左侧的树状菜单中，右键点击 “Repositories”。
  3. 在弹出的菜单中，选择 “Create New Repository…”。
  4. 选择版本库类型：通常选择 “Regular FSFS repository”，这是标准的、推荐的版本库类型。点击 “Next”。
  5. 输入版本库名称：为你的第一个项目起一个有意义的名字，例如 MyFirstProject。请使用英文字母、数字和下划线，避免使用中文或特殊字符。
  6. 选择初始目录结构：这是一个非常好的实践。选择 “Create the recommended project structure (trunk, branches, tags)”。
    • trunk (主干)：存放项目开发的主线。日常的开发工作都在这里进行。
    • branches (分支)：用于并行开发。例如，开发一个新功能或者修复一个复杂的Bug时，可以创建一个分支，在不影响主干的情况下进行工作，完成后再合并回主干。
    • tags (标签)：用于标记项目的里程碑版本，例如 Release_V1.0。标签下的内容通常是只读的，作为历史快照。
      勾选此项，VisualSVN会自动为你创建这三个文件夹，这是一个行业标准的好习惯。点击 “Next”。
  7. 设置权限：选择 “Customize permissions”，然后点击 “Add…”。
  8. 创建用户：由于我们之前选择了Subversion认证，这里需要手动创建用户。点击 “Create User…”。
    • User name: 输入一个用户名，例如 testuser。
    • Password: 输入一个密码，并再次确认。
    • 点击 “OK” 创建用户。
  9. 分配权限：在 “Select Users and Groups” 窗口中，你刚刚创建的 testuser 应该已经被选中了。点击 “OK”。现在，在权限列表中，你会看到 testuser。在右侧的 “Permissions” 下拉框中，为其选择 “Read / Write”。这意味着 testuser 对这个版本库拥有读和写的全部权限。点击 “Create”。

大功告成！ 你现在可以在VisualSVN Server Manager的左侧看到你新建的 MyFirstProject 版本库了。点击它，在右侧窗口你会看到这个版本库的 Repository URL，它看起来像这样：https://你的计算机名/svn/MyFirstProject/。这个URL至关重要，它就是你客户端连接服务器的“地址”。

第五章：客户端的安装——与服务器沟通的桥梁

有了服务器，我们还需要一个客户端工具来与之交互。在Windows平台上，TortoiseSVN 是最流行、最好用的SVN客户端，没有之一。它不提供一个独立的程序界面，而是与Windows资源管理器（你的“文件夹”）深度集成，所有操作都通过右键菜单完成，非常直观。

下载与安装步骤：

  1. 访问TortoiseSVN的官方网站：https://tortoisesvn.net/
  2. 进入 “Downloads” 页面。
  3. 根据你的操作系统（32位或64位），下载对应的安装程序。
  4. 重要：在下载列表下方，你还会找到 Language packs。为了方便使用，请找到 “Chinese, simplified” 简体中文语言包，并下载它。
  5. 先安装主程序：双击下载的 TortoiseSVN 安装包。安装过程非常简单，基本上一路 “Next” 即可。
  6. 再安装语言包：主程序安装完毕后，双击下载的中文语言包进行安装。
  7. 设置语言：安装完语言包后，在桌面或任意文件夹空白处点击鼠标右键，你会看到菜单中出现了 “TortoiseSVN” 选项。进入 “TortoiseSVN” -> “Settings” -> “General” -> “Language”，在下拉菜单中选择 “简体中文”，点击“确定”。
  8. 重启电脑：为了让TortoiseSVN的图标覆盖和右键菜单完全生效，强烈建议你在此刻重启一次计算机。这是一个必要步骤。

第六章：第一次亲密接触——检出（Checkout）你的工作副本

所有准备工作都已就绪，现在是见证奇迹的时刻！我们将从服务器上将我们刚刚创建的空项目“借阅”到本地电脑。

  1. 创建本地工作目录：在你的电脑上，选择一个合适的位置，创建一个用于存放SVN项目的文件夹。例如，在D盘创建一个名为 SVN_Workspace 的文件夹，然后在里面再创建一个 MyFirstProject 文件夹。最终路径为 D:\SVN_Workspace\MyFirstProject。这个文件夹目前是空的。
  2. 执行检出操作：进入 D:\SVN_Workspace\MyFirstProject 这个空文件夹，在文件夹内部的空白处点击鼠标右键。
  3. 在弹出的菜单中，选择 “SVN 检出…”（如果你安装了中文语言包）。
  4. 配置检出对话框：
    • 版本库URL (URL of repository)：在这里，你需要粘贴之前在VisualSVN Server Manager中看到的那个版本库URL。例如：https://你的计算机名/svn/MyFirstProject/。你可以直接从服务器管理器复制，然后粘贴过来。
    • 检出至目录 (Checkout directory)：这个路径会自动填充为你当前右键的文件夹，即 D:\SVN_Workspace\MyFirstProject。确认无误。
    • 检出深度 (Checkout depth)：保持默认的 “完全递归” (Fully recursive)。
    • 版本 (Revision)：保持默认的 “HEAD revision”，这表示检出最新版本。
  5. 点击 “确定”。
  6. 身份验证：由于是第一次连接，TortoiseSVN会弹出一个身份验证窗口。在这里，输入你之前在服务器上创建的用户名（testuser）和密码。勾选 “保存认证信息”，这样下次操作就不用重复输入了。点击“确定”。
  7. 检出成功：如果URL、用户名和密码都正确，你会看到一个日志窗口，显示正在从服务器获取文件。由于我们创建的是带标准目录结构的版本库，它会成功检出 trunk, branches, tags 这三个空文件夹。日志窗口最后会显示“完成于版本 1”。
  8. 观察变化：关闭日志窗口，回到你的 D::\SVN_Workspace\MyFirstProject 文件夹。你会发现，文件夹里多了 trunk, branches, tags 三个子目录，并且文件夹图标的左下角出现了一个绿色的对勾。这个绿色对勾是TortoiseSVN的标志性图标，它告诉你：这个文件夹是一个SVN工作副本，并且其内容与服务器上的最新版本完全同步。

至此，你已经成功地完成了从服务器下载、安装、配置，到客户端安装，并最终成功检出第一个项目的全过程！

总结：坚实地基已筑，未来可期

回顾我们今天走过的路程，我们不仅仅是简单地点击了几个“下一步”。我们理解了SVN的C/S架构，做出了明智的软件选择，细致地完成了服务器的安装与配置，亲手创建了第一个结构化的版本库和用户，并最终通过客户端与服务器建立了连接，拿到了本地的工作副本。

这第一步，是整个SVN学习之旅中最复杂、但也最基础的一步。你所搭建的这个环境，就是未来所有版本控制工作的舞台。现在，你的舞台已经灯火通明，演员（你自己）也已就位。

在下一篇文章中，我们将踏上这个舞台，开始真正的表演：如何向版本库中添加你的第一个文件，如何修改它，如何将你的心血“提交”到中央服务器，以及如何与团队成员协同工作。你已经为这一切做好了最充分的准备。保持这份好奇与耐心，版本控制世界的大门已向你敞开。

发表评论

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

滚动至顶部