TortoiseSVN 1.14.5 中文包安装后语言不生效？

Question

TortoiseSVN 1.14.5 安装中文语言包后界面仍显示英文，常见原因是语言包未正确安装或系统未识别。即使安装了中文包，若先安装主程序再安装语言包，可能因组件注册不完整导致语言切换失败。此外，部分用户未在设置中手动将语言选项更改为“中文（简体）”，或安装了与主程序版本不匹配的中文包，也会造成不生效。建议重新安装时选择中文语言包并确保版本一致，安装完成后重启系统并在TortoiseSVN设置中确认语言选项已切换。

Answer 1

1. 问题现象与初步排查

在安装 TortoiseSVN 1.14.5 后，即使已安装中文语言包，用户界面仍显示为英文。这一现象在多个开发团队中均有反馈，尤其是在未遵循标准安装流程的环境中更为常见。初步排查应从以下几个方面入手：

• 确认是否已正确下载并运行了适用于 TortoiseSVN 1.14.5 的官方中文语言包（Chinese (Simplified) Language Pack）。
• 检查语言包与主程序版本是否完全一致，例如：1.14.5.29874。
• 查看安装过程中是否出现错误提示或中断。
• 确认操作系统区域设置是否支持中文（如 Windows 区域设置为“中国”）。

2. 深层原因分析

从系统集成和组件注册机制角度分析，TortoiseSVN 使用 Windows Shell 扩展技术实现右键菜单和资源管理器集成。若主程序先于语言包安装，部分 DLL 组件可能未正确注册多语言资源路径，导致语言切换失败。

原因分类	具体描述	影响层级
安装顺序不当	先装主程序后装语言包，注册表项缺失	高
版本不匹配	语言包版本与主程序不符	高
设置未更改	未在 Settings → Language 中选择中文	中
权限不足	安装时未以管理员身份运行	中
缓存残留	旧版注册表或文件未清理	中

3. 解决方案实施路径

1. 卸载现有 TortoiseSVN 及其语言包（控制面板 → 程序和功能）。
2. 清理注册表残留项（建议使用 CCleaner 或手动删除 HKEY_LOCAL_MACHINE\SOFTWARE\TortoiseSVN）。
3. 重新启动系统以释放文件句柄。
4. 以管理员身份运行 TortoiseSVN 1.14.5 安装包，在安装向导中主动选择“Chinese (Simplified)”作为默认语言。
5. 完成安装后重启资源管理器（可通过任务管理器重启 explorer.exe）。
6. 进入 TortoiseSVN 设置界面（右键任意文件夹 → TortoiseSVN → Settings），导航至 General → Language，确认当前语言为“中文(简体)”。
7. 若仍未生效，可手动指定语言文件路径：C:\Program Files\TortoiseSVN\Languages\zh_CN.dll。
8. 验证系统环境变量是否包含正确的区域配置（如 LANG=zh_CN.UTF-8 或 Windows 国家/地区设置为中国）。
9. 测试右键菜单、提交对话框、日志查看器等关键界面是否已汉化。
10. 记录操作日志，便于后续审计与团队知识沉淀。

4. 自动化诊断脚本示例

以下 PowerShell 脚本可用于检测语言包状态：

# Check if Chinese language file exists
$languagePath = "C:\Program Files\TortoiseSVN\Languages\zh_CN.dll"
if (Test-Path $languagePath) {
    Write-Host "中文语言包存在" -ForegroundColor Green
} else {
    Write-Host "未找到中文语言包，请重新安装" -ForegroundColor Red
}

# Get current installed version
$regKey = "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*"
$tsvn = Get-ItemProperty $regKey | Where-Object { $_.DisplayName -like "*TortoiseSVN*" }
Write-Host "当前版本: $($tsvn.DisplayVersion)"

5. 架构级规避策略（Mermaid 流程图）

graph TD A[开始] --> B{是否首次安装?} B -- 是 --> C[同时勾选中文语言包] B -- 否 --> D[彻底卸载原有版本] D --> E[清理注册表与缓存] E --> F[重新安装并选择中文] C --> G[重启系统] F --> G G --> H[进入Settings→Language确认] H --> I{是否显示中文?} I -- 是 --> J[完成] I -- 否 --> K[检查DLL加载路径] K --> L[手动复制zh_CN.dll并注册] L --> H