简介：面向 MyEclipse 等 Java IDE 开发者的 SVN 插件离线安装包，解决了开发环境与 Subversion 版本控制服务端集成不便的问题。压缩包内含 site-1.8.22 版本插件及相关组件，适用于需要频繁进行代码提交、更新、冲突合并等版本管理操作的团队和个人开发者。资源共 30 个文件，主要由 27 个 jar 插件模块、1 个 docx 安装说明、1 个 site.xml 更新站点配置和 1 个 index.html 帮助入口组成，压缩包大小 16.9MB。这些 jar 文件分别承担客户端适配、底层协议支持与图形界面展示等功能；docx 文档详细指导在 MyEclipse 10 中安装的完整流程；site.xml 可用于配置插件更新源，整体结构对离线安装非常友好。已有 939 人学习下载。通过这套包，读者既可以快速获得可用的 SVN 图形化操作界面，也可按文档完成插件部署并掌握常见操作要点；同时保留了 features、plugins 目录结构，方便有需要的用户手动调整组件版本或进行二次配置，提升代码版本管理效率。
1. 这是一份能解决 SVN 客户端“功能不够用”的插件包：site-1.8.22
做版本控制的老手都知道，Subversion 自带的客户端只能完成提交、更新、回滚这些基础操作，真正干活的时候，总需要在右键菜单里多几个顺手功能：复制当前文件的版本库 URL、查看服务器端目录结构、一键定位到修改记录对应的文件。Windows 下如果你用的是 TortoiseSVN 一类的图形客户端，装上对应版本的 site 插件，等于给这些操作补齐了快捷键。这个 site-1.8.22 包正是匹配 Subversion 1.8.22 的插件资源，里面除了插件本体还有一份安装说明，不用再去翻论坛、猜路径。适合谁？经常在 Windows 上用 TortoiseSVN 管理多个项目、又不想装全家桶的开发者；也适合刚接手别人 SVN 工程、需要快速把客户端环境配顺手的运维同学。下面我从安装环境开始，一步步把它部署到能用，并把中途常见的坑一并写清楚。
2. 安装前的环境核查：版本、架构、权限一个都不能少
2.1 为什么插件必须和 SVN 版本严格对应
site-1.8.22 的命名已经明示了它对应的 Subversion 版本是 1.8.22，这是一个非常老但至今仍被不少企业项目使用的版本线。SVN 的插件和主程序之间通过动态链接库和特定接口通讯，主程序版本和插件版本不一致，最常见的现象就是右键菜单里看不到插件入口，或者点开直接报“无法定位程序输入点”。有人觉得“我装的是更高版本 SVN，向下兼容肯定没问题”，实际上很多插件只在发布时验证过目标版本，高版本环境里能跑全靠运气。我一般会在安装前先用命令行确认自己的 SVN 客户端版本，别凭感觉装。
检查命令如下：
svn --version --quiet如果系统返回类似1.8.22的版本号，那这份插件就是直接匹配的；如果是1.9.x或更高，建议先确认插件作者是否声明了跨版本兼容。对于 site-1.8.22，最稳妥的环境是 TortoiseSVN 对应的 1.8.22 版本，或者官方 Subversion 1.8.22 的 Win32/Win64 二进制包。
这里需要解释下参数：--version输出完整版本信息，--quiet把多余的语言和平台信息压缩成一行，方便在脚本里判断。如果你没有把 SVN 的 bin 目录加入 PATH，命令会提示找不到，这时用全路径执行，比如"C:\Program Files\Subversion\bin\svn.exe" --version --quiet。
另外需要留意的是，site-1.8.22 这类插件包在执行时还会依赖 SVN 的底层库，比如libsvn_client-1.dll、libsvn_wc-1.dll。即使你的 svn.exe 版本是 1.8.22，但libsvn_*动态库被其他软件覆盖成新版本，插件同样可能加载失败。所以我在安装前还会跑一遍svn --verbose看看库路径，确认库文件的版本号也是一致的。
svn --verbose这条命令会打印客户端版本、库版本以及运行时加载的配置路径。重点看最后几行的Subversion library version是否也是1.8.22。如果库版本不一致，哪怕 exe 版本对上了，后续装插件依然可能出幺蛾子。这一条经常被忽略，却是很多“装插件像碰运气”问题的根源。
2.2 是 32 位还是 64 位，这个坑比版本更隐蔽
SVN 插件的位数必须和客户端进程位数一致。同一个 Subversion 1.8.22，官方会分别发布 Win32 和 Win64 两种包，TortoiseSVN 也有对应的位数区分。site-1.8.22 资源里通常会包含x86和x64两个子目录，安装说明会提示你按实际环境选择。
判断系统位数和 TortoiseSVN 位数的方法：
# 查看 TortoiseSVN 的安装目录，存在 TortoiseProc.exe dir "C:\Program Files\TortoiseSVN\bin" 2>nul & dir "C:\Program Files (x86)\TortoiseSVN\bin" 2>nul我一般看路径：安装到了C:\Program Files\说明是 64 位版本，安装到了C:\Program Files (x86)\则是 32 位版本。如果你的 SVN 是命令行形式，那么看svn.exe所在目录的路径，规律一样。插件复制错位数的现象很典型：文件都放到位了，重启也做了，但系统日志里出现类似“模块已加载，但入口点失败”的事件，多半就是位数错配。遇到这种情况，把插件换成对应位数的文件重来一遍即可。
更隐蔽的位数是“混合环境”：系统是 64 位的，但当初安装 TortoiseSVN 时误装了 32 位版本。这时系统盘里存在两个目录，很多人只看了Program Files下的那个，忽略了另一个。我会用任务管理器确认正在运行的进程位数：打开任务管理器，切到“详细信息”选项卡，找到TortoiseProc.exe或TortoiseSVN.exe，在“平台”列里会显示“32 位”或“64 位”。如果任务管理器没显示这列，右键列标题勾选“平台”即可。
拿到准确的位数后，再决定复制x86还是x64目录下的文件。这个操作本身很简单，但错一次会让你浪费半小时去排查，所以我宁可在这一步多花一分钟把目录看准。
2.3 权限准备：别让 UAC 挡在最后一步
安装 site 插件最常见的操作是把插件文件复制到 TortoiseSVN 的bin目录，或者写入注册表。如果当前用户不是管理员，Windows 的 UAC 会阻止写入Program Files。有人习惯直接把整个目录拖进去，结果提示需要权限，选了“继续”却没真正生效，因为文件被重定向到了虚拟目录。正确做法是提前用管理员身份打开资源管理器或命令行。我一般会先右键“以管理员身份运行”命令提示符，再做文件操作，省得被虚拟化坑到。
具体来说，普通用户复制文件到Program Files下时，Windows 会弹 UAC 提权框，点“是”以后，如果是通过资源管理器拖拽，文件其实被写到了虚拟存储里。我们可以用命令主动检测这个情况：
dir "C:\Users\%USERNAME%\AppData\Local\VirtualStore\Program Files\TortoiseSVN\bin"如果这里出现了你刚才复制过的文件，就说明之前的操作被重定向了。出现这种情况时，先把这个目录下的同名文件删掉，再重新用管理员权限复制一次。我自己的习惯是全程在管理员 CMD 里操作，复制完直接执行dir看文件的时间戳，确认文件确实落到了目标目录。
另外，如果 TortoiseSVN 正在运行，复制 dll 时会被文件占用导致失败。所以复制前最好先把 TortoiseSVN 完全退出，包括托盘图标。这一步和权限准备同样重要。退出以后再做复制，能避免“文件复制成功但没完全写入”的错觉。
2.4 快速读懂资源包里的安装说明
site-1.8.22 包内的“安装说明.txt”通常不长，但里面往往藏着关键路径。我拿到资源包的第一件事是打开这个文件看三行：适用版本、适用位数、安装方式。有些包的说明写着“复制到 TortoiseSVN 安装目录的 bin 下”，有些写着“运行 install.bat”，还有的会要求修改 svnserve.conf 或插件自己的配置文件。不要跳过安装说明直接按网上教程操作，不同插件包的细节差异很大。
另一个值得注意的细节是安装说明里可能提到“需要先安装 KBxxxxxx 补丁”或“需要 VC++ 2010 运行库”。这类依赖信息只有作者在发布时才会写，错过了后面踩坑只能自己猜。我把安装说明单独放到一个记事本窗口，和复制命令并列摆着，每执行一步就对照一句。
到这一步，环境核查基本完成。接下来进入真正的安装流程。
3. 安装 site-1.8.22 插件的标准流程：三步完成，每一步都有依据
3.1 第一步：备份原目录，给自己留后悔药
先别急着复制，TortoiseSVN 的bin目录里可能有同名文件。site 插件通常会覆盖或新增几个动态链接库文件，如果覆盖了原有的库，而后续想卸载插件，没有备份就很难还原。我一般会把整个bin目录打包一份，或者至少把同名的.dll和.exe文件复制到一个备份文件夹。
mkdir D:\backup\tortoise_1.8.22_bin copy "C:\Program Files\TortoiseSVN\bin\*.dll" D:\backup\tortoise_1.8.22_bin\这里只备份 dll 文件，是因为插件对现有文件的影响主要在动态库层面。备份完成后，你可以放心进行覆盖操作，万一出问题，用备份还原即可。注意：如果 TortoiseSVN 安装在Program Files (x86)，命令里的路径也要对应替换。
备份时最好也把当前 TortoiseSVN 的配置目录备份一份。配置文件一般在%APPDATA%\TortoiseSVN下，里面包含服务器地址、缓存路径、右键菜单显示策略等。插件安装出错时，可能需要恢复配置才能回到安装前的状态：
xcopy "%APPDATA%\TortoiseSVN" D:\backup\tortoise_svn_config /E /I /Y/E表示包含空目录，/I表示如果目标目录不存在则创建，/Y是覆盖时不再确认。这几个参数组合起来适合做整目录快照。备份配置的意义在于：部分插件会修改右键菜单排序，卸载时不一定能还原成你原来的顺序，有备份就能直接拷回去。
3.2 第二步：复制插件文件并注册
site-1.8.22 包解开后，你会看到类似这样的结构（这取决于资源里实际打包方式，通常会有说明目录和插件文件）：
site-1.8.22/ ├─ 安装说明.txt ├─ x64/ │ ├─ svnsite.dll │ └─ svnsite.exe └─ x86/ ├─ svnsite.dll └─ svnsite.exe常见的做法是把对应位数的所有文件复制到 TortoiseSVN 的bin目录：
# 假设是64位环境 copy /Y D:\tmp\site-1.8.22\x64\*.* "C:\Program Files\TortoiseSVN\bin\"复制完成后，还需要注册插件。有的插件包会提供register.bat，双击或右键管理员运行即可；如果没提供，就需要用 regsvr32 注册 dll。这里以常见的 svnsite.dll 为例：
cd /d "C:\Program Files\TortoiseSVN\bin" regsvr32 svnsite.dllregsvr32会把动态库中的 COM 接口注册到注册表，TortoiseSVN 启动时通过注册表找到插件。执行后如果弹出“注册成功”的提示框，说明这一步没问题。如果没有弹窗，或者报了 load library 失败，请回头检查位数和依赖的 VC 运行库。
很多插件包里还有一个svnsite.exe，这个 exe 是给命令行调用用的，不需要注册，只要放在 bin 目录里即可。放在 bin 目录的好处是 TortoiseSVN 可以通过相对路径找到它，避免写死绝对路径导致权限或路径变动后失效。
这里有一个经常被忽略的细节：复制文件前，最好看一下安装说明里是否要求“先停止 TortoiseSVN 缓存进程”。TortoiseSVN 有一个名为TSVNCache.exe的后台进程，它持有 SVN 状态缓存，可能会锁住部分文件。如果复制时提示“另一个程序正在使用此文件”，说明没有完全退出 TortoiseSVN。处理办法：
taskkill /f /im TSVNCache.exe taskkill /f /im TortoiseProc.exe杀掉进程后再复制。注意这两个进程被结束后，TortoiseSVN 的图标覆盖会暂时消失，这没关系，重启后会自动重建。
3.3 第三步：重启客户端并验证菜单
注册完成后，需要彻底退出并重新启动 TortoiseSVN 或对应的资源管理器进程。注意“彻底退出”不是关掉设置窗口就行，最好是右键系统托盘图标选择“退出”，然后重新打开。更保险的办法是重启 explorer.exe：
taskkill /f /im explorer.exe & start explorer.exe这行命令会强制结束资源管理器进程，然后重新拉起。TortoiseSVN 的右键菜单和图标覆盖是挂在资源管理器进程上的，不重启 explorer 的话，新插件菜单不会出现。重启后，在任意 SVN 工作副本上点击右键，如果看到“SVN Site”或与 site 相关的菜单项（具体名称以安装说明为准），说明安装成功。
如果右键菜单里没有出现，先别急着判断失败，可以去看 TortoiseSVN 的设置界面。打开设置后，左侧如果多出来一个插件相关的面板，也说明插件已经被识别。面板里通常有“启用”和“禁用”的开关，确认它在启用状态。菜单项的显示还可能受“隐藏菜单管理”影响，在 TortoiseSVN Settings 的 “Menu Settings” 里能搜到插件名，如果它被设置为隐藏，取消勾选就好。
到这步为止，插件已经装上了。但光能看见菜单还不够，还需要知道它的参数怎么配、功能怎么用，下一章讲验证细节。
4. 功能验证与常用参数：把插件的“按钮”调成适合自己的手感
4.1 验证安装是否真的生效，避免玄学成功
很多人看到菜单出现就以为成功了，其实菜单入口可能来自旧配置。更可靠的验证方式是去 TortoiseSVN 的设置窗口看扩展补丁列表。打开任意工作副本的右键菜单，选“TortoiseSVN → Settings”，左侧找到“Revision Graph”或者“Icon Overlays”之外的扩展类目；如果插件的实现走的是 TortoiseSVN 的插件接口，设置里一般会出现对应的插件页面。除此之外，可以打开命令提示符，运行：
reg query "HKCU\Software\TortoiseSVN" /f "site" /s这条命令会在当前用户的 TortoiseSVN 配置项里递归查找包含“site”的字符串。有值时通常说明插件注册成功。注意/f "site"是匹配字符串，/s是递归子项。如果查询结果为空，并不一定代表失败，有些插件不写这个键位，但至少能帮你定位注册表层面的痕迹。
参数说明：这条 reg query 是排查用的，日常不需要执行。真正工作时要关心的是插件的功能参数，通常在设置界面里会有“启用历史复制”“显示本地路径”“URL 前缀映射”等选项。默认参数可能不适合你的服务器习惯，例如服务器根路径是https://svn.example.com/svn/proj，而你本地只关心/trunk下的文件，建议把 URL 前缀裁掉，减少菜单列出信息的长度。
还有一种情况：右键菜单确实出现了，但点击后功能是灰色的。这通常不是安装问题，而是当前目录不是有效的 SVN 工作副本。site 插件的很多功能需要读取.svn目录，如果你在普通文件夹上点击，菜单项会禁用。我测试时喜欢用一个干净的工作副本，先svn checkout一个测试项目，再在里面验证功能，避免把无关目录误判成故障。
4.2 用命令行触发插件：绕过图形界面直接看结果
不少插件支持命令行参数调用，site-1.8.22 中常见的工具svnsite.exe可以配合参数在终端中操作。常见做法是：
# 显示当前目录对应的版本库 URL svnsite.exe info --path . # 拷贝版本库 URL 到剪贴板 svnsite.exe copy-url --path . --clipboard注意：info和copy-url是常见的插件子命令，具体以安装说明中的命令列表为准。参数--path指定工作副本路径，.表示当前目录；--clipboard表示把结果写入剪贴板而不是打印到屏幕。如果你的环境里 TortoiseSVN 的bin目录没加入 PATH，需要用全路径：
"C:\Program Files\TortoiseSVN\bin\svnsite.exe" copy-url --path . --clipboard执行后打开记事本粘贴，如果得到类似https://svn.example.com/svn/proj/trunk/doc/readme.txt的完整 URL，说明插件的核心功能正常。这一步把图形界面外的命令通道打通了，后面写脚本自动收集文件路径时很有用。
另外，我常用svnsite.exe info --path <文件>来获取单个文件的本地修改状态和服务器路径，它比 TortoiseSVN 自带的“属性”窗口更快。如果插件支持--xml参数，还可以把结果输出成 XML 文件，方便写脚本解析：
svnsite.exe info --path . --xml > site_info.xml这个 XML 里会包含工作副本的 uuid、根 URL、以及当前目录的版本号。配合 PowerShell 的ConvertFrom-Xml，可以把这些数据直接读成结构化对象，省得自己去解析文本。
4.3 调整右键菜单排序与 URL 映射参数
site 装完后，右键菜单可能出现多个新项。TortoiseSVN 支持通过注册表调整菜单项位置，但为了少碰系统设置，我一般直接改插件自己的配置：在插件的设置界面里找“菜单名称排序权重”，权重数值越小越靠前。某种情况下，插件的菜单项会落到“TortoiseSVN”下级菜单里，这时候要在插件的配置中开启“显示到顶层菜单”。这个参数不在 TortoiseSVN 原生设置里，需要看安装说明。如果你找不到对应选项，可以用 TortoiseSVN 的 Settings 里的 “Menu Settings” 调整，但注意那是调整 TortoiseSVN 自带菜单，不是插件的。
关于参数调整，我的建议是：初次使用全部保持默认，跑通一个项目后再逐个打开。因为很多插件选项会影响右键菜单的响应速度，比如“启动时自动获取服务器目录”这种功能，在文件夹多的大项目里会让右键菜单卡上几秒。我遇到过一个项目有几千个文件，开启自动获取目录后，右键菜单要转一圈菊花才能弹出来，非常影响体验。后来我把这个参数改成“手动刷新”，菜单就流畅多了。
URL 映射参数是另一个值得配置的点。有些公司会把 SVN 仓库放在https://svnserver.example.com:8443/svn/repos，默认插件会把完整端口路径拼到结果里。如果你希望输出时去掉端口或仓库根，可以在插件配置里设置“移除路径前缀”。例如设置前缀为/svn/repos，那么复制出来的 URL 就变成https://svnserver.example.com/trunk/doc这样的简洁格式。注意这个参数是逐字匹配，不要漏写首尾斜杠，否则映射不生效。
我习惯把常用参数记录在安装说明的空白处，方便下次重装时直接照抄。尤其是权重和前缀这两个，看起来不起眼，但直接影响日常操作效率。
5. 安装使用中的避坑与排查：我踩过的坑都列在这里
5.1 安装后右键菜单没出现
现象：把文件复制到 bin 目录、注册也提示成功，但重启 explorer 后右键菜单完全看不到 site 项目。
原因：最常见的是插件文件被 Windows 的 UAC 虚拟化重定向了。如果你没用管理员权限复制，系统会把Program Files下的写入动作映射到C:\Users\用户名\AppData\Local\VirtualStore\Program Files\TortoiseSVN\bin，实际 bin 目录根本没变。
解决：按Win+R输入%LocalAppData%\VirtualStore，进到对应路径看看有没有同名文件。如果有，把它们删掉，再用管理员身份重新执行复制。更简单的方法是直接以管理员身份运行资源管理器，或者用copy /Y配合提升权限。从那以后，我所有 SVN 插件的安装操作都强制走管理员命令行，不再用普通拖拽。
5.2 提示“无法定位程序输入点”
现象：注册 dll 时报错，提示无法在某个系统 dll 中找到输入点，或者启动 TortoiseSVN 时弹窗报错。
原因：插件的运行时依赖和你系统的 VC++ 运行库不匹配。site-1.8.22 是基于较老的 Visual C++ 库编译的，如果系统里只有新版本 VC++ 运行库，缺少老版本的msvcr100.dll或msvcp100.dll，就会出现这个错。
解决：安装对应的 VC++ 运行库，常见是vcredist_x86.exe和vcredist_x64.exe，注意位数也要匹配。装完运行库后重新注册一遍插件，一般就好。如果还不行，用Dependency Walker之类的工具看插件 dll 依赖，但那个工具太老了，新手建议直接补运行库，别在这一步耗太久。
5.3 插件菜单有，但点了没反应
现象：能看到菜单项，点击后没任何反应，或者闪过一个命令窗口就消失。
原因：插件内置的命令行工具svnsite.exe没有复制到位，或者被安全软件拦截。我只是碰过一次：杀毒软件把 exe 当可疑文件隔离了，菜单调用失败却没有任何提示。
解决：先恢复被隔离的文件，或者把插件目录加入安全软件白名单。然后打开命令提示符手动执行svnsite.exe --help，确认能正常输出帮助信息。如果手动执行正常、菜单点击无反应，检查 TortoiseSVN 配置中插件 exe 的路径是否写死成绝对路径，而这个路径和你实际的安装位置不一致。
5.4 更新 SVN 版本后插件失灵
现象：某次把 TortoiseSVN 从 1.8.22 升级到了 1.9.x，site 插件的菜单全部消失，设置界面里的插件页也找不到了。
原因：插件版本和 TortoiseSVN 版本强绑定，1.9 的 API 结构变过，site-1.8.22 没有适配新版本。凡是看到“1.8.22”这种版本号后缀的插件，它天生只认同一代客户端。
解决：如果你需要继续用这个插件，就别升级 TortoiseSVN，或者找对应新版本的插件。我自己的习惯是：把 TortoiseSVN 的升级设置为手动，每次升级前先查一下自己用的插件有没有对应版本，盲目升级最后只能把 TortoiseSVN 退回老版本，工具还冲突。
5.5 注册了 dll，但重启系统后菜单丢失
现象：当天注册好，右键菜单都正常，第二天开机后又消失了。
原因：有些插件通过环境变量或命令行参数加载，注册表只是写入了入口，但真正生效依赖启动项。如果 TortoiseSVN 启动机制在开机时没触发插件加载，菜单就不出来。还可能是因为你用的 TortoiseSVN 版本是绿色版，没有写启动注册表项。
解决：检查注册表HKCU\Software\Microsoft\Windows\CurrentVersion\Run里有没有 TortoiseSVN 的启动项。没有的话加一个，让 TortoiseSVN 随系统启动；或者每次开机后手动从资源管理器启动一次 TortoiseSVN。更干净的方案是把插件的svnsite.exe复制到系统PATH目录，保证命令行调用可用，即使右键菜单临时消失，还能用命令完成核心操作。
6. 让 site-1.8.22 发挥更大价值：写进批量脚本和日常小技巧
6.1 批量导出工作副本的版本库 URL
site 插件的命令行工具最适合和for循环搭配，批量收集多个项目的 SVN URL，方便生成版本清单。Windows 批处理写法：
@echo off setlocal enabledelayedexpansion for /d %%i in (*) do ( echo ==== %%i ==== "C:\Program Files\TortoiseSVN\bin\svnsite.exe" info --path "%%i" 2>nul ) endlocal这段脚本会遍历当前目录下的所有子文件夹，逐个输入svnsite.exe info --path。2>nul把子项目不是工作副本时的报错隐藏掉，避免刷屏。输出结果可以重定向到文本：把最后一行改成>> urls.txt，所有项目的 URL 就汇总到一个文件里。这个行为在交接项目时特别有用，不用一个个看 SVN 工作副本属性。
6.2 用 PowerShell 封装更复杂的判断
批处理的字符串处理能力弱，如果你要对 URL 做更多加工，我推荐 PowerShell。假设想把每个项目的根 URL 提取出来，并且过滤掉 HTTP 状态码不是 200 的仓库，可以这样写：
Get-ChildItem -Directory | ForEach-Object { $url = & "C:\Program Files\TortoiseSVN\bin\svnsite.exe" info --path $_.FullName --xml if ($LASTEXITCODE -eq 0) { $parsed = [xml]$url $parsed.info.entry.url } }这里--xml输出的内容是 XML，PowerShell 可以直接用[xml]强制转换。$LASTEXITCODE是 PowerShell 拿外部命令退出码的标准变量，如果svnsite.exe返回 0，说明获取成功。这种方式比批处理稳定，路径带空格时也不容易断。
6.3 给右键菜单做减法，保留高频操作
插件装好以后，我习惯把不常用的功能关掉，只留“复制 URL”和“查看修改记录”。这个操作不是改 TortoiseSVN 菜单，而是在 site 插件的设置里把对应功能的开关选成“仅在按住 Shift 时显示”。好处是菜单干净，需要时按住 Shift 再右键，功能依然在；不需要时不会误点。从那以后，我每次拿到新的 SVN 插件，都强制走一遍“先看说明 → 备份 → 管理员复制 → 命令行验证 → 调整菜单权重”的流程，这套流程基本够用。希望帮到你。
本文还有配套的精品资源，点击获取
