TortoiseSVN：Windows下的SVN客户端使用教程 – wiki基地

作者： /

TortoiseSVN：Windows下的SVN客户端使用教程

TortoiseSVN 是一款免费开源的 Subversion (SVN) 客户端，专为 Windows 操作系统设计。它以 Windows 外壳扩展的形式集成到文件资源管理器中，让用户能够直接通过右键菜单操作 SVN，极大地简化了版本控制流程。本文将详细介绍 TortoiseSVN 的安装、基本概念以及日常使用方法。

1. 安装 TortoiseSVN

1.1 下载安装包
访问 TortoiseSVN 官方网站 (https://tortoisesvn.net/)，根据您的 Windows 系统版本（32 位或 64 位）下载对应的安装程序 .msi 文件。同时，建议下载简体中文语言包，以便后续将界面设置为中文。

1.2 安装 TortoiseSVN
双击下载的 .msi 安装程序，并按照安装向导的提示进行操作。在安装过程中，确保勾选“command line client tools”（命令行客户端工具）选项，以便在需要时使用命令行操作 SVN。安装完成后，系统可能会提示您重启电脑，请务必重启以确保 TortoiseSVN 能够正确加载并与文件资源管理器集成。

1.3 安装并设置中文语言包
1. 运行您下载的中文语言包安装程序。
2. 安装完成后，在桌面的空白处或任意文件夹中右键单击，选择“TortoiseSVN” -> “Settings”（设置）。
3. 在弹出的设置窗口中，切换到“General”（常规）选项卡，在“Language”（语言）下拉菜单中选择“简体中文”或“Chinese (Simplified)”，然后点击“OK”确认。此时，TortoiseSVN 的界面将切换为中文。

2. 基本概念

在开始使用 TortoiseSVN 之前，了解几个核心概念至关重要：

  • 版本库 (Repository)：也称为仓库或代码库。它是存储项目所有文件、历史版本以及所有更改记录的中央位置。所有团队成员都从这里获取代码，并将更改提交回这里。
  • 工作副本 (Working Copy)：您从版本库中“检出”到本地计算机上的项目文件和目录的副本。所有对文件的修改都在工作副本中进行，然后通过“提交”操作同步到版本库。

3. 日常使用指南

3.1 检出 (Checkout) 项目

当您第一次获取一个 SVN 项目到本地时，需要执行“检出”操作。

  1. 选择一个空的本地文件夹（或创建一个新文件夹）作为您项目的工作目录。在该文件夹内或空白处右键单击，选择“SVN Checkout…”。
  2. 在弹出的“Checkout”对话框中：
    • URL of repository (版本库 URL)：输入您要检出的 SVN 版本库的地址（例如：svn://your-server/your-project 或 https://your-server/svn/your-project）。
    • Checkout directory (检出至目录)：确认这是您希望项目文件存储的本地路径。
  3. 点击“确定”。如果版本库需要身份验证，会弹出输入用户名和密码的窗口。
  4. 检出完成后，项目文件将被下载到您的本地目录。此时，文件夹和文件图标上会出现绿色对勾，表示它们已成功被 SVN 版本控制。

3.2 更新 (Update) 代码

为了获取版本库中其他团队成员提交的最新更改，确保您的本地工作副本是最新的，您需要执行“更新”操作。

  1. 在您的工作副本文件夹上（或其内部的任何文件/文件夹上）右键单击，选择“SVN Update”（SVN 更新）。
  2. TortoiseSVN 会自动将版本库中的最新更改同步到您的本地工作副本中。

3.3 添加 (Add) 新文件/目录

当您在工作副本中创建了新的文件或目录，并希望将其纳入版本控制时，需要先执行“添加”操作。

  1. 在您新建的文件或目录上右键单击，选择“TortoiseSVN” -> “Add”（添加）。
  2. 被添加的文件或目录的图标会变为蓝色加号，表示它们已被标记为待添加。
  3. 请注意，“添加”操作只是将新文件或目录标记为受版本控制，它们尚未上传到版本库。您还需要执行“提交”操作才能将这些新项真正上传到版本库。

3.4 提交 (Commit) 更改

当您对工作副本中的文件进行了修改、添加或删除，并希望将这些更改保存到版本库时，需要执行“提交”操作。

  1. 在您的工作副本文件夹上右键单击，选择“SVN Commit…”或“Commit…”（提交）。
  2. 在提交对话框中，您会看到所有已更改、添加或删除的文件列表。您可以勾选或取消勾选某些文件，以决定本次提交包含哪些更改。
  3. 在顶部的“Message”（信息）文本框中，输入本次提交的描述信息。这是一个非常重要的步骤，清晰的提交信息可以帮助您和团队成员理解本次更改的目的和内容。
  4. 点击“确定”提交更改。如果提交成功，文件图标将恢复为绿色对勾。

3.5 撤销修改 (Revert)

如果您对本地文件的修改不满意，或发现修改有误，想放弃这些更改并恢复到版本库中该文件的最新版本，可以使用“撤销修改”功能。

  1. 在您想撤销修改的文件或目录上右键单击，选择“TortoiseSVN” -> “Revert…”（还原）。
  2. 在弹出的对话框中，确认您要撤销的更改。
  3. 点击“确定”，选定的文件将恢复到上一次更新或提交时的状态。

3.6 忽略文件/目录

在项目开发过程中，通常会产生一些不需要纳入版本控制的文件或目录（如编译生成的文件、日志文件、IDE 配置文件等）。您可以通过设置忽略规则来避免这些文件被提交。

  1. 在您希望忽略的文件或目录上右键单击，选择“TortoiseSVN” -> “Add to ignore list”（添加到忽略列表）。
  2. 您可以选择忽略单个文件，或选择忽略所有具有相同扩展名的文件（例如：*.log）。
  3. 忽略规则会添加到当前目录的 svn:ignore 属性中，您需要提交该属性的更改才能使忽略规则生效。

3.7 分支与标记 (Branch/Tag)

  • 分支 (Branch)：用于创建项目代码的一个独立开发线。通常用于开发新功能、修复紧急 bug 或进行实验性开发，而不会直接影响主线代码（通常是 trunk 或 main）。当分支上的工作完成后，可以将其合并回主线。
  • 标记 (Tag)：用于给版本库中的特定版本打上一个有意义的名称（例如：Release_1.0）。标记通常用于记录重要的里程碑，如软件发布版本。标记一旦创建，其内容通常不应再被修改。

操作步骤：

  1. 在您的工作副本文件夹上右键单击，选择“TortoiseSVN” -> “Branch/Tag…” （分支/标签）。
  2. 在弹出的对话框中，指定源路径（通常是您当前工作副本的 URL）和目标路径（新的分支或标签的 URL），并填写日志信息。
  3. 点击“确定”即可创建分支或标签。

3.8 合并 (Merge)

当您在分支上完成了开发工作，并希望将这些更改集成回主线或其他分支时，需要执行“合并”操作。

  1. 切换到您希望接收合并更改的工作副本（例如，如果您想将功能分支合并到主线，则更新并进入主线的工作副本）。
  2. 在该工作副本文件夹上右键单击，选择“TortoiseSVN” -> “Merge…” （合并）。
  3. 按照合并向导的指示，选择要合并的源（例如，您的功能分支）和版本范围。
  4. 执行合并操作。在合并过程中，如果两个版本库对同一文件的同一部分进行了不同修改，可能会发生冲突 (Conflict)。TortoiseSVN 会标记出冲突的文件，您需要手动解决这些冲突，然后才能提交合并结果。

总结

TortoiseSVN 作为一款集成度高、操作简便的 SVN 客户端，是 Windows 用户进行版本控制的强大工具。通过掌握其安装、检出、更新、提交、添加、撤销修改、忽略文件、分支/标签以及合并等基本操作，您可以有效地管理项目代码，与团队成员高效协作，确保项目的顺利进行。

滚动至顶部