SVN Download：快速上手指南 (含代码示例)

Subversion (SVN) 是一个开源的版本控制系统，被广泛用于软件开发和其他需要跟踪文件更改的项目中。svn download 本身并不是一个标准的 SVN 命令，但我们可以通过几个核心的 SVN 命令来实现从 SVN 仓库获取代码（下载）的目的。本文将详细介绍如何使用这些命令，以及相关的最佳实践。

核心概念：检出（Checkout） vs. 导出（Export）

在 SVN 中，获取代码主要有两种方式：

1. 检出 (Checkout): svn checkout 命令会从 SVN 仓库创建一个本地工作副本。这个工作副本不仅仅包含文件的当前版本，还包含了一个隐藏的 .svn 目录，用于跟踪本地修改、与仓库同步等。这是最常用的获取代码的方式，因为它允许你进行后续的提交、更新等操作。
2. 导出 (Export): svn export 命令会从 SVN 仓库获取指定版本的文件和目录，但不会创建 .svn 目录。这相当于创建了一个干净的代码副本，通常用于发布、部署等场景，因为你不需要版本控制信息。

本文主要关注 svn checkout，因为它更符合“下载并使用”的常见需求。

1. 安装 SVN 客户端

在使用 SVN 命令之前，你需要先安装 SVN 客户端。

• Windows:

  • TortoiseSVN: 这是一个非常流行的图形化 SVN 客户端，与 Windows 资源管理器集成，操作非常直观。你可以从 https://tortoisesvn.net/downloads.html 下载。
  • SlikSVN: 这是一个命令行 SVN 客户端，适合喜欢使用命令行的开发者。你可以从 https://sliksvn.com/download/ 下载。
  • CollabNet Subversion: 另一个命令行客户端，可从 https://www.collab.net/downloads/subversion/ 下载.

• macOS:

  • Homebrew: 如果你安装了 Homebrew 包管理器，可以使用 brew install subversion 命令来安装。
  • Xcode Command Line Tools: Xcode 命令行工具通常会包含 SVN。如果没有，可以通过 xcode-select --install 安装。
  • SnailSVN: 类似于TortoiseSVN的图形化客户端: https://langui.net/snailsvn/

• Linux:

  • 大多数 Linux 发行版都自带 SVN 客户端，或者可以通过包管理器安装。例如：
    • Debian/Ubuntu: sudo apt-get install subversion
    • Fedora/CentOS/RHEL: sudo yum install subversion
    • Arch Linux: sudo pacman -S subversion

安装完成后，你可以在命令行终端（Windows 下的 cmd 或 PowerShell，macOS/Linux 下的 Terminal）中输入 svn --version 来验证安装是否成功。如果成功，会显示 SVN 的版本信息。

2. 使用 svn checkout 下载代码

svn checkout 命令的基本语法如下：

bash
svn checkout <repository_url> [<local_path>]

• <repository_url>: 这是 SVN 仓库的 URL。它通常以 http://, https://, svn://, 或 svn+ssh:// 开头。
• [<local_path>]: (可选) 这是你希望将代码下载到的本地目录。如果不指定，SVN 会在当前目录下创建一个与仓库同名的目录。

示例：

假设你的 SVN 仓库 URL 是 https://svn.example.com/myproject/trunk，你想将代码下载到 D:\MyProjects (Windows) 或 ~/MyProjects (macOS/Linux) 目录下：

```bash

Windows

svn checkout https://svn.example.com/myproject/trunk D:\MyProjects\myproject

macOS/Linux

svn checkout https://svn.example.com/myproject/trunk ~/MyProjects/myproject
```

代码解释：

• 该命令将从https://svn.example.com/myproject/trunk下载最新版本（trunk通常是主分支）的代码。
• 代码将被下载到D:\MyProjects\myproject（Windows）或者~/MyProjects/myproject（macOS/Linux）. 如果该文件夹不存在，会自动创建。
• 下载完成后，myproject 文件夹就是一个 SVN 工作副本，包含了 .svn 隐藏目录。

下载特定版本：

如果你不想下载最新版本，而是想下载特定的修订版本（revision），可以使用 -r 选项：

bash
svn checkout -r 123 https://svn.example.com/myproject/trunk ~/MyProjects/myproject_r123

这里，-r 123 表示下载修订版本 123。

下载特定分支或标签:
除了trunk，SVN仓库通常有branches和tags目录。
* Branches（分支）: 用于并行开发，例如开发新功能或修复 bug。
* Tags（标签）: 用于标记特定的版本，例如发布版本。

要下载特定的分支或标签，只需修改 URL：

```bash

下载名为 feature-x 的分支

svn checkout https://svn.example.com/myproject/branches/feature-x ~/MyProjects/feature-x

下载名为 v1.0 的标签

svn checkout https://svn.example.com/myproject/tags/v1.0 ~/MyProjects/v1.0
```

需要身份验证的情况：

如果 SVN 仓库需要用户名和密码，svn checkout 命令会自动提示你输入。你也可以使用 --username 和 --password 选项来提供凭据：

bash
svn checkout --username yourusername --password yourpassword https://svn.example.com/myproject/trunk ~/MyProjects/myproject

重要提示： 出于安全考虑，强烈建议不要在命令行中直接使用 --password 选项，因为它会将密码明文保存在 shell 历史记录中。让 SVN 客户端提示你输入密码更安全。大多数 SVN 客户端都会提供记住密码的选项。

3. svn export 导出代码 (不含 .svn 目录)

