我会分两种情况来讲解,因为“服务器”的含义可能不同:

- 最常见的情况:从一个已经存在的 SVN 仓库地址检出代码。 (你从同事那里得到了一个 URL)
- 较少见的情况:你自己的电脑上运行着一个 SVN 服务器,需要从本地服务器检出。
从标准的 SVN 仓库地址下载(最常用)
这是绝大多数开发者会遇到的情况,你只需要一个仓库的 URL 就可以了。
前提条件
- 已安装 TortoiseSVN:如果你的电脑上没有,请先去 TortoiseSVN 官网 下载并安装。
- 拥有仓库的访问权限:你需要知道仓库的 URL,并且有用户名和密码(如果仓库需要认证)。
- 目标文件夹:你想把代码下载(检出)到电脑的哪个位置。
详细步骤
假设你的 SVN 仓库地址是 https://svn.mycompany.com/project/my_app,你想把它下载到 D:\Workspace\my_app 文件夹。
第 1 步:创建一个空文件夹
在你的电脑上创建一个用于存放代码的空文件夹,在 D: 盘下创建一个名为 Workspace 的文件夹,然后在里面创建一个名为 my_app 的空文件夹。

第 2 步:右键点击,选择“SVN 检出...”
在你刚刚创建的 空文件夹 (D:\Workspace\my_app) 上点击鼠标右键,在弹出的菜单中选择 SVN Checkout... (有时也简写为“检出...”)。
注意:一定要在空文件夹上操作,这样 TortoiseSVN 才知道要把所有文件都放在这里,如果在一个已有内容的文件夹上操作,可能会导致错误。
第 3 步:填写仓库信息和选项

会弹出一个“检出”对话框,你需要填写以下信息:
-
版本库 URL (Repository URL)
- 在这里输入你的 SVN 仓库地址,
https://svn.mycompany.com/project/my_app - 如果不确定 URL 是否正确,可以点击 "确定" 按钮旁边的 "测试 URL" 按钮,如果能连接成功,会显示一个绿色的对勾。
- 在这里输入你的 SVN 仓库地址,
-
目标目录 (Checkout directory)
- 这里会自动填充你右键点击的那个文件夹路径,
D:\Workspace\my_app,通常你不需要修改。
- 这里会自动填充你右键点击的那个文件夹路径,
-
检出深度 (Checkout depth)
- 这是一个非常重要的选项! 它决定了你下载多少内容。
- 完全递归 (Fully recursive):默认选项,会下载整个仓库,包括所有文件和文件夹(包括子文件夹里的内容),对于第一次下载一个完整项目,选择这个。
- 仅文件 (Files only):只下载当前 URL 下的文件,不下载任何子文件夹。
- 立即检出 (Immediate children):只下载当前 URL 下的文件和一级子文件夹,不进入更深层的子文件夹。
- 工作副本 (Working copy):这个选项通常用于更新或切换,第一次下载时不建议使用。
-
Revision (版本号)
- HEAD revision:默认选项,表示下载仓库中最新的版本,对于第一次下载,通常选择这个。
- 你也可以指定一个具体的版本号,100,来下载那个特定时间点的代码版本。
第 4 步:认证(如果需要)
如果你的仓库需要用户名和密码才能访问,在点击 "OK" 后,会弹出认证对话框。
- 输入你的 用户名 和 密码。
- 勾选 "保存认证信息",这样下次就不需要再输入了。
- 点击 "确定"。
第 5 步:等待下载完成
TortoiseSVN 开始从服务器下载文件,你会看到一个进度窗口,显示正在下载的文件和进度条。
下载完成后,你的 D:\Workspace\my_app 文件夹里就会充满项目的文件和文件夹,并且每个文件和文件夹前面都有一个绿色的 标记,这表示这是一个“干净”的工作副本。
至此,你已经成功从 TortoiseSVN 服务器下载了代码!
从你自己的本地 SVN 服务器下载
如果你在自己的电脑上安装并运行了一个 SVN 服务器(使用 VisualSVN Server 或 svnserve),并且仓库就在本地,操作步骤和上面完全一样。
唯一的区别在于 “版本库 URL” 的格式。
-
如果使用
file://协议(不推荐,仅限单机测试)- URL 格式:
file:///D:/svn_repos/my_app - 注意:
file://后面是三个斜杠,然后直接跟你的本地硬盘路径。
- URL 格式:
-
如果使用
svn://或svn+ssh://协议(推荐用于本地网络)- URL 格式:
svn://localhost/my_app或svn://192.168.1.100/my_app localhost代表你自己的电脑,如果你的服务器在网络中的其他电脑上,请使用那台电脑的 IP 地址。
- URL 格式:
-
如果使用
http://或https://协议(如果本地服务器配置了 WebDAV)- URL 格式:
http://localhost:8080/svn/my_app - 这和场景一的 URL 格式完全一样,只是地址指向了你的本地服务器。
- URL 格式:
操作步骤:同样是在本地空文件夹上右键 -> SVN Checkout...,然后填入上面适合你的本地 URL,后续步骤和场景一完全相同。
常见问题与技巧
-
Q: 下载速度很慢怎么办?
A: 检查网络连接,确认防火墙没有阻止 TortoiseSVN,如果仓库在国外,可以考虑使用 VPN 或代理。
-
Q: 忘记了用户名或密码怎么办?
- A: 你可以在 Windows 的 凭据管理器 中找到 TortoiseSVN 保存的凭据,或者联系仓库管理员重置。
-
Q: 什么是“工作副本”?
- A: 就是通过“检出”操作创建的、包含了
.svn隐藏文件夹的本地目录,这个.svn文件夹记录了与服务器版本的关系,让你可以进行后续的更新、提交、添加等操作。
- A: 就是通过“检出”操作创建的、包含了
-
Q: 我想更新已下载的代码怎么办?
- A: 在你的项目文件夹上右键,选择 "SVN 更新" (SVN Update),即可获取服务器上最新的代码变更。
