1. 問(wèn)題現(xiàn)象與產(chǎn)生根源1.1 你遇到的可能不止一種“無(wú)法安裝”先說(shuō)現(xiàn)象。我見(jiàn)過(guò)的情況五花八門(mén)但歸納起來(lái)其實(shí)就幾類(lèi)安裝向?qū)ё叩揭话脒M(jìn)度條不動(dòng)了過(guò)一會(huì)彈出回滾提示告訴你安裝被中斷。雙擊安裝包直接彈窗說(shuō)系統(tǒng)里有另一個(gè)版本正在安裝或者提示需要先移除舊版本。安裝完成提示成功但右鍵菜單里根本找不到TortoiseSVN版本信息也調(diào)不出來(lái)。更隱蔽的安裝前看控制面板已經(jīng)找不到TortoiseSVN了但安裝時(shí)仍然提示沖突。這些現(xiàn)象背后的原因高度一致——系統(tǒng)里還殘留著舊版本的痕跡而新安裝程序在做檢查時(shí)發(fā)現(xiàn)了這些痕跡出于自我保護(hù)選擇了中止。1.2 為什么舊版本殘留會(huì)讓新版本裝不上TortoiseSVN的安裝機(jī)制比較特殊它不只是往系統(tǒng)里拷貝文件還做了三件重要的事向Windows注冊(cè)Shell擴(kuò)展把右鍵菜單、圖標(biāo)覆蓋層掛到資源管理器上。注冊(cè)COM組件讓資源管理器能夠調(diào)用它的DLL。注冊(cè)緩存服務(wù)TSVNCache用于在工作副本目錄里顯示文件狀態(tài)圖標(biāo)。這三件事都要修改系統(tǒng)層面的配置。安裝程序在寫(xiě)入之前會(huì)先檢查這些位置是否已經(jīng)被占用。如果舊版本卸載不干凈殘留的注冊(cè)表項(xiàng)會(huì)告訴系統(tǒng)“這里已經(jīng)有一個(gè)TortoiseSVN了”新安裝程序就會(huì)認(rèn)為環(huán)境沖突直接回滾。打個(gè)比方這就像你要往衣柜里掛一件新衣服但舊衣服的衣架還掛在那里占著位置你不把衣架拿掉就直接往上掛肯定會(huì)卡住。Windows Installer的事務(wù)機(jī)制又特別嚴(yán)格任何一步失敗都會(huì)把整個(gè)安裝回滾不會(huì)留一個(gè)半裝好的狀態(tài)給你。注意TortoiseSVN的安裝依賴MSIWindows Installer機(jī)制這種機(jī)制的特點(diǎn)是“全有或全無(wú)”。一旦中途出錯(cuò)之前復(fù)制進(jìn)去的文件、寫(xiě)入的注冊(cè)表都會(huì)被撤銷(xiāo)。所以“裝到一半失敗”其實(shí)是一個(gè)好消息說(shuō)明系統(tǒng)至少還處于干凈狀態(tài)真正麻煩的是“提示成功但實(shí)際沒(méi)裝上”。另外還有一個(gè)容易忽略的隱藏因素Windows的安裝數(shù)據(jù)庫(kù)注冊(cè)表中的Installer子鍵會(huì)記錄各個(gè)MSI包的安裝狀態(tài)。如果舊版本卸載不完全數(shù)據(jù)庫(kù)里會(huì)留有“這個(gè)產(chǎn)品存在”的條目。新安裝程序讀取到這個(gè)條目依然會(huì)覺(jué)得舊產(chǎn)品還在于是拒絕繼續(xù)。這也是為什么有些人明明把目錄都刪干凈了還是裝不上——問(wèn)題不在文件而在注冊(cè)表的安裝記錄里。2. 安裝前的環(huán)境確認(rèn)與清理方案2.1 自查系統(tǒng)里到底還有沒(méi)有殘留動(dòng)手清理前先花幾分鐘確認(rèn)一下系統(tǒng)里到底還留著多少舊版本痕跡。盲目上來(lái)就刪注冊(cè)表反而容易出問(wèn)題。我習(xí)慣按下面的順序排查打開(kāi)“控制面板” - “程序和功能”看看列表里還能不能看到TortoiseSVN。有的話先從這里卸載不要直接刪目錄。按下CtrlShiftEsc打開(kāi)任務(wù)管理器找到TSVNCache.exe、TortoiseSVN相關(guān)的進(jìn)程。有的話先結(jié)束進(jìn)程否則文件鎖定會(huì)導(dǎo)致清理失敗。在文件資源管理器地址欄輸入%AppData%\TortoiseSVN和%LocalAppData%\TortoiseSVN看有沒(méi)有遺留的配置目錄。檢查C:\Program Files\TortoiseSVN目錄是否還存在。注意64位系統(tǒng)還有C:\Program Files (x86)\TortoiseSVN這個(gè)可能。在命令行執(zhí)行reg query HKCU\Software\TortoiseSVN和reg query HKLM\SOFTWARE\TortoiseSVN看有沒(méi)有殘留的注冊(cè)表鍵。這一步的關(guān)鍵是區(qū)分“真正需要清理的殘留”和“系統(tǒng)正常的記錄”。如果你之前用的是正確卸載方式但注冊(cè)表里仍有一些關(guān)于組件路徑的記錄這也不一定就是問(wèn)題。只有當(dāng)安裝程序明確提示沖突時(shí)才需要?jiǎng)邮智謇怼?.2 徹底卸載舊版本的實(shí)操流程如果你發(fā)現(xiàn)的殘留來(lái)自一個(gè)“卸載不干凈”的舊版本可以參考下面的完整流程清理。這個(gè)流程我實(shí)際驗(yàn)證過(guò)多次基本能覆蓋大部分殘留場(chǎng)景。第一步先卸載。如果控制面板里還能看到TortoiseSVN選中它點(diǎn)卸載。如果看不到跳過(guò)這一步說(shuō)明卸載程序早就跑過(guò)了但沒(méi)清干凈。第二步清除殘留目錄。手動(dòng)刪除前面查到的TortoiseSVN安裝目錄、AppData下的配置目錄。刪除時(shí)如果提示文件被占用先回到任務(wù)管理器結(jié)束TSVNCache.exe和相關(guān)進(jìn)程再重新刪除。第三步清理注冊(cè)表。打開(kāi)注冊(cè)表編輯器定位到以下幾個(gè)常見(jiàn)位置HKEY_CURRENT_USER\Software\TortoiseSVNHKEY_LOCAL_MACHINE\SOFTWARE\TortoiseSVNHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\TortoiseSVN32位版本在64位系統(tǒng)中的記錄這三個(gè)鍵如果存在可以右鍵刪除。但對(duì)非菜鳥(niǎo)用戶我強(qiáng)烈建議刪除前先用導(dǎo)出功能備份。因?yàn)樽?cè)表是全局配置誤刪可能導(dǎo)致其他軟件異常。導(dǎo)出成一個(gè).reg文件萬(wàn)一刪錯(cuò)了還能恢復(fù)。第四步處理Windows Installer安裝記錄。這一步最容易被忽略也最關(guān)鍵。打開(kāi)注冊(cè)表編輯器定位到HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer這里記錄了系統(tǒng)里所有MSI產(chǎn)品的狀態(tài)。如果TortoiseSVN的卸載不完整這里會(huì)殘留對(duì)應(yīng)的條目。查找那些包含TortoiseSVN相關(guān)ProductCode的記錄刪除對(duì)應(yīng)的鍵。不過(guò)直接動(dòng)Installer鍵有風(fēng)險(xiǎn)我建議用命令行的msiexec命令來(lái)解決?？梢杂孟旅孢@個(gè)思路打開(kāi)命令提示符管理員執(zhí)行msiexec /x {ProductCode}把殘留的MSI產(chǎn)品正式卸載掉。ProductCode可以在Installer注冊(cè)表鍵下反查。如果嫌麻煩在2.3節(jié)我會(huì)給一個(gè)更省事的替代方案。2.3 注冊(cè)表與殘留文件的深度清理除了上面說(shuō)的幾處注冊(cè)表位置還有兩個(gè)位置是TortoiseSVN這種Shell集成工具特有的不清理干凈很容易復(fù)發(fā)。第一個(gè)是Shell擴(kuò)展的注冊(cè)位置HKEY_CLASSES_ROOT\CLSID下可能會(huì)有TortoiseSVN相關(guān)的GUID鍵這類(lèi)鍵通常以{XXXX-XXXX-XXXX}形式命名。如果殘留資源管理器仍然會(huì)去加載舊版本的DLL即使新版本裝好了也可能會(huì)被舊的擴(kuò)展干擾。搜索方法在注冊(cè)表編輯器里使用查找功能輸入“TortoiseSVN”把范圍設(shè)為“項(xiàng)”查出來(lái)的每一個(gè)鍵都要看內(nèi)容確認(rèn)是否確實(shí)和TortoiseSVN相關(guān)再?zèng)Q定刪不刪。第二個(gè)是Windows的PendingFileRenameOperations鍵。這個(gè)鍵位于HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager記錄的是系統(tǒng)重啟時(shí)要完成的重命名或刪除操作。如果之前卸載時(shí)標(biāo)記了一堆待刪除的TortoiseSVN文件系統(tǒng)卻一直沒(méi)重啟新安裝程序就會(huì)在這些文件還沒(méi)刪除完畢的情況下檢測(cè)到“舊文件仍在”導(dǎo)致安裝被中止。遇到這種情況最省事的辦法其實(shí)是重啟電腦。很多人卸載軟件后圖省事不重啟直接裝新版本結(jié)果就是碰到這類(lèi)被系統(tǒng)鎖定的文件。重啟之后PendingFileRenameOperations里的操作會(huì)被執(zhí)行文件清掉了安裝失敗的問(wèn)題往往就迎刃而解。提示如果你發(fā)現(xiàn)清理完這些位置后仍然無(wú)法安裝可以先下載微軟官方的程序安裝和卸載疑難解答工具用它掃描并清除可能損壞的MSI安裝記錄。這類(lèi)工具本質(zhì)上是把Installer注冊(cè)表里損壞的條目自動(dòng)修復(fù)比純手工翻注冊(cè)表要安全很多。3. 重新安裝的完整步驟與關(guān)鍵參數(shù)3.1 安裝前的準(zhǔn)備清理完舊版本殘留重啟電腦后下一步就是重新安裝了。這一步幾個(gè)細(xì)節(jié)做到位能少踩很多坑。第一安裝包要選對(duì)。TortoiseSVN的安裝包分為32位和64位兩種通常從官網(wǎng)或你所在團(tuán)隊(duì)內(nèi)部的軟件倉(cāng)庫(kù)下載。怎么選看你的操作系統(tǒng)版本。WinX打開(kāi)系統(tǒng)信息查看系統(tǒng)類(lèi)型。64位系統(tǒng)裝64位版本32位系統(tǒng)裝32位版本。注意在64位系統(tǒng)上裝32位版本的TortoiseSVN功能上也能用但圖標(biāo)覆蓋層和右鍵菜單的表現(xiàn)會(huì)受影響而且容易出現(xiàn)兼容性問(wèn)題不建議這么干。第二語(yǔ)言包要不要一起下。如果你需要使用中文界面TortoiseSVN默認(rèn)英文界面需要單獨(dú)下載對(duì)應(yīng)版本的語(yǔ)言包。注意語(yǔ)言包版本必須和主程序版本嚴(yán)格一致版本不匹配會(huì)導(dǎo)致語(yǔ)言切換失效。我個(gè)人的習(xí)慣是先用英文界面跑一遍確認(rèn)一切正常后再安裝語(yǔ)言包并切換成中文。這樣即使出問(wèn)題排查范圍也小一些。第三右鍵菜單的取舍。TortoiseSVN安裝過(guò)程中會(huì)讓你選擇功能組件默認(rèn)是全選。如果你只想用最基礎(chǔ)的提交、更新、檢出操作可以自定義去掉一些不常用的組件比如版本日志圖形分析、文件差異對(duì)比工具這些。但有一個(gè)組件我強(qiáng)烈建議保留就是“SVN command line tools”它會(huì)裝一個(gè)svn.exe到系統(tǒng)PATH里。有了它你就可以在終端里直接跑svn命令很多圖形界面里看不清楚的問(wèn)題用命令行一查就清楚了。3.2 安裝過(guò)程詳解安裝時(shí)右鍵點(diǎn)擊安裝包選擇“以管理員身份運(yùn)行”。這一步很重要因?yàn)門(mén)ortoiseSVN要寫(xiě)注冊(cè)表、注冊(cè)Shell擴(kuò)展普通權(quán)限可能寫(xiě)不進(jìn)去尤其是UAC開(kāi)啟的系統(tǒng)。安裝向?qū)У谝徊綍?huì)讓你選擇安裝路徑。默認(rèn)是C:\Program Files\TortoiseSVN通常保持默認(rèn)就可以。有特殊要求可以改到其他盤(pán)符但要注意路徑里不要出現(xiàn)中文和空格否則某些工具鏈解析路徑時(shí)可能出問(wèn)題。接著進(jìn)入組件選擇這一步我一般這樣做保留“Core”核心組件這個(gè)是必須的。勾選“SVN command line tools”方便命令行操作。語(yǔ)言包如果已經(jīng)下載在下一步指定語(yǔ)言包目錄或者裝完主程序后單獨(dú)運(yùn)行語(yǔ)言包安裝。差異查看工具和版本圖平時(shí)用得多的選上用得少可以去掉。然后一路Next等待進(jìn)度條走完。正常情況下整個(gè)安裝過(guò)程不超過(guò)兩分鐘?？吹健癐nstallation completed”界面說(shuō)明裝好了。這里補(bǔ)充一個(gè)原理層面的細(xì)節(jié)TortoiseSVN安裝過(guò)程中會(huì)執(zhí)行一次“資源管理器集成注冊(cè)”也就是把它的DLL注冊(cè)到Shell里、圖標(biāo)覆蓋層登記到Icon Overlay機(jī)制中。這一步完成時(shí)資源管理器需要刷新才能看到效果。所以安裝完成后如果右鍵菜單沒(méi)有立刻出現(xiàn)不要慌張先重開(kāi)一個(gè)資源管理器窗口或者用任務(wù)管理器重啟explorer.exe再來(lái)檢查。3.3 安裝后的驗(yàn)證與配置檢查裝完先別急著用花兩分鐘驗(yàn)證一下安裝是否完整。第一確認(rèn)版本。在任意文件夾里右鍵如果能看到TortoiseSVN的菜單項(xiàng)說(shuō)明Shell擴(kuò)展已經(jīng)生效。鼠標(biāo)懸停到菜單上通常還能看到版本號(hào)信息。第二命令行驗(yàn)證。打開(kāi)CMD或PowerShell輸入svn --version如果返回了svn版本的文本信息說(shuō)明命令行工具也裝好了。同時(shí)可以檢查一下版本號(hào)和你的TortoiseSVN主程序版本是否一致。不一致的話有可能是機(jī)器上還有另一個(gè)SVN工具干擾了PATH路徑。第三配置SVN基礎(chǔ)信息。打開(kāi)任意倉(cāng)庫(kù)的檢出目錄右鍵 - TortoiseSVN - Settings在彈出的設(shè)置界面里確認(rèn)用戶名、全局忽略列表、代理設(shè)置這些項(xiàng)是否正常。第一次使用還建議設(shè)置一下“自動(dòng)更新”默認(rèn)策略這個(gè)因團(tuán)隊(duì)約定而異沒(méi)有統(tǒng)一答案。注意TortoiseSVN的圖標(biāo)覆蓋層默認(rèn)只對(duì)“受版本控制的目錄”生效。也就是說(shuō)你隨便開(kāi)一個(gè)普通文件夾看不到小綠勾是正常的別誤以為是圖標(biāo)功能壞了。只有當(dāng)你檢出或者加入到工作副本后文件狀態(tài)圖標(biāo)才會(huì)出現(xiàn)。4. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄4.1 安裝被Windows Installer阻止的排查思路這個(gè)問(wèn)題幾乎每個(gè)遇到“無(wú)法安裝”的人都會(huì)碰上。具體表現(xiàn)是雙擊安裝包彈出一個(gè)提示大意是“另一個(gè)安裝正在進(jìn)行”或“請(qǐng)等待當(dāng)前安裝完成”。出現(xiàn)這種提示并不一定是你真的在同時(shí)運(yùn)行兩個(gè)安裝程序。更常見(jiàn)的原因是Windows Installer服務(wù)的狀態(tài)被上一次異常卸載卡住了。排查步驟按WinR輸入services.msc回車(chē)找到Windows Installer服務(wù)看狀態(tài)是不是“已停止”。正常情況下它是手動(dòng)啟動(dòng)的沒(méi)有安裝任務(wù)時(shí)會(huì)停止這是正常的。如果有安裝任務(wù)執(zhí)行過(guò)卻未釋放可以在服務(wù)里右鍵重啟這個(gè)服務(wù)前提是用管理員權(quán)限。再用任務(wù)管理器看看有沒(méi)有msiexec.exe進(jìn)程殘留有的話結(jié)束掉。另一個(gè)隱蔽的來(lái)源是注冊(cè)表里的“運(yùn)行中安裝”記錄。位置在HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\InProgress如果這里存在非空的鍵值Windows Installer會(huì)認(rèn)為有安裝正在進(jìn)行中。我遇到過(guò)幾次這樣的情況重啟也沒(méi)用最后清理了這個(gè)鍵之后的安裝才恢復(fù)。4.2 安裝成功后右鍵菜單沒(méi)有TortoiseSVN好不容易裝上了右鍵卻沒(méi)有TortoiseSVN入口這種情況也常見(jiàn)。原因通常不是安裝失敗而是Shell擴(kuò)展沒(méi)有被正確加載。排查順序先修復(fù)文件資源管理器。右鍵任務(wù)欄空白處打開(kāi)任務(wù)管理器找到“Windows資源管理器”右鍵重啟。這一步能解決大部分菜單不刷新問(wèn)題。如果重啟資源管理器沒(méi)用檢查系統(tǒng)里是否有其他安全軟件禁用了Shell擴(kuò)展。某些安全軟件會(huì)默認(rèn)攔截新的Shell擴(kuò)展加載。檢查T(mén)ortoiseSVN的設(shè)置界面確認(rèn)圖標(biāo)覆蓋層沒(méi)有被切換成禁用狀態(tài)。有一個(gè)我親身踩過(guò)的坑某開(kāi)發(fā)者裝了一個(gè)系統(tǒng)優(yōu)化工具它把資源管理器右鍵菜單里的非系統(tǒng)擴(kuò)展默認(rèn)關(guān)閉了導(dǎo)致TortoiseSVN裝完菜單不顯示。后來(lái)在優(yōu)化工具的白名單里加回TortoiseSVN重啟資源管理器才恢復(fù)。如果你也裝了這類(lèi)工具優(yōu)先檢查它的右鍵菜單管理功能。4.3 覆蓋安裝與升級(jí)時(shí)特別容易踩的坑如果你不是全新安裝而是從舊版本覆蓋升級(jí)這里有幾個(gè)額外的注意事項(xiàng)。第一個(gè)坑版本跨度太大。TortoiseSVN的版本更新會(huì)帶來(lái)工作副本格式的變化?？绱蟀姹旧?jí)時(shí)舊工作副本可能會(huì)提示“工作副本已鎖定”或格式不兼容。遇到這種情況不要急著重裝先備份工作副本關(guān)鍵是的.svn目錄再在TortoiseSVN設(shè)置里執(zhí)行“清理”或升級(jí)工作副本。第二個(gè)坑多版本殘留的DLL沖突。有時(shí)候舊版本殘留的某些DLL還在系統(tǒng)目錄里新版本用的則是同文件名但內(nèi)容不同的文件。系統(tǒng)加載Shell擴(kuò)展時(shí)可能把兩者混著用導(dǎo)致資源管理器崩潰或圖標(biāo)錯(cuò)亂。解決辦法是卸載后搜索并刪除舊DLL或者在安全模式下安裝。第三個(gè)坑安裝包的語(yǔ)言版本不一致。下載主程序時(shí)是中文版安裝包卻配了一個(gè)英文版語(yǔ)言包或者反過(guò)來(lái)。這種不一致在少數(shù)情況下會(huì)導(dǎo)致安裝中語(yǔ)言切換失敗甚至安裝中斷。統(tǒng)一版本來(lái)源安裝前確認(rèn)主程序和語(yǔ)言包版本號(hào)完全一致能避免這個(gè)問(wèn)題。4.4 常見(jiàn)問(wèn)題速查表把前面提到的典型問(wèn)題和對(duì)應(yīng)處理方式整理成一張表方便對(duì)照排查問(wèn)題特征根本原因快速解決辦法安裝向?qū)е型净貪L殘留的Shell擴(kuò)展或注冊(cè)表項(xiàng)沖突清理注冊(cè)表后重啟再安裝提示“另一個(gè)安裝正在進(jìn)行”Windows Installer狀態(tài)被卡住重啟安裝服務(wù)清理InProgress鍵右鍵菜單無(wú)TortoiseSVNShell擴(kuò)展未加載或被安全軟件禁用重啟資源管理器檢查安全軟件白名單安裝提示成功但版本信息調(diào)不出組件缺失或PATH環(huán)境異常重新運(yùn)行安裝包勾選全部組件修復(fù)圖標(biāo)覆蓋層不顯示非工作副本目錄或覆蓋層設(shè)置被關(guān)閉確認(rèn)目錄已是工作副本檢查設(shè)置安裝語(yǔ)言包后界面仍是英文版本號(hào)不匹配或沒(méi)重啟換成一致的版本號(hào)重啟資源管理器結(jié)尾踩過(guò)幾次坑之后我現(xiàn)在安裝TortoiseSVN這類(lèi)和系統(tǒng)外殼深度集成的工具流程已經(jīng)固定成一套先備份舊配置再用清理工具把卸載殘留清除干凈重啟然后才進(jìn)行安裝?？粗闊┑@些步驟省掉哪一環(huán)都可能讓你在“無(wú)法安裝”的怪圈里多折騰幾個(gè)小時(shí)。最后再分享一個(gè)小技巧無(wú)論什么時(shí)候重裝TortoiseSVN先把用戶目錄里的配置文件夾備份一份。這個(gè)目錄里存著你所有的服務(wù)器地址、賬號(hào)密碼緩存、比對(duì)工具的偏好設(shè)置。備份它重裝后恢復(fù)幾分鐘就能回到原來(lái)的使用習(xí)慣。別等裝完發(fā)現(xiàn)配置全丟了才來(lái)后悔。