1. 项目概述：TortoiseSVN是什么，为什么现在还有人离不开它
看到TortoiseSVN这个标题，可能有些人会觉得这是老古董了——毕竟这几年Git和GitHub声量那么大，新项目几乎清一色用Git。但说句实在话，我到今天还在用TortoiseSVN，而且不少公司的内部项目、文档管理、甚至UI切图版本管理，依然跑在SVN上。它的优势不是"新"，而是"简单直接、权限清楚、上手成本极低"。
TortoiseSVN是Windows下最流行的SVN（Subversion）图形客户端，最标志性的特点就是它在资源管理器右键菜单里直接集成，所有的检出、提交、更新、加锁、回滚都靠右键完成，完全不需要记命令行，也不像某些IDE内置的SVN插件那样必须打开工程才能操作。你只需要安装一次，之后在任意文件夹里点击右键就能管理版本，这种"所见即所得"的使用体验，对新手和跨团队协作来说非常友好。
这篇博文把三件最基本但也最容易出问题的事一次讲透：安装、汉化、卸载。三件事看起来都很简单，但我在实际帮同事和自己装机的过程中，踩过不少坑——版本位数选错、汉化包和主程序版本不匹配、卸载之后右键菜单残留、甚至卸载顺序不对导致后续重新安装失败。所以这篇文章不是简单贴几张图，而是把这些坑背后的原理和判断逻辑一起讲明白，让你以后再遇到TortoiseSVN相关的问题，能自己判断出问题出在哪个环节。
这篇内容适合所有要安装或管理TortoiseSVN的人，不管是刚接触版本控制的新手，还是要在新电脑上快速配置开发环境的运维和开发，都能从中找到可直接照做的步骤。我尽量把每一步的"为什么这么做"也讲清楚，只有理解了背后的逻辑，遇到异常时才知道去哪排查。
2. 安装前的准备：版本怎么选，下载源怎么找
2.1 决定命运的第一步：32位还是64位
这一步决定了你后面几乎所有操作是否顺利。TortoiseSVN的安装包是一个非常体系化的工具包，它包含SVN客户端核心、右键菜单插件、图标覆盖管理、以及一部分依赖的C++运行库。主程序安装包的位数必须和你的Windows系统位数匹配，而不是和你装的软件位数匹配。
很多人在这一步会犯一个常见错误：觉得自己装的是32位软件，就选32位的TortoiseSVN，这是不对的。判断依据只有一个：Windows系统本身是32位还是64位。怎么查看？右键"此电脑"→选择"属性"，在系统类型这一栏会清楚写着"64位操作系统"或者"32位操作系统"。如果你的系统是64位的，就选64位安装包；如果系统是32位的，才选32位安装包。
实际工作中我遇到过一台工作电脑是64位Windows 7，同事看着别的软件都装了32位版，想当然也选了32位的TortoiseSVN。装上之后表面看起来一切正常，右键菜单也有图标，但一执行"检出（SVN Checkout）"就报错，提示无法加载某些库文件。最后排查到就是位数不匹配导致的底层库调用失败。这类问题安装时不提示、使用时才爆发，非常隐蔽。
2.2 汉化包版本必须和主程序版本完全一致
安装前还有一件重要的事情，就是确定你要不要汉化。如果需要，汉化包的选择有硬性要求：语言包的版本必须和主程序版本完全一致，差一个版本号都不行。举例来说，如果你下载的是TortoiseSVN 1.14.6（64位），那么语言包也必须找1.14.6（64位）的对应版本。我之前见过有人装了1.14.5的主程序，却下了1.14.6的汉化包，结果安装时根本没报错，但进到设置界面语言列表里就是找不到中文选项，来回折腾半天才意识到是版本不匹配。
这里有个误区要纠正：语言包本身不区分"中英文"，安装语言包和安装主程序是两回事。语言包相当于给TortoiseSVN提供了多语言的字幕文件，安装完之后还需要在设置里手动切换语言，这样才能从英文界面变成中文界面。这个切换方法后面汉化部分会详细说。
2.3 下载渠道的正确打开方式
官方网站是tortoisesvn.net，打开页面后首页就能看到Download区域。这个页面上通常有两个主要入口：一个是当前稳定版的下载，另一个是往期版本归档（版本存档）。对于大多数用户，直接下载当前推荐版本即可；但如果你的系统是老的32位系统，或者需要和团队其他人的客户端版本保持严格一致，到版本归档页选择对应历史版本也是一个稳妥做法。
下载页面会列出多个文件，一般包含这样几个类型：安装程序本体（安装版）、语言包（Language Pack）、调试符号文件（不用管）、以及签名校验文件（服务端开发用，不用管）。你只需要认准主安装程序和对应版本的语言包就能满足基本需求。
有些第三方下载站会把TortoiseSVN重新打包，捆绑其他推广软件，或者干脆用旧版本冒充新版本。我的建议是尽量走官网，别用第三方渠道。官网下载速度一般也够用，实在觉得慢就找公司的内网镜像或者可信的软件管家类工具，但版本校验一定要做——装完之后在"关于"里核对一下版本号。
2.4 安装前是否需要配置依赖环境
TortoiseSVN在Windows 10和Windows 11上基本是零依赖安装，系统自带运行库就能跑起来。但在Windows 7或稍老系统上，偶尔会提示缺少VC++运行库。如果安装过程中弹出类似"缺少MSVCR120.dll"之类的提示，先去微软官方下载并安装对应版本的Visual C++ Redistributable包。这个依赖库是微软官方基础组件，安装一次之后系统里很多软件都能共用，属于常规前置操作。
另外，TortoiseSVN安装完通常需要重启资源管理器或者注销一次登录，让右键菜单和图标覆盖生效。Windows 10/11一般自动刷新，但老系统偶尔要手动重启一次才能看到效果。在安装这一步不用过分纠结，如果装完发现右键没有TortoiseSVN菜单，先别急着重装，注销再登录一次往往就解决了。
3. 安装全流程详细图解：从双击到右键菜单出现
3.1 安装向导的每一个界面填什么
双击下载好的安装exe文件之后，会进入安装向导。第一屏是欢迎页，显示软件名称和版本信息，点击"Next"继续。这一屏不需要做任何选择，但建议顺手看一眼版本号，记住这个数字，后面汉化时要用。
第二屏是授权协议，几乎没有悬念，选"同意"然后下一步。
第三屏是安装组件选择。这里有两种选择模式：默认安装和自定义安装。一般用户直接选默认即可，因为默认已经把所有必要功能都选中了。但我个人建议在这里点击一下"Advanced（高级）"按钮看一看，里面有三个关键选项值得了解。
第一个选项和图标覆盖层（Icon Overlay）有关，默认会开启所有覆盖图标，包括"正常"、"已修改"、"冲突"等状态图标。如果你在资源管理器里发现文件图标上多层小绿勾不显示，大概率是这一步配置或者Windows图标可容纳的限制问题，这个等到问题排查一节再细说。
第二个选项是关于外壳扩展（Shell Extension）的。这决定TortoiseSVN和右键菜单的集成方式，默认是"Windows Shell集成"，保持默认即可。有些环境下右键菜单不展示，可能和系统安装了其他右键菜单管理器冲突有关，但这不是安装阶段能解决的。
第三个选项是命令行工具是否安装。SVN官方命令行工具和TortoiseSVN不是一回事，TortoiseSVN默认不安装命令行工具。如果你平时会用svn commit这类命令来做脚本自动化，安装时勾选"command line client tools"这一项，否则后续就算装了TortoiseSVN，在CMD里敲svn依然会提示命令不可用。这对开发人员来说是个容易忽略的细节。
组件选择完后会问安装路径，默认在C:\Program Files\TortoiseSVN下。除非C盘空间紧张，否则不建议改路径，因为默认路径在权限和兼容性方面问题最少。如果非要改，记住不要放在中文路径和工作目录的父级目录下。
3.2 安装过程的三个关键节点
安装正式开始后，会有几个值得关注的信息点。第一，安装进度条走完不代表安装完成，还可能会有一个"重启资源管理器"的选项弹出来，建议勾选，或者选择稍后手动注销，效果相同。第二，文件复制完成后系统会尝试验证shell扩展是否注册成功，这一步可能出现延迟，不用管，等向导跑完。第三，安装向导最后一屏会显示"Finish"，这时不要着急，留意有没有"启动TortoiseSVN设置"之类的勾选，如果没有就正常结束。
装完后别急着用，先做这三件基础验证：
第一，在桌面空白处或者任意文件夹内点击右键，看菜单栏里是否出现"SVN Checkout"、"TortoiseSVN"以及"SVN Update"这三类菜单项。如果出现，说明外壳集成生效。
第二，按快捷键Win+R，输入TortoiseProc.exe然后回车，如果能打开TortoiseSVN的设置窗口（Settings），说明主程序安装完整。
第三，打开命令行，输入svn --version看看是否有输出。这一步只有在第3.1节勾选了命令行工具时才有结果；没勾选的话会提示"不是内部或外部命令"。如果你需要这条命令，不用重装整个软件，直接用TortoiseSVN的安装文件运行一遍，在组件选择里补勾上命令行工具即可，然后再从资源管理器右键菜单或程序菜单里的"Repair（修复）"执行一次修复。
3.3 安装完毕后的首个设置建议
安装完不等于能直接舒服地使用，我每次装完TortoiseSVN第一件事是到设置里做三个调整。
第一个调整在设置窗口的"General"选项卡，把"Language（语言）"改成中文。语言选项只有在装了语言包之后才会显示，否则只有一个英语。所以如果你没打算装语言包，这步可以跳过。
第二个调整在"Context Menu"选项卡，把右键菜单里不常用的项目取消勾选。默认右键菜单里会有一大串TortoiseSVN相关的子项，比如"Add"、"Blame"、"Lock"、"Clean up"等。个人建议把最常用的"Update"、"Commit"、"Show log"保留，其他一律从右键主菜单隐藏掉。这样工作时右键菜单清爽很多，不会被长长的列表淹没。要说明的是，这些项目只是不在右键主菜单显示，不会影响TortoiseSVN主窗口里的完整功能。
第三个调整是设置代理或账号缓存的位置。如果你们公司是通过HTTP协议访问SVN服务器，在"Settings"的"Network"选项卡里可以配置代理地址；如果使用svn://协议，则不需要代理。账号密码一般由系统或TortoiseSVN自动保存，不用额外设置，但对共享电脑，建议在第一次输入账号密码时不要勾选"保存认证信息"，避免账号泄露。
到这里，安装这件事就彻底做完了。接下来看汉化。
4. 汉化详细配置：装好语言包只是第一步
4.1 语言包的精确安装
汉化的前提是已经确定了主程序的确切版本和位数。假设你装的是TortoiseSVN 1.14.6（64位），那么下载的语言包文件也应该叫LanguagePack_1.14.6_x64之类。这个文件比主程序小得多，通常只有几兆到十几兆。
语言包的安装过程和主程序类似，也是一个exe安装向导，但步骤极其简单。双击运行，同意协议，选安装路径（一般会自动识别C盘已有的TortoiseSVN主程序目录），然后直接Finish即可。安装过程中不需要配置任何东西，它会把语言文件复制到主程序的Languages目录下，并在注册表里注册对应的语言条目。
这里有一个很容易被忽略的细节：语言包的位数也必须和主程序一致。32位的TortoiseSVN装进64位语言包，系统不会报"版本不匹配"这种明错误，但安装完之后你在设置的语言下拉菜单里根本看不到这个语言项，或者即便看到了，切换后界面还是英文。这种"静默失败"远比安装过程报错更让人头疼，因为排查方向会走偏。所以装完语言包后，第一件事是到设置的语言下拉框里检查，如果看到"中文（简体）"且切换后界面正常，说明成功；如果看不到，先怀疑位数和版本号匹配问题，再去重新下载。
4.2 在Settings里切换语言的操作细节
语言包装好后，打开TortoiseSVN的Settings窗口，路径是：右键任意文件夹或桌面 → 选择"TortoiseSVN" → 在子菜单里找到"Settings"并打开。
在设置窗口的"General"选项卡下，"Language"这一行是一个下拉选择框。里面会列出所有已经安装的语言，如果之前装过语言包，那么会多出"中文（简体）"项。选择该项后，点击窗口下方的"确定"或"应用"。此时不需要重启电脑或注销，TortoiseSVN的整个UI界面会立即刷新为中文。
你会注意到，不仅是设置窗口变中文，右键菜单里的"SVN Update"也变成了"SVN 更新"，"SVN Commit"变成了"SVN 提交"。这是因为右键菜单的文案也由TortoiseSVN的语言包驱动。如果右键菜单依然是英文，但设置界面已经是中文，说明右键菜单的刷新没有及时完成，注销一次或者重启资源管理器就能解决。
有个我没少遇过的情况是：设置界面已经切到中文了，但TortoiseSVN的有些子窗口（比如提交窗口、日志窗口、版本图窗口）局部还是英文。这种情况多数发生在老版本上，或者说是某些对话框没有对应的翻译资源。解决办法一是升级到最新版本对应的语言包，二是把系统时区调成中国时区，排除语言环境识别问题。后者听起来玄学，但我真在Windows 7上遇到过因为系统区域设置不对导致部分资源加载不到对应语言条目，修正系统区域后问题消失的情况。
4.3 汉化后的体验差异：不只是界面变中文
很多人以为汉化只是把英文标签翻成中文，实质差别不大。实际使用中，汉化带来的红利更多是"操作理解成本降低"和"报错信息可读性提高"。TortoiseSVN在更新或提交时，经常会弹出对话框提示冲突、跳过或者属性变更。这些信息在英文界面下对非英语用户非常不友好，一个"skipped"就让不少人摸不着头脑。汉化之后变成了明确的"已跳过"，配合对话框里的详细解释，新手能在几秒钟内理解发生了什么，而不是到处搜翻译。
我建议即使是平时用英文软件很顺手的开发者也至少体验一下中文界面，不是为了表明什么，而是在处理一些突发错误时，母语界面能极大缩短你的判断时间。特别是进度列表里那些状态提示，中文版比英文版直观一个量级。
5. 彻底卸载：为什么直接删文件夹是不行的
5.1 卸载流程的正确顺序
卸载TortoiseSVN和安装一样，必须在控制台卸载，不能直接在安装目录里删文件夹。TortoiseSVN不仅仅是一堆文件，它还在注册表注册了Shell扩展、右键菜单、文件类型关联、以及系统服务（TortoiseSVN有时会注册一个用于图标覆盖的服务）。只删文件会导致大量残留：右键菜单项还在但点了没反应，文件图标上的绿色钩子悬浮不散，重新安装新版本时系统提示"未正确卸载，请先卸载旧版本"。
正确的卸载顺序是：先退出所有正在运行的TortoiseSVN相关进程，包括TortoiseProc.exe和TortoiseSVN的缓存进程，然后打开Windows设置或控制面板，找到"程序和功能"列表，定位到TortoiseSVN，点击"卸载（Uninstall）"。
卸载向导会询问是否保留配置文件和本地缓存。我的建议是：如果你确定要彻底不再使用，就选择删除所有配置和缓存；如果只是暂时卸载，以后还要装回来，可以保留配置和本地缓存，这样下次装完可以直接沿用之前的账号信息和设置项。
卸载完成后，系统一般会自动刷新Shell。如果发现右键菜单里还有TortoiseSVN的残留项目，不用急着去改注册表，先重启一次资源管理器或者注销再登录，绝大多数情况残留项会消失。
5.2 残留问题的诊断和清理
如果卸载完资源管理器里右键TortoiseSVN菜单依然存在，说明Shell扩展的注册信息没有完全清理，这时可以用TortoiseSVN自带的方式检测和修复。快捷键Win+R输入regedit打开注册表编辑器（这个操作需要管理员权限），定位到HKEY_CLASSES_ROOT\Directory\shell和HKEY_CLASSES_ROOT\Directory\shellex\ContextMenuHandlers这两个路径，手动查找和TortoiseSVN相关的项并删除。
不过要提醒一句：手动改注册表永远是最后手段，操作前先备份注册表或者创建系统还原点。Shell扩展注册项的路径比较复杂，误删其他软件条目可能导致系统问题。如果只是TortoiseSVN右键菜单残留，优先试试下面这个更安全的办法。
还有一个"重启Explorer"的技巧：在任务管理器（Ctrl+Shift+Esc）里找到"Windows 资源管理器"，右键选择"重新启动"。这样会刷新Shell，让右键菜单、图标覆盖状态重新加载。十次残留问题有八九次靠这个就能解决，比折腾注册表安全多了。
5.3 卸载和重新安装的连带问题
常见的一个场景是：用户觉得TortoiseSVN坏了，先卸载再装新版本，装到一半报错，提示"已经安装了一个更新的版本"或者"安装被中断，请重启电脑后重试"。这往往是因为旧版本的卸载没有完全结束，注册表里还残留着版本信息，导致新版检测到"系统上已有其他版本"而拒绝安装。
遇到这种问题，第一件事是检查"程序和功能"里是否还残留TortoiseSVN条目。如果有，说明卸载没有真正完成，重新执行卸载。如果列表里已经没有条目，但安装还是报错，就要排查Windows Installer的缓存和注册表条目，这两处的删除需要管理员权限，且操作前务必创建注册表备份。
还有一类问题发生在公司电脑或者域环境中：组策略限制了Shell扩展注册，导致卸载后菜单项无法刷新。这种环境下的处理建议是不要硬删注册表，先把问题反馈给IT管理员，让他们在域策略层面对Shell扩展做统一管理。贸然改动可能会触发安全策略，带来更大的麻烦。
5.4 卸载前最好先备份的工作清单
如果你手上有多个工作目录已经从SVN仓库检出来了，卸载前要注意，TortoiseSVN的卸载不会删除你在本地工作副本里的.svn目录，这些目录的数据不会丢，等你重新安装后再右键"更新"即可继续使用。但为了保险，我建议卸载前做一个"本地修改检查"：在每个工作目录上右键 → TortoiseSVN → Check for modifications，确认没有未提交的修改。如果看到了未提交的文件，先提交，否则卸载期间这些文件虽然还在，但脱离版本控制状态，后续重装再恢复会相对麻烦。
另外，如果有计划要跨大版本重装（比如从1.13升级到1.14），建议卸载前备份设置：Settings窗口左下角有"Export"导出功能，可以保存现有的配置，包括语言选择、外部工具路径、缓存设置等。导出的配置在装完新版后一键导入，能省不少时间。
6. 高频问题排查：图标不显示、冲突、账号提示这些坑怎么填
6.1 文件图标上的绿色小勾不显示
TortoiseSVN的标志性功能之一就是文件图标的覆盖状态：绿色勾表示正常、红色感叹号表示冲突、蓝色加号表示新增等。但经常有人装完发现文件夹图标上干干净净，一个标记都没有，立刻怀疑是不是安装出了问题。
其实这不是安装问题，而是Windows本身限制了Shell图标覆盖的数量——具体来说，Windows对资源管理器中每个文件的覆盖图个数有上限，当系统中杀毒软件、网盘客户端、同步工具等软件使用了大量覆盖图后，TortoiseSVN的图标就被挤掉，不会显示了。
TortoiseSVN设置里提供了一个"Icon Overlays"选项页，在里面可以调整哪些状态需要覆盖图，优先级可以自己定义。一般默认设置是全部开启，如果你只是希望至少看到"已修改"和"冲突"两种状态，可以把不必要的覆盖图类型调整为"禁用"，给图标腾出空间。这种方法实测很有效，尤其在装了新版百度网盘、坚果云这类工具的电脑上。
另外有个点要说明：TortoiseSVN是在"文件图标"上覆盖图的，如果你在列表视图把图标显示关闭了，那么覆盖图也会消失。回归"详细信息"视图并开启文件图标显示后，图标就回来了。
6.2 更新时报"skipped, remains conflicted"怎么处理
这是热搜词里提到的高频问题，也是SVN新手最容易慌的场景。字面意思是"已跳过，仍处于冲突状态"。这个状态意味着当前文件存在代码冲突，而且你还没有做出解决冲突的决定。
TortoiseSVN把冲突过程设计得很明确：当你在更新（Update）或合并（Merge）时，若本地修改和服务器上的修改在同一个文件的同一个区域发生碰撞，系统不会用任意一方的版本覆盖你，而是进入冲突状态。此时文件会生成三个临时文件：.mine（你本地版本）、.rXXX（你修改前的版本）、.rYYY（服务器最新版本），在文件图标上显示红色感叹号。
接下来的处理流程是：右键冲突文件 → TortoiseSVN → Edit conflicts，会打开冲突合并工具，左侧通常显示你的版本，右侧显示服务器版本，中间是最终合并结果，你逐行选择保留哪边的修改，然后保存为"已解决"状态。解决后，再右键该文件选择"Resolved"，此时冲突状态清除，"skipped, remains conflicted"这种提示就不会再出现了。
很多人在这一步犯的错误是：看到冲突提示，直接手动编辑文件把内容改成自己想要的，然后去Commit。结果提交时发现TortoiseSVN还是提示冲突未解决。因为系统记录冲突状态并不是看文件内容变没变，而是看你在冲突管理器中是否执行了"Mark as resolved"这一动作。所以记住这个顺序：编辑冲突工具合并内容 → 保存 → 标记已解决 → 提交。
6.3 关于"登录账号"的说明
"TortoiseSVN登录账号"这个热搜词经常出现，很多新手以为TortoiseSVN像网盘或聊天软件一样需要注册一个账号登录。其实TortoiseSVN本身没有账号体系，它是一个客户端工具，你访问的SVN服务器才是账号的持有方。服务器可能是自己公司部署的SVN Server，也可能是托管服务商提供的仓库。
当你在检出或更新时第一次被要求输入用户名密码，这个账号是由服务器管理员分配的，不是你注册出来的。TortoiseSVN会把认证信息缓存在本地，后续不再提示。如果某天你换了电脑或者服务器重置了密码，需要重新输入，可以在"Settings"的"Saved Data"选项卡中清空认证数据缓存，这样下次访问时会再次弹出登录框。
如果使用http/https协议访问SVN仓库，账号认证还可能合并Windows域账号体系，这时你输入的可能不是仓库专用账号，而是公司域账号。使用svn://协议时，则是标准的SVN账号认证。这个区别在排查"登录不上"类问题时很有用：先确认服务器地址，再确认协议类型，再去问管理员要对应账号。
6.4 右键菜单里某些操作灰色不可点击
这个问题多见于文件处于某些特殊状态。比如在某个只读目录下，或者在从未执行过检出（Checkout）的普通文件夹里，"SVN Update"和"SVN Commit"都是灰色不可用的，因为这两个操作必须在工作副本目录内才能执行。工作副本是指通过TortoiseSVN执行过"检出"操作后生成的本地目录，内部包含.svn元数据目录。
遇到灰色的情况，第一反应应该是：当前文件夹到底是不是一个已检出的工作副本。判断方法是在资源管理器地址栏输入%APPDATA%\TortoiseSVN查看配置，或者在文件夹右键菜单里看有没有"SVN Checkout"这个选项存在——如果存在且可用，说明这个文件夹不是工作副本，需要先执行检出，之后Update和Commit才可能变成可用状态。
另一个原因是文件被标记为"加锁"或"只读"，此时更新和提交也会受限。右键查看文件属性就能看到只读状态，通过TortoiseSVN的"Release lock"释放锁后，操作就恢复了。
6.5 安装、汉化、卸载流程的避坑清单
我把这些年帮别人装机时遇到的所有高频坑整理成一个速查表，放在这里方便你对照：
| 问题现象 | 根本原因 | 解决方案 |
|---|---|---|
| 检出时报加载库错误 | 安装包位数与系统位数不匹配 | 查系统位数，重新下对应位数包 |
| 安装后右键无菜单 | Shell未刷新 | 注销或重启资源管理器 |
| 语言列表里没有中文 | 语言包版本/位数与主程序不匹配 | 重新下载完全匹配的语言包 |
| 设置已切中文但部分窗口英文 | 语言资源缓存未刷新/系统区域不符 | 重启一次，检查系统区域设置 |
| 文件图标覆盖图不显示 | 覆盖图数量超Windows上限 | 在Icon Overlays里精简不需要的状态 |
| 提交时报skipped/conflicted | 冲突未标记解决 | 用冲突工具标记已解决后再提交 |
| 登录账号找不到 | 账号由服务器端管理 | 联系SVN管理员获取或重置账号密码 |
| 卸载后重装报错 | 卸载残留未清理完整 | 确认列表里无残留，必要时清注册表 |
这张表里的每一个问题，实际工作中我都踩过或者帮人排查过。其中最隐蔽的是覆盖图不显示和冲突未标记，这两个都容易被误判成"软件坏了"，其实都是配置或操作习惯层面的问题。
7. 完整实战：装好TortoiseSVN后第一天该做什么
7.1 第一步：从零开始检出第一个项目
假设你们公司新给你配了一台电脑，已经按照前面流程装好TortoiseSVN并完成汉化。现在的目标是把你负责的项目代码从服务器取到本地。
第一步：在你想放代码的目录下，比如D盘根目录，右键空白处，选择"SVN检出"（SVN Checkout）。此时会弹出一个对话框，要求填写"版本库URL"。这个地址是服务器管理员提供的，形如svn://192.168.1.100/svn/project或者http://svn.company.com/svn/project。注意不要填错了协议类型。
第二步：选择"检出目录"（Checkout directory），系统会默认把你当前所在的目录作为检出位置，也可以在后面追加一个项目子目录名。一般建议单独建一个项目名文件夹，避免把一堆工程文件堆在根目录。
第三步：如果服务器配置了认证，这时会弹出一个登录框，输入服务器给你的账号密码。建议第一次登录时不要勾选"保存"，等确认这个账号是长期用的再选择记住。完成这一步，系统会开始拉取代码，进度窗口里显示每一个文件的状态。检出完成后，你的本地文件夹就是一个受版本控制的工作副本，所有和服务器相关操作都在这个局域内进行。
7.2 第二步：每天工作的标准动作
使用TortoiseSVN的日常流程其实只有三个动作：更新、修改、提交。
每天开工前，在地目录上右键，选择"SVN更新"。这一步把服务器上其他人提交的修改拉到你本地。更新后如果没有任何冲突提示，就可以开始新的开发。
开发过程中的修改不需要做任何额外动作，TortoiseSVN通过文件图标的覆盖状态告诉你哪些文件被改动过。改好的文件图标上会出现红色感叹号或一个小的红色标记。
当一段功能完成、代码稳定后，右键选择"SVN提交"，在弹出的提交窗口里勾选要提交的文件，填入提交说明（commit message），然后确认提交。提交说明这一项重要且容易被忽视，建议养成写清楚的习惯，比如"修复登录模块空指针问题"，而不是写"修改了一点东西"。
这个流程看着简单，但恰恰是因为简单，才更适合中小团队。没有学习Git分支合并的成本，也不需要考虑远程分支同步问题，所有人围绕一条主干线协作，权限清清楚楚。
7.3 第三步：查看历史和对比差异
日常工作里最有用的另一个功能是查看日志。右键任意文件选择"TortoiseSVN"→"显示日志"，就能看到这个文件的每一次提交记录、提交时间、提交人和变更说明。如果发现某个版本出了问题，可以选中该版本文件，右键"显示历史版本"把它导出，用"与我的版本比较"功能查看差异。
对比差异（Diff）是TortoiseSVN隐藏的好用功能。在冲突或代码审查场景下，右键选中两个版本的同一文件，选择"比较版本差异"，系统会用内置的比较工具把差异以行列级别显示出来，左边本地、右边服务器，新增删除的行高亮标出。如果你安装了Beyond Compare这类第三方比较工具，也可以在设置里把它设置为外部差异工具，比较体验会更好。
8. 安全和权限视角：用TortoiseSVN值得留意的几件事
8.1 账号密码的安全管理
TortoiseSVN会把认证信息保存在本地Windows凭据管理器里，这在单机使用环境下是方便的，但如果是公用电脑、会议室电脑、或者离职交接的旧机器，务必在"Settings"→"Saved Data"里清空认证缓存。否则下一个使用这台电脑的人，点一下更新就直接以你的身份连接了SVN服务器。
我见过不止一次因为这种缓存没清理，导致离职员工的账号继续被"借用"提交代码，排查起来非常困难，因为提交记录里显示的都是已经离职的人的名字。这个风险在团队里传播后，大家对SVN的信任度会直线下降。所以，离开公共电脑前，把认证数据清掉是对自己也是对公司负责。
8.2 分布式团队和使用协议的建议
如果团队成员不在同一个局域网，SVN服务器一般部署在公网或专网上，这时要考虑网络稳定性和传输安全。使用https协议访问仓库比svn://协议更安全，也更容易通过企业防火墙。如果公司内部对源代码的传输有加密要求，建议优先开启https访问，并确保客户端和服务器都校验证书。
权限控制层面，SVN的目录级权限管理做得比想象中细。管理员可以为不同目录单独配置只读、可写、禁止访问等权限。客户端这边不需要做太多配置，但如果你发现某个目录可以检出却无法提交，不要当软件故障，这是服务器端权限策略在起作用。
8.3 和杀毒软件/安全软件的兼容
Windows安全中心或者第三方杀毒软件有时会把TortoiseSVN的shell扩展误判为可疑行为，尤其当它尝试修改注册表项或者注入资源管理器时。如果你安装时一切正常，但某天突然右键菜单消失或者不响应，先去安全中心的威胁记录里看有没有TortoiseSVN相关的拦截记录。
遇到这类情况，把TortoiseSVN的安装目录和缓存目录加入信任列表即可。目前我实测下来，Windows Defender默认不会拦截TortoiseSVN，但一些企业定制的终端安全管理软件会弹出警告。针对这类软件，最好不要强硬关闭它的防护，而是联系IT把TortoiseSVN加入白名单，保证功能和安全的一体化。
9. 后续扩展：安装完成之后可以持续优化的细节
TortoiseSVN的潜力比大多数人以为的要大，装好只是开始。以下几件事我在不同团队里实践过，收益都不错。
第一，设置自动更新。不需要每天手动点更新，可以配置计划任务或者使用TortoiseSVN的命令行参数/command:update，让它每天定时抓取服务器上的最新代码。对测试环境和文档目录管理尤其好用。
第二，和持续集成工具联动。TortoiseSVN支持命令行执行操作，等于你可以把代码更新、导出、甚至构建脚本绑定在一起。很多团队用Jenkins从SVN仓库拉代码构建时，底层就是SVN命令行工具在工作。如果你的编译和测试都是脚本化的，SVN的命令行接口非常值得研究。
第三，版本控制不只适用于代码。TortoiseSVN同样适用于设计稿、配置文件、甚至合同文档的版本管理。设置好提交权限和目录结构后，设计团队可以在同一条SVN仓库里管理切图源文件，每次修改都留下历史记录，避免了"最终版v2最终版v3不信任版"这种命名游戏的灾难。
换个角度讲，TortoiseSVN的学习曲线非常缓和。你不需要了解内部存储机制就能开始用，等用顺手了，再回头了解版本控制的基础概念——工作副本、版本库、基线与合并，一切都是水到渠成的事。
我个人在实际操作中的体会是，很多人反复安装卸载TortoiseSVN，问题往往不是软件本身难装，而是在安装前对版本和汉化包的匹配意识不够，在卸载时又少了几分对Shell扩展和缓存清理的了解。把这几件事想明白，安装、汉化、卸载就变成一个十分钟就能完成的流程。最后再分享一个小技巧：如果你手头同时维护多台电脑，装完后记得用设置里的"导出（Export）"备份一次配置，下次换新电脑导入设置，连右键菜单的偏好都会被一起恢复，省时省力。
