在服务器上使用 SVN 下载文件夹，最直接的方法是先通过 svn list 确认远程仓库路径，随后用 svn checkout 命令将该文件夹连同其版本信息完整拉取到当前目录。
SVN 从服务器拉取文件到底是怎么运作的？
很多刚接触 SVN 的运维朋友会误以为它跟 FTP 一样，只能看到什么下载什么，SVN（Subversion）的下载逻辑完全不同：它是基于版本号的文件快照同步，你执行的 checkout（检出）操作，本质上是把服务器上某个目录的最新版本（或指定版本）连同隐藏的 .svn 元数据一起还原到本地。
这套机制决定了两个关键点：
- 你必须知道仓库的完整 URL（
svn://192.168.1.100/repos/project/trunk/web），服务器不支持像文件管理器那样一层层点进去再选“下载”。 - 你下载到的不仅仅是文件内容，还有本地版本基线，下次修改后能直接
commit，也能用svn update增量同步。
业内专家指出，超过七成的 SVN 使用问题都源于“把 SVN 当 FTP 用”这个认知误区，搞清楚这个前提,再去敲命令就顺理成章了。
第一步：怎么在服务器上查看远程仓库里有什么文件夹
在动手下载之前，总得先看看服务器上到底存在哪些路径，此时用 svn list 命令，可以直接列出远程目录内容，不占用本地磁盘空间,非常轻量。
svn list svn://192.168.1.100/repos/project
执行后,你会看到类似这样的输出：
branches/ tags/ trunk/
如果知道大致路径,直接加上子目录名称继续查看：
svn list svn://192.168.1.100/repos/project/trunk/src
这种逐级确认路径的方式，比盲猜 URL 要稳妥得多，要是发现仓库访问权限受限，输出可能会要求输入用户名和密码,属于正常现象。
第二步：最核心的操作用 svn checkout 下载整个文件夹
确认路径无误后,下载整个文件夹的命令如下：
svn checkout svn://192.168.1.100/repos/project/trunk/web /home/user/web
对应参数的含义：
- 第一个参数是远程仓库的完整目录路径。
- 第二个参数是本地存放的目标位置，如果省略，SVN 会默认将远程目录名（这里是
web）创建在当前目录下。
执行过程会输出每个被拉取的文件路径以及版本号，最后出现 Checked out revision 1234 字样就代表成功了，如果后续服务器上的同事改了代码,你只需进入这个本地文件夹运行：
svn update
就能只下载增量部分,不必重来一遍。
重点场景：svn checkout 只下载某个文件夹层级怎么写
实际业务中，经常遇到仓库里同时存放着 app、doc、database 等多个模块，而你只想拉取其中某个子文件夹的场景，SVN 的路径精确到哪一层，就下载哪一层。
具体做法是，将 URL 直接指定到该文件夹本身：
svn checkout svn://192.168.1.100/repos/project/trunk/database
这条命令只会拉取 database 目录下的所有内容，不会牵连同级其他目录。但有一个常见误区必须避开：当执行上述命令后，database 目录内部的 .svn 元数据会记录其父级路径为 trunk，如果你试图用同样的命令再下载 app 目录到同一个父目录下,可能会产生工作副本嵌套混淆。
比较稳妥的做法是,给每个要单独下载的文件夹分配独立的本地目录：
svn checkout svn://192.168.1.100/repos/project/trunk/database /data/database svn checkout svn://192.168.1.100/repos/project/trunk/app /data/app
这样两个目录互不干扰，各自都能独立执行 svn update。
另一个思路：用 sparse checkout 实现按需下载文件夹内部的子集
如果服务器上某个文件夹体积巨大（例如包含海量历史资源文件），但你只需要其中两个子目录，此时可以借助 SVN 的 sparse（稀疏）模式来按需拉取。
操作分三步，先指定 --depth 参数初始化：
svn checkout --depth empty svn://192.168.1.100/repos/project/trunk/web /data/web
这条命令只会在本地生成一个空的 web 目录，不下载任何具体文件，随后进入该目录,更新指定子文件夹：
cd /data/web svn update --set-depth infinity images svn update --set-depth infinity js
执行完这两个子目录的内容才会真正落到本地，如果想取消某个子目录的下载（例如误操作后想释放空间），可以将其深度设置为 exclude：
svn update --set-depth exclude images
这种操作方式在服务器磁盘空间不充裕时极为实用，也是 SVN 老玩家惯用的手法。
服务器上无法直接下载？改用 svn export 导出发布文件
部分生产环境出于安全考虑，不允许保留 .svn 元数据（避免泄露版本库地址和提交者信息）。export 命令应运而生，它能将远程文件夹原样导出为一个干净目录，不含任何 SVN 痕迹。
svn export svn://192.168.1.100/repos/project/trunk/web /home/www/web
| 对比维度 | svn checkout |
svn export |
|---|---|---|
生成 .svn 元数据 |
是 | 否 |
支持 svn update 增量更新 |
支持 | 不支持 |
| 用于日常开发编辑 | 适合 | 不适合 |
| 用于打包部署发布 | 不推荐 | 适合 |
行业共识认为，开发机用 checkout，生产服务器部署用 export 是较为理想的分工，生产环境不保留版本信息,能显著降低被攻击者针对性利用的风险。
命令执行卡住或下载被拒？常见的报错排查方向
服务器环境中网络策略、权限配置比较复杂，以下三类报错出现频率较高,可以按顺序排查：
Authorization failed：当前用户对该目录无读权限，需要管理员在仓库的authz配置文件中补充权限规则，[/project/trunk/database]下设置user = r。Unable to connect to a repository：网络不通，或者 SVN 服务端口（默认3690）被防火墙拦截，先用telnet 服务器IP 3690验证端口连通性。Working copy locked：之前强制中断了 update，导致本地锁残留，进入对应目录执行svn cleanup即可释放锁。
另外补充一个重要细节：如果目标是 https:// 开头的 SVN 仓库（Apache 方式托管），证书过期同样会导致下载失败，通常需要执行 svn upgrade --accept theirs-conflict 或更新本机证书信任链。
SVN 服务器下载文件夹的常见疑问解答
问：SVN 能不能像网盘一样直接右键点击某个文件夹下载？
答：纯命令行的 SVN 服务端不支持这种方式，如果是通过 VisualSVN Server 或 WebSVN 这类带 Web 界面的工具管理的仓库，可以登录网页端浏览目录并打包下载，但打包操作消耗的是服务器 CPU 资源，大目录容易超时，绝大多数情况下，仍建议使用 svn checkout 命令拉取。
问：svn checkout 下载的文件夹内容为什么和我预期的不一样？
答：可能性较多，最常见的是你之前用同一本地目录检查过其他分支的代码，工作副本未切换干净，建议先运行 svn info 查看当前工作副本对应的仓库 URL 与实际期望的 URL 是否一致，如果不同，使用 svn switch 切换分支后再继续。
问：下载一半中断了，能不能断点续传？
答：SVN 本身没有显式的断点续传开关，但你可以重新执行相同的 svn checkout 命令，SVN 会自动检测本地已有的文件，通过比对版本号只补充缺失的内容，效果等同于断点续传，前提是不要删除中断时生成的未完成目录。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/753689.html
