简介围绕 Android 项目与框架中字符串资源分散、难以快速筛选和统一翻译的问题这份 MediaTek 字符串翻译工具STT面向应用开发者和本地化工程师用于简化多语言本地化流程便于在项目内集中处理字符串资源。压缩包共 11 个文件约 11.41MB以可执行 jar 与依赖 jar 为主体辅以 sh、bat 启动脚本和一份 PDF 用户手册覆盖工具运行、命令行调用与操作说明等用途。已有 230 人学习说明其在 MTK 平台本地化场景中具有一定参考价值。读者可借助工具完成字符串提取、筛选与翻译流程结合手册快速理解参数与批量处理方式减少手工整理资源文件的时间依赖库与脚本一并提供也便于在本地环境直接搭建运行适合需要处理 Android 多语言资源的初中级开发者与本地化人员参考。1. 开装前的环境盘点TranslationTools v3.1511.01 为什么双击就能运行上周帮一个做资料整理的 A 同学收拾机器他把 TranslationTools 装了三次每次双击都弹一句「计算机中丢失 MSVCP140.dll」。不是包坏了是他把这款翻译辅助工具当成纯绿色软件——从下载目录直接双击 exe路径里还带一层中文文件夹名。TranslationTools_exe_v3.1511.01 这个包确实是解压即用的形态但它对系统运行库、目录写权限、取词钩子的权限级别一样都不含糊。装对了它是看外文文档时最省事的那层辅助装错了划词不弹窗、热键被输入法抢走、界面全是方块字能把人折磨到怀疑包有问题。下面按我自己装机的顺序走解压、补运行库、配引擎和热键、排错最后落到怎么验证它真的跑通了。2. 解压与目录规划exe 放哪个盘、路径里为什么不能有中文和空格2.1 先算哈希再解压别在 zip 里直接双击很多人拿到压缩包的第一反应是双击进去找到 TranslationTools.exe 双击运行。Windows 资源管理器在这种情况下会把文件解到%Temp%下的一个随机目录程序启动时读配置、写日志、加载词典全在那个临时目录里完成。等到你重启机器临时目录被清理第二天打开发现热键没了、词典空了还以为程序有毛病。这类「配置丢一半」的坑八成就是这种双击造成的。我一般的做法是先把包落到一个固定位置算一遍哈希留档再用命令行解压到目标目录# 1) 记录压缩包哈希以后换机器或重下时能对一下是不是同一个包 Get-FileHash -Path D:\Downloads\TranslationTools_exe_v3.1511.01.zip -Algorithm SHA256 | Format-List Algorithm, Hash, Path # 2) 解压到指定目录而不是双击进 zip 里直接运行 # -Force 表示目标目录已存在时覆盖同名文件 Expand-Archive -Path D:\Downloads\TranslationTools_exe_v3.1511.01.zip -DestinationPath D:\Tools\TranslationTools\v3.1511.01 -ForceGet-FileHash的-Algorithm SHA256是默认值写全是为了让输出可读把 Hash 那一行抄进你的装机记录里将来程序行为诡异时能先排除「包被换过」。Expand-Archive的-Force只覆盖文件不会删掉目录里多出来的旧文件所以升级版本时别图省事往同一个目录覆盖宁可新开一个v3.1511.01这样的版本号目录再改配置指过去。如果包内层级很深或者文件名带非 ASCII 字符Expand-Archive偶尔会解出乱码名这种情况换成 7-Zip 的命令行7z x更稳妥解压后再核对一遍目录里的文件数是否和压缩包内一致。2.2 安装路径的三条硬规矩路径这件事属于典型的玄学——同一个包放D:\Tools\TranslationTools能跑放C:\Users\某某\桌面\新建文件夹\就各种取词失败。三条规矩我一直在守第一路径里不要有中文。取词模块在注入目标进程时要做路径转换中间某一层用了系统默认代码页处理中文路径就可能变问号表现是程序能启动但词典加载为 0 条。第二路径里不要有空格尤其别放Program Files。第三不要放桌面和下载目录这两个目录经常被同步工具或清理脚本扫到。放在C:\Program Files下的另一个麻烦是 UAC 虚拟化程序往自己目录写配置时被系统重定向到%LOCALAPPDATA%\VirtualStore你在安装目录里看到的配置文件永远是最初那份改了不生效。# 给当前用户对程序目录的完全控制权避免写配置时被重定向 # (OI) (CI) 表示继承到子目录和文件F 表示完全控制 icacls D:\Tools\TranslationTools\v3.1511.01 /grant $env:USERNAME:(OI)(CI)F /T/T是递归应用到已有子项。执行完输出里应该能看到「已成功处理」的文件条目。这一步不是必须的但在 D 盘用普通用户目录时能省掉后面「配置保存失败」的一整轮排查。解压完成后目录里大致是这么几类东西动手之前先分清哪些能改哪些不能碰目录/文件作用能不能动TranslationTools.exe主程序入口不能改名、不能挪走config.ini 或 settings.ini用户配置热键和路径都在这可改改前复制一份备份dict\本地词典根目录一层子目录一个词典可增删cache\索引和取词缓存可清空清完首次启动会重建logs\运行日志排错第一现场可清空同级 *.dll依赖库不能单独替换2.3 解除文件锁定顺手给杀软加个白名单从网络下载的 zip 带 Zone.Identifier 标记解压后每个文件都继承这个标记。普通程序问题不大但 TranslationTools 这类要做全局热键和屏幕取词的辅助工具启动时会被 SmartScreen 或杀软额外关照一轮表现是双击之后任务管理器闪一下就没了日志里一条记录都没有——这就是典型的黑匣子现场。# 递归清掉「来自网络」的标记避免被 SmartScreen 拦在启动前 Get-ChildItem D:\Tools\TranslationTools\v3.1511.01 -Recurse -File | Unblock-FileUnblock-File做的事就是删掉备用数据流里的那个标记不修改文件内容。第二条要做的是把整个程序目录加进杀软的排除列表——注意是排除目录不是排除单个 exe因为它还会加载dict\下的词典文件、cache\下的索引文件。有些杀软对「读取其他窗口文本」这类行为敏感加白之后仍然被拦那就先把实时防护临时关掉做一次启动测试确认是误报再把目录加白别一直关着防护用。3. 运行库补齐.NET Framework 4.8 与 VC 2015-2022 的版本取舍3.1 先查系统已装的 .NET Framework别重复装TranslationTools v3.1511.01 这类桌面工具界面层基本都压在 .NET Framework 4.x 上。Win10 1809 之后系统自带 4.7.2 以上Win11 自带 4.8 或 4.8.1所以很多人根本不用装。但如果你是从更老的镜像装起来的机器或者是精简版系统缺 4.8 就会在启动瞬间报「需要 .NET Framework 4.8」。先查再装一条命令就够# 读注册表里的 Release 值比看控制面板准 $key HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full Get-ItemProperty -Path $key | Select-Object Version, Release拿到的Release数字对照一下528040 及以上是 4.8528372 是 Win10 2004 之后的 4.8 修订版533320 是 4.8.1。只要大于等于 528040这一步直接跳过如果连v4\Full这个键都不存在说明系统只有 4.0 甚至 3.5那就老老实实装 4.8 的离线安装包装完必须重启不重启的话程序仍然会读到旧的运行库缓存。需要提醒的是 .NET Framework 4.x 是就地升级装了 4.8 之后回不到 4.7某些老内部系统依赖旧版本行为时会出问题。如果是共用机器装之前先问一句有没有别的老程序在跑。3.2 VC 运行库x86 和 x64 都得装开头那个MSVCP140.dll缺失就是 VC 2015-2022 运行库没装。这里有个很容易漏的点64 位系统上 x86 和 x64 两个版本都要装。原因是取词模块为了能挂到 32 位目标程序上本身通常是 32 位进程缺 x86 运行库时表现是主界面正常一划词就静默退出。# 两个架构都要装顺序无所谓装完重启 winget install --id Microsoft.VCRedist.2015.x64 -e --accept-source-agreements winget install --id Microsoft.VCRedist.2015.x86 -e --accept-source-agreements-e是精确匹配包 ID避免 winget 模糊匹配到别的 VC 版本--accept-source-agreements只是省掉一次交互确认。没有 winget 的机器去下载中心拿vc_redist.x64.exe和vc_redist.x86.exe两个离线包双击装完同样要重启。判断是不是真的缺运行库别靠猜。拿 Dependency Walker 或者dumpbin /dependents看一眼主程序依赖如果列出来的VCRUNTIME140.dll、MSVCP140.dll、VCRUNTIME140_1.dll在C:\Windows\System32里找不到那基本可以确诊。VCRUNTIME140_1.dll只有 2019 之后的运行库才有装了 2015 版的旧包仍然会报它缺失所以务必用 2015-2022 的合并包。3.3 依赖装完的重启顺序运行库装完不要直接开程序。正确的顺序是先重启系统重启后确认C:\Windows\System32\vcruntime140.dll和msvcp140.dll存在再启动 TranslationTools。如果不想重启整台机器至少重启一次资源管理器让新的 DLL 搜索路径生效但 .NET Framework 的更新绕不过系统重启这条没有后悔药。另外装完依赖之后第一次启动建议用普通权限别一上来就右键「以管理员身份运行」。取词类工具有一个特性它只能取到权限级别不高于自己的程序的文本。你以管理员身份启动它普通程序里的文字照样取不到反过来普通权限启动任务管理器这类管理员程序取不到。所以先用普通权限跑一遍把常用场景覆盖到遇到特定程序取不到再单独用管理员启动。4. 首次启动与参数配置词典路径、热键、取词方式的四组设置4.1 第一次启动要做的事首次启动会生成配置文件和词典索引这个过程别打断。窗口出来后先不要急着划词按顺序做三件事确认界面语言是不是中文有些包默认英文、确认「本地词典」列表里至少有一条、确认日志目录下生成了当天的日志文件。这三件事对应三个子系统任意一个没起来后面的取词一定不顺。配置文件的格式各版本略有差异v3.1511.01 这类版本一般是 ini 形态初次启动自动生成在程序目录下。如果你拿到的是自带配置的包先备份再改; TranslationTools v3.1511.01 用户配置 ; 保存时用 ANSI 或 UTF-8 无 BOM别存成 UTF-16否则程序读到的第一个字符是 BOM整段解析失败 [General] ; 工作目录装完不要随便挪挪了必须同步改这里否则词典和缓存全找不到 WorkDirD:\Tools\TranslationTools\v3.1511.01 ; 日志级别0 关闭 1 只记错误 2 常规 3 调试排查取词问题临时开到 3查完调回 2 LogLevel2 [Dictionary] ; 本地词典根目录下面一层子目录就是一个词典 DictPathD:\Tools\TranslationTools\v3.1511.01\dict ; 加载顺序靠前的优先命中术语表放最后但优先级最高具体看程序里的设置 LoadOrderbasic,en2zh,tech [Hotkey] ; 划词/取词翻译热键避开 CtrlAlt字母输入法和显卡驱动抢得厉害 TranslateAltShiftT ; 截屏取词热键做图片文档时用 CaptureAltShiftSWorkDir是整份配置里最关键的一项写相对路径在某些版本上会被解析成当前工作目录从快捷方式启动和从命令行启动结果不一样所以一律写绝对路径。LogLevel平时保持 2出问题临时改 3改完必须重启程序才生效日志文件在logs\下按日期分文件。4.2 词典与离线包的导入顺序词典导入是有顺序的顺序错了表现是「明明装了专业词库翻译结果还是通用词」。我一般按这个层次来先让程序自带的 basic 词典就位再导入通用英汉/汉英词典最后导专业词库和自定义术语表。术语表放最后因为它的作用是把特定译法强制覆盖掉比如某个产品名固定译成某个词这类条目必须优先级最高。导入完要重建一次索引程序里一般有「重建索引」按钮没有的话就手动清cache\目录再启动。索引文件是二进制跨版本不兼容所以升级版本时cache\一定要清留着旧索引会出现「词典列表显示 5 个实际只加载 2 个」这种诡异现象。术语表文件建议用 UTF-8 无 BOM 保存用 Excel 导出 CSV 时选 UTF-8别用默认的 GBK否则生僻字会变成问号。4.3 热键与取词方式的取舍热键冲突是安装后最常见的「装了但用不了」。CtrlAlt字母这一类组合被输入法切换、显卡录屏、截图工具占用的概率极高注册失败时程序通常不报错只是按下去没反应。选热键的原则是用AltShift字母或者三键组合避开CtrlShift、CtrlAlt、Win开头的段位。改完热键先在一个记事本窗口里试能弹出来再去浏览器里试浏览器有自己的快捷键拦截。取词方式一般有三种鼠标划词、热键取当前光标处文本、截屏 OCR。划词最省事但对目标程序有要求UWP 应用、部分 Electron 应用和游戏窗口取不到热键取词兼容性好一些截屏 OCR 完全不依赖目标程序代价是慢一点。我的习惯是划词作主力、截屏作兜底两个热键分开设置别共用一个组合。4.4 显示效果的两项调整界面出现方块字通常是系统「非 Unicode 程序的语言」和程序编码不匹配造成的把系统区域设置改成中文简体并重启能解决大部分。另一种情况是个别生僻字显示成方框那是字体缺字换一套覆盖范围大的字体即可。翻译结果里的乱码则完全是另一回事那是词典文件本身的编码问题跟系统设置无关用文本编辑器打开词典源文件看一眼前几个字节就能判断是 UTF-8 还是 GBK 一看便知。5. 避坑与排查装完打不开、取词不弹窗的五条血泪记录5.1 启动阶段的两条现象一双击 exe鼠标转一圈什么都没发生任务管理器里进程闪一下就消失。原因三种可能缺 VC 运行库、路径含中文或空格、被杀软静默隔离。日志一条都没有的时候优先怀疑运行库和杀软因为程序还没走到写日志那一步就挂了。解决按 3.2 的命令补齐 x86 和 x64 两个运行库把程序挪到D:\Tools\TranslationTools\v3.1511.01这种纯英文无空格路径到杀软的隔离区看有没有记录有就恢复并加目录白名单。三条都做完还不行用cd进程序目录从命令行启动一次# 从命令行启动能把加载失败的错误直接打到控制台 Set-Location D:\Tools\TranslationTools\v3.1511.01 .\TranslationTools.exe控制台里如果出现「无法加载文件或程序集」字样就是依赖缺失比看日志快得多。现象二弹窗提示「应用程序的并行配置不正确」。原因系统里存在多个版本的 VC 运行库SxS 清单对不上常见于装过一堆老软件的机器。解决先在「应用和功能」里把 2015、2017、2019、2022 各版本运行库全部卸掉只保留 2015-2022 的合并包重装后重启。这个操作会影响到其他依赖 VC 的程序卸载前记一下清单出问题好回滚。5.2 取词与显示的三条现象三主界面正常鼠标划词不弹窗热键按下去也没反应。原因权限级别不一致或者热键注册失败。取词工具只能读权限不高于自己的进程在管理员程序窗口里划词取不到属于正常现象热键则常被输入法抢先注册。解决换到记事本、浏览器这类普通程序里再试把LogLevel调到 3 重启日志里会明确写出热键注册成功还是失败失败的换一组AltShift字母组合再试。如果是特定程序取不到先用截屏 OCR 顶一阵别在一个取词方式上死磕。现象四翻译结果出来一堆问号或者繁体乱码。原因词典文件的编码和程序读取时用的编码不一致。压缩包在不同系统之间转存过或者中途用文本编辑器改过术语表都会破坏原有编码。解决用文本编辑器打开对应的词典或术语表文件另存为 UTF-8 无 BOM清空cache\后重启程序重建索引。术语表从 Excel 导出的导出时明确选 UTF-8别用默认编码。现象五装好能用重启机器后热键全部失效、词典列表变空。原因十有八九是当初在 zip 里双击运行的配置写进了临时目录重启后被清理。另一个可能是程序目录被清理脚本扫过。解决把程序重新解压到固定目录确认config.ini就在 exe 同级生成把目录从任何自动清理的白名单里排除。改完跑一次第 6 章的检查表确认配置写的是绝对路径。6. 装完怎么验证跑通三组自检用例和一张交付前的检查表装完不验证等于没装。我交付一台机器之前固定跑三组用例覆盖三个不同的子系统本地词典检索、划词取词、截屏取词。第一组打开程序在搜索框里输入一个常见英文单词查词能返回释义说明词典索引正常。第二组打开一个记事本敲一段英文选中后按划词热键能弹出翻译窗口说明全局钩子注册成功。第三组打开一张带英文的图片按截屏取词热键框选能识别出文字说明 OCR 模块和字体环境都没问题。三组全过基本可以判定这套环境跑通了。再补两条命令级的检查比肉眼可靠# 1) 进程是不是从正确路径启动的排除临时目录里那份 Get-Process TranslationTools -ErrorAction SilentlyContinue | Select-Object Id, Path # 2) 最近日志里有没有 ERROR 或异常堆栈 Get-Content D:\Tools\TranslationTools\v3.1511.01\logs\app.log -Tail 80 | Select-String -Pattern ERROR|Exception|失败第一条命令如果输出的 Path 是%Temp%下的路径说明你还在用错误的方式启动回去看第 2 章。第二条命令输出为空是最理想的状态有内容就先看时间戳只关注本次启动之后的记录历史日志里的旧报错不用管。交付前的检查表我一般就照这张走检查项期望结果不通过先看哪exe 启动路径固定在版本号目录下第 2 章解压方式依赖运行库无缺失 DLL 提示第 3 章 VC/.NET配置文件生成在 exe 同级路径为绝对路径第 6 章进程路径词典加载数与dict\子目录数一致第 4 章索引重建划词热键记事本里可弹出第 5 章热键冲突截屏取词图片文字可识别第 4 章取词方式日志级别已从 3 调回 24.1 配置项最后提醒一句验证阶段把LogLevel临时开到 3 排查完记得改回 2。开着调试日志跑一天日志文件能涨到几百兆磁盘吃紧的机器上又是另一轮排查。从那以后我每装一台机器都是先按这张表走一遍再交出去省下来的时间远比填表多。希望帮到你。本文还有配套的精品资源点击获取
简介围绕 Android 项目与框架中字符串资源分散、难以快速筛选和统一翻译的问题这份 MediaTek 字符串翻译工具STT面向应用开发者和本地化工程师用于简化多语言本地化流程便于在项目内集中处理字符串资源。压缩包共 11 个文件约 11.41MB以可执行 jar 与依赖 jar 为主体辅以 sh、bat 启动脚本和一份 PDF 用户手册覆盖工具运行、命令行调用与操作说明等用途。已有 230 人学习说明其在 MTK 平台本地化场景中具有一定参考价值。读者可借助工具完成字符串提取、筛选与翻译流程结合手册快速理解参数与批量处理方式减少手工整理资源文件的时间依赖库与脚本一并提供也便于在本地环境直接搭建运行适合需要处理 Android 多语言资源的初中级开发者与本地化人员参考。1. 开装前的环境盘点TranslationTools v3.1511.01 为什么双击就能运行上周帮一个做资料整理的 A 同学收拾机器他把 TranslationTools 装了三次每次双击都弹一句「计算机中丢失 MSVCP140.dll」。不是包坏了是他把这款翻译辅助工具当成纯绿色软件——从下载目录直接双击 exe路径里还带一层中文文件夹名。TranslationTools_exe_v3.1511.01 这个包确实是解压即用的形态但它对系统运行库、目录写权限、取词钩子的权限级别一样都不含糊。装对了它是看外文文档时最省事的那层辅助装错了划词不弹窗、热键被输入法抢走、界面全是方块字能把人折磨到怀疑包有问题。下面按我自己装机的顺序走解压、补运行库、配引擎和热键、排错最后落到怎么验证它真的跑通了。2. 解压与目录规划exe 放哪个盘、路径里为什么不能有中文和空格2.1 先算哈希再解压别在 zip 里直接双击很多人拿到压缩包的第一反应是双击进去找到 TranslationTools.exe 双击运行。Windows 资源管理器在这种情况下会把文件解到%Temp%下的一个随机目录程序启动时读配置、写日志、加载词典全在那个临时目录里完成。等到你重启机器临时目录被清理第二天打开发现热键没了、词典空了还以为程序有毛病。这类「配置丢一半」的坑八成就是这种双击造成的。我一般的做法是先把包落到一个固定位置算一遍哈希留档再用命令行解压到目标目录# 1) 记录压缩包哈希以后换机器或重下时能对一下是不是同一个包 Get-FileHash -Path D:\Downloads\TranslationTools_exe_v3.1511.01.zip -Algorithm SHA256 | Format-List Algorithm, Hash, Path # 2) 解压到指定目录而不是双击进 zip 里直接运行 # -Force 表示目标目录已存在时覆盖同名文件 Expand-Archive -Path D:\Downloads\TranslationTools_exe_v3.1511.01.zip -DestinationPath D:\Tools\TranslationTools\v3.1511.01 -ForceGet-FileHash的-Algorithm SHA256是默认值写全是为了让输出可读把 Hash 那一行抄进你的装机记录里将来程序行为诡异时能先排除「包被换过」。Expand-Archive的-Force只覆盖文件不会删掉目录里多出来的旧文件所以升级版本时别图省事往同一个目录覆盖宁可新开一个v3.1511.01这样的版本号目录再改配置指过去。如果包内层级很深或者文件名带非 ASCII 字符Expand-Archive偶尔会解出乱码名这种情况换成 7-Zip 的命令行7z x更稳妥解压后再核对一遍目录里的文件数是否和压缩包内一致。2.2 安装路径的三条硬规矩路径这件事属于典型的玄学——同一个包放D:\Tools\TranslationTools能跑放C:\Users\某某\桌面\新建文件夹\就各种取词失败。三条规矩我一直在守第一路径里不要有中文。取词模块在注入目标进程时要做路径转换中间某一层用了系统默认代码页处理中文路径就可能变问号表现是程序能启动但词典加载为 0 条。第二路径里不要有空格尤其别放Program Files。第三不要放桌面和下载目录这两个目录经常被同步工具或清理脚本扫到。放在C:\Program Files下的另一个麻烦是 UAC 虚拟化程序往自己目录写配置时被系统重定向到%LOCALAPPDATA%\VirtualStore你在安装目录里看到的配置文件永远是最初那份改了不生效。# 给当前用户对程序目录的完全控制权避免写配置时被重定向 # (OI) (CI) 表示继承到子目录和文件F 表示完全控制 icacls D:\Tools\TranslationTools\v3.1511.01 /grant $env:USERNAME:(OI)(CI)F /T/T是递归应用到已有子项。执行完输出里应该能看到「已成功处理」的文件条目。这一步不是必须的但在 D 盘用普通用户目录时能省掉后面「配置保存失败」的一整轮排查。解压完成后目录里大致是这么几类东西动手之前先分清哪些能改哪些不能碰目录/文件作用能不能动TranslationTools.exe主程序入口不能改名、不能挪走config.ini 或 settings.ini用户配置热键和路径都在这可改改前复制一份备份dict\本地词典根目录一层子目录一个词典可增删cache\索引和取词缓存可清空清完首次启动会重建logs\运行日志排错第一现场可清空同级 *.dll依赖库不能单独替换2.3 解除文件锁定顺手给杀软加个白名单从网络下载的 zip 带 Zone.Identifier 标记解压后每个文件都继承这个标记。普通程序问题不大但 TranslationTools 这类要做全局热键和屏幕取词的辅助工具启动时会被 SmartScreen 或杀软额外关照一轮表现是双击之后任务管理器闪一下就没了日志里一条记录都没有——这就是典型的黑匣子现场。# 递归清掉「来自网络」的标记避免被 SmartScreen 拦在启动前 Get-ChildItem D:\Tools\TranslationTools\v3.1511.01 -Recurse -File | Unblock-FileUnblock-File做的事就是删掉备用数据流里的那个标记不修改文件内容。第二条要做的是把整个程序目录加进杀软的排除列表——注意是排除目录不是排除单个 exe因为它还会加载dict\下的词典文件、cache\下的索引文件。有些杀软对「读取其他窗口文本」这类行为敏感加白之后仍然被拦那就先把实时防护临时关掉做一次启动测试确认是误报再把目录加白别一直关着防护用。3. 运行库补齐.NET Framework 4.8 与 VC 2015-2022 的版本取舍3.1 先查系统已装的 .NET Framework别重复装TranslationTools v3.1511.01 这类桌面工具界面层基本都压在 .NET Framework 4.x 上。Win10 1809 之后系统自带 4.7.2 以上Win11 自带 4.8 或 4.8.1所以很多人根本不用装。但如果你是从更老的镜像装起来的机器或者是精简版系统缺 4.8 就会在启动瞬间报「需要 .NET Framework 4.8」。先查再装一条命令就够# 读注册表里的 Release 值比看控制面板准 $key HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full Get-ItemProperty -Path $key | Select-Object Version, Release拿到的Release数字对照一下528040 及以上是 4.8528372 是 Win10 2004 之后的 4.8 修订版533320 是 4.8.1。只要大于等于 528040这一步直接跳过如果连v4\Full这个键都不存在说明系统只有 4.0 甚至 3.5那就老老实实装 4.8 的离线安装包装完必须重启不重启的话程序仍然会读到旧的运行库缓存。需要提醒的是 .NET Framework 4.x 是就地升级装了 4.8 之后回不到 4.7某些老内部系统依赖旧版本行为时会出问题。如果是共用机器装之前先问一句有没有别的老程序在跑。3.2 VC 运行库x86 和 x64 都得装开头那个MSVCP140.dll缺失就是 VC 2015-2022 运行库没装。这里有个很容易漏的点64 位系统上 x86 和 x64 两个版本都要装。原因是取词模块为了能挂到 32 位目标程序上本身通常是 32 位进程缺 x86 运行库时表现是主界面正常一划词就静默退出。# 两个架构都要装顺序无所谓装完重启 winget install --id Microsoft.VCRedist.2015.x64 -e --accept-source-agreements winget install --id Microsoft.VCRedist.2015.x86 -e --accept-source-agreements-e是精确匹配包 ID避免 winget 模糊匹配到别的 VC 版本--accept-source-agreements只是省掉一次交互确认。没有 winget 的机器去下载中心拿vc_redist.x64.exe和vc_redist.x86.exe两个离线包双击装完同样要重启。判断是不是真的缺运行库别靠猜。拿 Dependency Walker 或者dumpbin /dependents看一眼主程序依赖如果列出来的VCRUNTIME140.dll、MSVCP140.dll、VCRUNTIME140_1.dll在C:\Windows\System32里找不到那基本可以确诊。VCRUNTIME140_1.dll只有 2019 之后的运行库才有装了 2015 版的旧包仍然会报它缺失所以务必用 2015-2022 的合并包。3.3 依赖装完的重启顺序运行库装完不要直接开程序。正确的顺序是先重启系统重启后确认C:\Windows\System32\vcruntime140.dll和msvcp140.dll存在再启动 TranslationTools。如果不想重启整台机器至少重启一次资源管理器让新的 DLL 搜索路径生效但 .NET Framework 的更新绕不过系统重启这条没有后悔药。另外装完依赖之后第一次启动建议用普通权限别一上来就右键「以管理员身份运行」。取词类工具有一个特性它只能取到权限级别不高于自己的程序的文本。你以管理员身份启动它普通程序里的文字照样取不到反过来普通权限启动任务管理器这类管理员程序取不到。所以先用普通权限跑一遍把常用场景覆盖到遇到特定程序取不到再单独用管理员启动。4. 首次启动与参数配置词典路径、热键、取词方式的四组设置4.1 第一次启动要做的事首次启动会生成配置文件和词典索引这个过程别打断。窗口出来后先不要急着划词按顺序做三件事确认界面语言是不是中文有些包默认英文、确认「本地词典」列表里至少有一条、确认日志目录下生成了当天的日志文件。这三件事对应三个子系统任意一个没起来后面的取词一定不顺。配置文件的格式各版本略有差异v3.1511.01 这类版本一般是 ini 形态初次启动自动生成在程序目录下。如果你拿到的是自带配置的包先备份再改; TranslationTools v3.1511.01 用户配置 ; 保存时用 ANSI 或 UTF-8 无 BOM别存成 UTF-16否则程序读到的第一个字符是 BOM整段解析失败 [General] ; 工作目录装完不要随便挪挪了必须同步改这里否则词典和缓存全找不到 WorkDirD:\Tools\TranslationTools\v3.1511.01 ; 日志级别0 关闭 1 只记错误 2 常规 3 调试排查取词问题临时开到 3查完调回 2 LogLevel2 [Dictionary] ; 本地词典根目录下面一层子目录就是一个词典 DictPathD:\Tools\TranslationTools\v3.1511.01\dict ; 加载顺序靠前的优先命中术语表放最后但优先级最高具体看程序里的设置 LoadOrderbasic,en2zh,tech [Hotkey] ; 划词/取词翻译热键避开 CtrlAlt字母输入法和显卡驱动抢得厉害 TranslateAltShiftT ; 截屏取词热键做图片文档时用 CaptureAltShiftSWorkDir是整份配置里最关键的一项写相对路径在某些版本上会被解析成当前工作目录从快捷方式启动和从命令行启动结果不一样所以一律写绝对路径。LogLevel平时保持 2出问题临时改 3改完必须重启程序才生效日志文件在logs\下按日期分文件。4.2 词典与离线包的导入顺序词典导入是有顺序的顺序错了表现是「明明装了专业词库翻译结果还是通用词」。我一般按这个层次来先让程序自带的 basic 词典就位再导入通用英汉/汉英词典最后导专业词库和自定义术语表。术语表放最后因为它的作用是把特定译法强制覆盖掉比如某个产品名固定译成某个词这类条目必须优先级最高。导入完要重建一次索引程序里一般有「重建索引」按钮没有的话就手动清cache\目录再启动。索引文件是二进制跨版本不兼容所以升级版本时cache\一定要清留着旧索引会出现「词典列表显示 5 个实际只加载 2 个」这种诡异现象。术语表文件建议用 UTF-8 无 BOM 保存用 Excel 导出 CSV 时选 UTF-8别用默认的 GBK否则生僻字会变成问号。4.3 热键与取词方式的取舍热键冲突是安装后最常见的「装了但用不了」。CtrlAlt字母这一类组合被输入法切换、显卡录屏、截图工具占用的概率极高注册失败时程序通常不报错只是按下去没反应。选热键的原则是用AltShift字母或者三键组合避开CtrlShift、CtrlAlt、Win开头的段位。改完热键先在一个记事本窗口里试能弹出来再去浏览器里试浏览器有自己的快捷键拦截。取词方式一般有三种鼠标划词、热键取当前光标处文本、截屏 OCR。划词最省事但对目标程序有要求UWP 应用、部分 Electron 应用和游戏窗口取不到热键取词兼容性好一些截屏 OCR 完全不依赖目标程序代价是慢一点。我的习惯是划词作主力、截屏作兜底两个热键分开设置别共用一个组合。4.4 显示效果的两项调整界面出现方块字通常是系统「非 Unicode 程序的语言」和程序编码不匹配造成的把系统区域设置改成中文简体并重启能解决大部分。另一种情况是个别生僻字显示成方框那是字体缺字换一套覆盖范围大的字体即可。翻译结果里的乱码则完全是另一回事那是词典文件本身的编码问题跟系统设置无关用文本编辑器打开词典源文件看一眼前几个字节就能判断是 UTF-8 还是 GBK 一看便知。5. 避坑与排查装完打不开、取词不弹窗的五条血泪记录5.1 启动阶段的两条现象一双击 exe鼠标转一圈什么都没发生任务管理器里进程闪一下就消失。原因三种可能缺 VC 运行库、路径含中文或空格、被杀软静默隔离。日志一条都没有的时候优先怀疑运行库和杀软因为程序还没走到写日志那一步就挂了。解决按 3.2 的命令补齐 x86 和 x64 两个运行库把程序挪到D:\Tools\TranslationTools\v3.1511.01这种纯英文无空格路径到杀软的隔离区看有没有记录有就恢复并加目录白名单。三条都做完还不行用cd进程序目录从命令行启动一次# 从命令行启动能把加载失败的错误直接打到控制台 Set-Location D:\Tools\TranslationTools\v3.1511.01 .\TranslationTools.exe控制台里如果出现「无法加载文件或程序集」字样就是依赖缺失比看日志快得多。现象二弹窗提示「应用程序的并行配置不正确」。原因系统里存在多个版本的 VC 运行库SxS 清单对不上常见于装过一堆老软件的机器。解决先在「应用和功能」里把 2015、2017、2019、2022 各版本运行库全部卸掉只保留 2015-2022 的合并包重装后重启。这个操作会影响到其他依赖 VC 的程序卸载前记一下清单出问题好回滚。5.2 取词与显示的三条现象三主界面正常鼠标划词不弹窗热键按下去也没反应。原因权限级别不一致或者热键注册失败。取词工具只能读权限不高于自己的进程在管理员程序窗口里划词取不到属于正常现象热键则常被输入法抢先注册。解决换到记事本、浏览器这类普通程序里再试把LogLevel调到 3 重启日志里会明确写出热键注册成功还是失败失败的换一组AltShift字母组合再试。如果是特定程序取不到先用截屏 OCR 顶一阵别在一个取词方式上死磕。现象四翻译结果出来一堆问号或者繁体乱码。原因词典文件的编码和程序读取时用的编码不一致。压缩包在不同系统之间转存过或者中途用文本编辑器改过术语表都会破坏原有编码。解决用文本编辑器打开对应的词典或术语表文件另存为 UTF-8 无 BOM清空cache\后重启程序重建索引。术语表从 Excel 导出的导出时明确选 UTF-8别用默认编码。现象五装好能用重启机器后热键全部失效、词典列表变空。原因十有八九是当初在 zip 里双击运行的配置写进了临时目录重启后被清理。另一个可能是程序目录被清理脚本扫过。解决把程序重新解压到固定目录确认config.ini就在 exe 同级生成把目录从任何自动清理的白名单里排除。改完跑一次第 6 章的检查表确认配置写的是绝对路径。6. 装完怎么验证跑通三组自检用例和一张交付前的检查表装完不验证等于没装。我交付一台机器之前固定跑三组用例覆盖三个不同的子系统本地词典检索、划词取词、截屏取词。第一组打开程序在搜索框里输入一个常见英文单词查词能返回释义说明词典索引正常。第二组打开一个记事本敲一段英文选中后按划词热键能弹出翻译窗口说明全局钩子注册成功。第三组打开一张带英文的图片按截屏取词热键框选能识别出文字说明 OCR 模块和字体环境都没问题。三组全过基本可以判定这套环境跑通了。再补两条命令级的检查比肉眼可靠# 1) 进程是不是从正确路径启动的排除临时目录里那份 Get-Process TranslationTools -ErrorAction SilentlyContinue | Select-Object Id, Path # 2) 最近日志里有没有 ERROR 或异常堆栈 Get-Content D:\Tools\TranslationTools\v3.1511.01\logs\app.log -Tail 80 | Select-String -Pattern ERROR|Exception|失败第一条命令如果输出的 Path 是%Temp%下的路径说明你还在用错误的方式启动回去看第 2 章。第二条命令输出为空是最理想的状态有内容就先看时间戳只关注本次启动之后的记录历史日志里的旧报错不用管。交付前的检查表我一般就照这张走检查项期望结果不通过先看哪exe 启动路径固定在版本号目录下第 2 章解压方式依赖运行库无缺失 DLL 提示第 3 章 VC/.NET配置文件生成在 exe 同级路径为绝对路径第 6 章进程路径词典加载数与dict\子目录数一致第 4 章索引重建划词热键记事本里可弹出第 5 章热键冲突截屏取词图片文字可识别第 4 章取词方式日志级别已从 3 调回 24.1 配置项最后提醒一句验证阶段把LogLevel临时开到 3 排查完记得改回 2。开着调试日志跑一天日志文件能涨到几百兆磁盘吃紧的机器上又是另一轮排查。从那以后我每装一台机器都是先按这张表走一遍再交出去省下来的时间远比填表多。希望帮到你。本文还有配套的精品资源点击获取
