Subversion（简称SVN）是一个开源的版本控制系统，广泛应用于软件项目管理中，它通过命令行工具提供了强大的版本控制功能，本文将详细介绍如何使用Subversion命令行工具下载（检出）代码仓库，包括基本命令、参数选项、实际应用场景以及常见问题的解决方案，Subversion的命令行工具是svn，几乎所有操作都可以通过这个命令完成，而下载代码仓库的基本命令是svn checkout（或其简写形式svn co）。
基本命令格式
使用Subversion命令行下载代码仓库的基本格式如下：
svn checkout [选项] 仓库地址 [本地目录]仓库地址是SVN服务器的URL，可以是http://、https://、svn://或file://等协议；本地目录是代码下载后保存的本地路径，如果省略，则默认使用仓库名称作为目录名，要下载一个HTTP协议的代码仓库到本地myproject目录，可以执行：
svn checkout http://svn.example.com/project myproject常用参数选项
svn checkout命令支持多种参数选项，以下是一些常用的选项及其作用：
--username：指定访问仓库的用户名。svn checkout --username admin http://svn.example.com/project。--password：指定访问仓库的密码，注意：直接在命令行中输入密码可能不安全，建议使用--password-from-stdin或配置认证文件。--revision（或-r）：指定要检出的版本号。svn checkout -r 123 http://svn.example.com/project表示检出版本123的代码。--depth：指定检出的深度，可以是empty（空目录）、files（文件）、immediates（直接子目录）或infinite（全部，默认）。svn checkout --depth empty http://svn.example.com/project仅检出项目根目录。--force：强制覆盖本地已修改的文件。--quiet（或-q）：以安静模式运行，减少输出信息。--non-interactive：禁用交互式提示，适用于脚本环境。
实际应用示例
基本检出操作
假设要下载一个公开的SVN仓库（无需认证），可以直接执行：
svn checkout http://svn.example.com/project执行后,SVN会在当前目录下创建一个名为project的文件夹，并下载所有文件和目录。
指定用户名和密码
对于需要认证的私有仓库,可以通过以下方式指定凭据：
svn checkout --username myuser --password mypass http://svn.example.com/project但更安全的方式是使用svn的配置文件存储凭据，在用户主目录下创建~/.subversion/auth/目录，并通过交互式登录让SVN自动保存认证信息。
检出特定版本
如果只需要某个历史版本的代码,可以使用-r参数，检出项目最后一次提交的版本：
svn checkout -r HEAD http://svn.example.com/project检出版本号为100的代码：
svn checkout -r 100 http://svn.example.com/project浅层检出（部分下载）
对于大型项目,可能只需要部分目录或文件，可以使用--depth参数实现浅层检出，仅检出项目根目录和src子目录：
svn checkout --depth immediates http://svn.example.com/project
svn update --depth infinity project/src # 单独更新src目录使用HTTPS协议
如果仓库使用HTTPS协议,可能需要处理SSL证书验证问题，可以通过以下选项跳过证书检查（不推荐用于生产环境）：
svn checkout --trust-server-cert --non-interactive https://svn.example.com/project常见问题及解决方案
问题1：SVN下载时提示“Authentication failed”如何解决？
解答：通常是因为用户名或密码错误，或仓库权限不足，可以通过以下步骤排查：
- 检查用户名和密码是否正确,确保账户有读取权限。
- 使用
--username和--password参数重新尝试，或通过svn login命令交互式登录。 - 如果仓库使用LDAP或Kerberos等认证方式,需要确保本地环境已正确配置认证工具。
问题2：下载过程中出现“Repository moved permanently”错误怎么办？
解答：该错误表示仓库的URL已变更（如HTTP迁移到HTTPS），需要：
- 使用新的URL重新执行
svn checkout。 - 如果已存在本地工作副本,可以通过
svn switch --relocate命令更新URL：svn switch --relocate http://old-url https://new-url
相关问答FAQs
Q1：如何查看SVN仓库的可用版本列表？
A1：可以使用svn log命令查看提交历史，其中包含版本号。svn log http://svn.example.com/project会显示所有提交记录，每行以r123开头的即为版本号，也可以通过svn list -v http://svn.example.com/project查看目录内容的版本信息。
Q2：能否在下载过程中排除某些文件或目录？
A2：Subversion本身不支持直接排除文件，但可以通过以下方法实现：
- 先检出整个项目,然后手动删除不需要的文件或目录。
- 使用
svn export命令导出文件（不包含SVN元数据），结合--ignore-externals参数忽略外部链接。 - 对于大型项目,可以在服务器端配置
svn:ignore属性，但需要在检出后手动更新。