svn export主要用于创建干净的代码副本，常用于：
* 发布版本： 创建不含版本控制信息的发布包。
* 部署代码： 将代码部署到服务器上，不需要 .svn 目录。
* 创建干净的备份： 备份代码，但不包含 SVN 元数据。

语法：

bash
svn export <repository_url> <local_path>

与 svn checkout 类似，<repository_url> 是仓库 URL，<local_path> 是本地目录。

示例：

bash
svn export https://svn.example.com/myproject/tags/v1.0 ~/MyProjects/myproject_v1.0_release

导出特定修订版本：

bash
svn export -r 123 https://svn.example.com/myproject/trunk ~/MyProjects/myproject_r123_export
注意： svn export 不会创建 .svn 目录，因此你无法在这个导出的副本上执行 SVN 的提交、更新等操作。

4. SVN 工作副本的常用操作

一旦你使用 svn checkout 创建了工作副本，就可以进行各种 SVN 操作了。

• svn update (更新): 将工作副本同步到仓库的最新版本（或指定版本）。

  bash
svn update # 更新到最新版本
svn update -r 150 #更新到指定版本

• svn add (添加): 将新文件或目录添加到版本控制。

  bash
svn add newfile.txt
svn add newdir
  注意，add只是将文件纳入版本控制，必须使用commit提交到远程仓库。

• svn delete (删除): 从版本控制中删除文件或目录。

  bash
svn delete oldfile.txt
svn delete olddir
  同样，delete只是标记删除，必须使用commit提交到远程仓库。

• svn commit (提交): 将本地修改提交到仓库。

  bash
svn commit -m "Added new feature" #提交所有更改
svn commit -m "Fixed a bug in file1.txt" file1.txt #提交指定文件
-m 选项用于添加提交消息，这是非常重要的，因为它记录了你所做的更改。

• svn status (状态): 查看工作副本的状态，显示哪些文件被修改、添加、删除等。

  bash
svn status
  常见的状态码：
  * M: Modified (已修改)
  * A: Added (已添加)
  * D: Deleted (已删除)
  * ?: Not under version control (未纳入版本控制)
  * !: Missing (丢失，通常是被外部工具删除了)
  * C: Conflicted (冲突, 更新时本地和服务端都有修改，需要手动解决)

• svn revert (还原): 撤销本地修改，恢复到未修改的状态。

  bash
svn revert file1.txt # 还原单个文件
svn revert -R . # 还原整个工作副本（-R 表示递归）

• svn log (日志): 查看提交历史。

  bash
svn log # 查看所有提交历史
svn log -l 5 # 查看最近5次提交
svn log file1.txt #查看特定文件的提交

• svn diff (差异): 显示本地修改与仓库版本的差异.

  bash
svn diff file1.txt # 比较 file1.txt 的本地修改与仓库版本
svn diff -r 100:105 file1.txt # 比较 file1.txt 的修订版本 100 和 105 之间的差异

• svn info (信息): 显示工作副本或仓库 URL 的详细信息。

  bash
svn info # 显示当前工作副本的信息
svn info https://svn.example.com/myproject/trunk # 显示仓库 URL 的信息

• svn merge (合并): 将一个分支的更改合并到另一个分支（或主干）。这是一个更高级的操作，需要谨慎使用。

• svn switch (切换): 更改你的工作副本到不同的分支或者标签。

  bash
svn switch https://svn.example.com/myproject/branches/feature-x

5. 处理冲突

当多人同时修改同一个文件的同一部分时，可能会发生冲突。SVN 会在 svn update 时检测到冲突，并在文件中插入冲突标记。

冲突标记示例：

```
<<<<<<< .mine
This is my local change.
=======
This is the change from the repository.

.r123
```

• <<<<<<< .mine 到 ======= 之间是你的本地修改。
• ======= 到 >>>>>>> .r123 之间是仓库中的修改（.r123 表示修订版本号）。

你需要手动编辑文件，解决冲突，然后删除冲突标记。解决冲突后，使用 svn resolved 命令标记冲突已解决：

bash
svn resolved conflicted_file.txt

然后，你可以使用 svn commit 提交解决后的版本。

6. 最佳实践

• 经常更新: 定期使用 svn update 获取最新的代码，以减少冲突的可能性。
• 提交小而频繁的更改: 不要等到做了大量修改才提交。小的提交更容易管理，也更容易回滚。
• 写清楚提交消息: 提交消息应该清晰地描述你所做的更改，以便其他人（包括未来的你）理解。
• 使用分支进行并行开发: 如果你要开发一个新功能或修复一个复杂的 bug，应该创建一个新的分支，而不是直接在主干（trunk）上修改。
• 使用标签标记重要版本: 当你发布一个版本时，应该创建一个标签，以便将来可以轻松地回溯到这个版本。
• 不要提交不需要的文件: 例如，编译生成的中间文件（.o, .class 等）、IDE 的配置文件等，不应该提交到 SVN 仓库。可以使用 svn:ignore 属性来忽略这些文件。
• 了解你的工具: TortoiseSVN或者其他的GUI客户端虽然简化了操作，但是最好也了解下对应的命令行操作。

7. 总结

本文详细介绍了如何使用 SVN 下载代码（svn checkout 和 svn export），以及 SVN 工作副本的常用操作。通过掌握这些基本命令和最佳实践，你可以有效地使用 SVN 进行版本控制，并与团队成员协作开发。 SVN 仍然是一个成熟且可靠的版本控制系统，尤其适合中小型项目和对集中式版本控制有需求的项目。