简介：TortoiseSVN（俗称小乌龟）是一款面向Windows用户的Subversion版本控制客户端，适合个人开发者与团队协作场景，用于解决代码版本管理、多人协同修改与历史追溯等问题。资源以rar压缩包形式提供，整体约16.73MB，安装后可直接集成到资源管理器右键菜单，无需命令行即可完成检出、提交、更新等操作。包内围绕SVN基础操作、版本控制、分支合并、忽略列表、代理与钩子脚本配置、故障排查等模块展开，涵盖检出与提交流程、冲突解决、Log历史查看、Diff差异比较、分支与合并策略、认证信息保存等实用知识点，可帮助读者快速上手并理解团队协作中的版本管理思路。目前已有1019人学习下载，适合需要系统掌握SVN客户端操作、提升代码协作效率的开发者参考使用。
1. 小乌龟 TortoiseSVN 安装前，先把版本和依赖理清楚
很多人第一次装 TortoiseSVN，以为双击 exe 一路下一步就完事，结果重启资源管理器之后右键菜单里死活找不到图标，或者连上公司内网的 SVN 仓库时提示“无法连接”“证书校验失败”。这类问题十有八九不是软件本身坏了，而是版本没对齐、命令行客户端没勾选、或者系统架构装错了。TortoiseSVN 是 Windows 上最常用的 SVN 客户端之一，它把版本控制操作直接嵌进资源管理器的右键菜单，检出、提交、更新、查看日志都在图形界面里完成，对不习惯命令行的开发者非常友好。但它有个特点：安装包分 32 位和 64 位，还依赖一个可选的命令行工具组件，装的时候少勾一个选项，后面用脚本或 IDE 集成时就会各种报错。这篇笔记按“装什么版本 → 怎么装 → 怎么配 → 坏了怎么救 → 怎么验证”的顺序走一遍，适合刚接手 SVN 仓库、需要在 Windows 上快速搭好客户端环境的人。
2. 下载与安装：版本选择、组件勾选和静默安装参数
2.1 版本怎么选，32 位还是 64 位
TortoiseSVN 的版本号跟 Subversion 的版本是两条线。TortoiseSVN 自身版本迭代到 1.14.x 系列，底层绑定的 SVN 库版本会在安装包说明里标注。选版本时优先看两件事：一是你的 Windows 是 64 位还是 32 位，二是团队 SVN 服务端的版本。服务端如果是 1.8 以上的老仓库，客户端用 1.14.x 一般都能兼容，因为 SVN 协议向下兼容做得比较好。但如果服务端启用了某些新特性（比如特定认证方式），客户端版本太低就会连不上。
判断系统架构最简单的方法是在 PowerShell 里跑一句：
# 查看操作系统架构，x64 表示 64 位系统 echo $env:PROCESSOR_ARCHITECTURE输出AMD64就是 64 位，输出x86才是 32 位。现在绝大多数开发机都是 64 位，直接下 64 位安装包即可。装错架构的典型现象是：安装过程正常，但右键菜单不出现，或者出现后点击无响应。这是因为 32 位的 shell 扩展没法被 64 位资源管理器加载。
提示：不要同时装 32 位和 64 位两个版本，shell 扩展会冲突，右键菜单可能直接消失。
2.2 安装时那几个勾选项到底要不要选
TortoiseSVN 安装向导里有两个关键勾选项容易被忽略：
第一个是command line client tools。这个选项默认是“不安装”的，但它会往系统里放svn.exe。很多 IDE（比如某些老版本的开发工具）和构建脚本在集成 SVN 时，底层就是调svn.exe。如果你只装图形界面不装命令行工具，IDE 里配置 SVN 路径时就会找不到可执行文件。我一般会把它选上，占不了多少空间，但能省掉后面很多麻烦。
第二个是Windows Explorer integration下的子项。这里控制右键菜单显示哪些条目，比如SVN Checkout、SVN Update、SVN Commit。默认全勾就行，除非你确实嫌右键菜单太长。
安装路径建议保持默认的C:\Program Files\TortoiseSVN，不要装到中文路径或带空格的深层目录下，某些老脚本对路径里的空格处理不好。
2.3 用静默参数批量装，适合多台机器
如果你要给多台开发机统一装，可以用命令行静默安装。TortoiseSVN 的安装包基于 MSI，支持标准参数：
# 静默安装，自动勾选命令行工具，不重启 TortoiseSVN-1.14.x-x64.msi /quiet /norestart ADDLOCAL=CLI,MainFeature/quiet表示无界面安装，/norestart表示装完不自动重启，ADDLOCAL指定要安装的功能组件，CLI就是命令行工具，MainFeature是主程序。参数名大小写不敏感，但组件名要写对，写错了安装会直接失败并回滚。装完之后资源管理器的右键菜单不会立刻出现，需要重启explorer.exe或者注销一次。
# 重启资源管理器，让 shell 扩展生效 taskkill /f /im explorer.exe start explorer.exe这两句在 cmd 里执行即可。注意taskkill会关掉所有资源管理器窗口，执行前把没保存的文件先存好。
3. 首次配置：仓库地址、认证缓存和全局忽略
3.1 检出仓库前的连接配置
装好之后第一次用，通常是右键某个空文件夹选SVN Checkout，然后填仓库 URL。这里有几个参数值得注意：
URL of repository：填服务端给的 SVN 地址，格式一般是svn://host/path或https://host/svn/path。如果是https开头，走的是 HTTP 协议，需要服务端配了 WebDAV 模块；svn://走的是原生 SVN 协议，端口默认 3690。Checkout directory：本地存放路径，建议用纯英文路径。Checkout depth：检出深度。默认Fully recursive是全量检出。如果仓库很大，第一次可以选Immediate children only只检出顶层，后面再按需更新子目录。
点 OK 之后如果弹出认证框，输入服务端分配的用户名密码。TortoiseSVN 默认会把认证信息缓存到%APPDATA%\Subversion\auth目录下，下次不用重复输入。如果公司要求每次都必须手动输入，可以在Settings → Saved Data里把Authentication data清掉，并取消保存。
3.2 全局忽略配置，别把编译产物提交上去
SVN 和 Git 不一样，它没有.gitignore那种仓库级忽略文件（虽然可以通过svn:ignore属性实现目录级忽略），但 TortoiseSVN 提供了一个全局忽略配置，对所有工作副本生效。路径在Settings → General → Global ignore pattern。
默认已经忽略了一些常见文件，但实际项目里还需要补。比如某类项目会生成bin、obj、*.user、*.suo这些编译中间产物，如果不忽略，提交时列表里全是这些文件，很容易误提交。
# 全局忽略模式示例，多个模式用空格分隔 *.o *.lo *.la *.al .libs *.so *.so.[0-9]* *.a *.pyc *.pyo __pycache__ bin obj *.user *.suo这段配置写在全局忽略输入框里即可。*.o、*.so是 Linux 下常见编译产物，*.pyc、__pycache__是 Python 的，bin、obj、*.user、*.suo是 Windows 开发常见的。注意全局忽略只对“尚未纳入版本控制”的文件生效，如果某个文件已经被提交过，再加忽略规则也不会让它从提交列表里消失，得先用svn delete从仓库移除。
3.3 认证缓存和代理设置
如果开发机在公司内网，访问外网 SVN 服务端可能需要走内部代理。TortoiseSVN 的代理配置在Settings → Network，可以填代理地址和端口，也可以勾选“使用系统代理”。但要注意，如果 SVN 服务端本身就在内网，走代理反而连不上，这时候要把内网地址加到例外列表里。
认证缓存的位置前面提过，在%APPDATA%\Subversion\auth。如果换了密码或者账号被锁，旧缓存会导致一直认证失败，这时候直接把这个目录清空，重新检出时会重新弹认证框。
注意：清空
auth目录会丢失所有已保存的仓库认证信息，如果同时连了多个仓库，需要重新输入一遍。
4. 避坑与排查：右键菜单消失、认证失败、锁文件
4.1 右键菜单里没有 TortoiseSVN 选项
现象：装完重启后，右键任意文件夹，菜单里找不到SVN Checkout等条目。
原因：最常见的是 shell 扩展没被资源管理器加载。64 位系统装了 32 位版本，或者安装时Windows Explorer integration组件没勾选，都会导致这个问题。另一个原因是资源管理器进程没有重启，shell 扩展还是旧的。
解决：先确认装的版本和系统架构一致，然后在Settings → General里检查Context Menu相关选项是否被关掉。如果都正常，手动重启explorer.exe。还不行就重新运行安装包选Repair修复一遍。
4.2 检出时提示“Unable to connect to a repository”
现象：填完 URL 点 OK，转圈一会儿后报连接失败。
原因：分几种情况。URL 写错（比如svn://写成了http://）、服务端端口没开、防火墙拦截、或者 DNS 解析不到主机名。
解决：先用ping和telnet确认主机和端口通不通。如果是svn://协议，默认端口 3690，用telnet host 3690测一下。如果是https://，确认服务端的 WebDAV 路径是否正确，有些服务端的 SVN 路径是https://host/svn/repo而不是https://host/repo。另外检查 TortoiseSVN 的代理设置，内网仓库不要走代理。
4.3 提交时提示“Working copy locked”
现象：执行更新或提交时提示工作副本被锁，操作无法继续。
原因：上一次操作中途被强制中断（比如手动关了窗口、进程被杀），SVN 在工作副本里留了锁文件。
解决：右键工作副本根目录，选TortoiseSVN → Clean up，在弹出的对话框里勾选Break locks，然后执行。这个操作会清理掉残留的锁，让工作副本恢复正常。如果 Clean up 也失败，可能是.svn目录损坏，那就只能重新检出。
4.4 认证信息一直弹窗，勾了保存也没用
现象：每次操作都弹认证框，明明勾了“保存认证信息”。
原因：%APPDATA%\Subversion\auth目录权限不对，或者被安全软件拦截了写入。另一个可能是服务端禁用了认证缓存（比如配置了每次请求都要求重新认证）。
解决：先检查auth目录是否存在且可写。如果被安全软件拦了，把 TortoiseSVN 加到白名单。如果是服务端策略，那就只能每次手动输入，或者改用 SSH 密钥方式认证（如果服务端支持）。
4.5 更新时提示“skipped”或文件被标记为冲突
现象：更新后某些文件变成黄色感叹号，提示冲突。
原因：本地修改和服务端修改同时发生在同一个文件的同一区域，SVN 没法自动合并。
解决：右键冲突文件选Edit conflicts，TortoiseSVN 会打开合并工具，把本地版本和服务端版本并排显示，手动选择保留哪边。处理完后选Resolved标记冲突已解决，然后正常提交。如果改错了想重来，可以选Revert放弃本地修改，重新更新。
5. 装完怎么验证：从检出到提交走一遍完整链路
装好配好之后，别急着往项目里用，先拿一个测试仓库走一遍完整流程，确认每个环节都通。我一般会按下面这个顺序验证：
第一步，找一个空目录，右键SVN Checkout，填入测试仓库 URL，检出深度选Fully recursive。如果仓库是空的，检出后目录里只会多一个.svn隐藏文件夹，这是正常的。
第二步，在检出目录里新建一个文本文件，右键选TortoiseSVN → Add，文件图标会变成蓝色加号，表示已加入版本控制但还没提交。
第三步，右键目录选SVN Commit，在提交窗口里确认文件列表和提交信息，点 OK。如果提交成功，文件图标会变成绿色对勾。
第四步，修改这个文件的内容，保存后图标变成红色感叹号，表示有本地修改未提交。再执行一次SVN Update，确认没有冲突提示。
第五步，右键选TortoiseSVN → Show Log，能看到刚才的提交记录，说明服务端和客户端的通信链路完全正常。
# 用命令行验证 svn.exe 是否可用 svn --version --quiet如果这条命令输出了版本号，说明命令行工具也装好了。这一步很关键，因为很多 IDE 集成 SVN 时就是靠这个可执行文件。如果提示“不是内部或外部命令”，说明安装时没勾command line client tools，重新运行安装包选Modify把组件加上。
验证过程中如果任何一步卡住，回到第 4 章对应的小节排查。全部走通之后，这套环境就可以正常用于日常开发了。从那以后我每次装完 TortoiseSVN，都会先拿一个空仓库走一遍检出、添加、提交、更新、看日志这五步，确认没问题再往正式项目里用。希望帮到你。
本文还有配套的精品资源，点击获取
把每个部分讲成人话)
