Keil5汉化实战：让菜单栏说“中国话”的硬核技术路径
你有没有在深夜调试STM32代码时，对着Keil5界面上那个叫“Rebuild All - Current Target”的选项发过愣？
你知道“Start/Stop Debug Session”其实就是“启停调试”，但新来的实习生却误点了“Clean Project”清空了整个工程？
这不只是语言问题——这是认知效率的损耗，是团队协作的成本，更是嵌入式开发入门路上一道不必要的门槛。
而解决它的钥匙，就藏在tcmh32.dll这个不起眼的文件里。
为什么我们要给Keil5“动手术”？
Keil µVision5 是 ARM 生态中历史最悠久、应用最广泛的 IDE 之一。从高校实验室到工业产线，无数工程师用它点亮第一颗 LED、烧录第一个 Bootloader。
但它有一个致命短板：全英文界面。
尽管功能强大稳定，但对于中文母语者而言：
- “Project → Options for Target” 看似清晰，实则需要“脑内翻译”；
- 菜单层级深、术语密集，“Flash Download”、“Go to Address”等操作难以快速定位；
- 初学者常因误解菜单含义导致误操作，比如把“Clean”当成“Clear Output”。
更现实的问题是：国内大量高职院校、中小企业仍在广泛使用 Keil 开发 STM32、GD32 等主流 MCU。如果能让这些开发者直接看懂“编译”、“下载程序”、“开始调试”，学习曲线将大幅拉平。
官方不支持中文？没关系。社区早已给出了答案——我们自己动手，丰衣足食。
核心突破口：Keil 是怎么显示“File”和“Build”的？
要实现中文化，先得搞清楚 Keil 是如何渲染菜单项的。
菜单背后是一张“ID→字符串”的映射表
当你点击顶部菜单栏的“Project” → “Build Target”，Keil 并不是写死了一个"Build Target"字符串进去。而是通过一个标准 Windows 机制完成的：
LoadString(hInstance, IDM_BUILD_BUILD, buffer, sizeof(buffer));这里的IDM_BUILD_BUILD是一个整数 ID（通常是 40002），系统会根据当前语言环境去资源 DLL 中查找对应的文本。
原始英文版中：
40002 → "Build"我们的目标就是让它变成：
40002 → "编译"只要我们能控制这个映射过程，就能实现全局中文化。
方案一：直接替换资源DLL —— 最彻底也最危险
关键组件：tcmh32.dll
Keil 将所有 UI 文本打包在一个名为tcmh32.dll的动态链接库中，位于安装目录下的UV4\文件夹内。这个 DLL 不导出任何函数，只包含.rsrc资源节区，专门用于存放多语言字符串。
它的结构大致如下：
tcmh32.dll └── STRINGTABLE ├── LANG_ENGLISH │ ├── 40001: "New Project" │ ├── 40002: "Build" │ └── ... └── LANG_CHINESE (空或不存在) ├── ... (待填充)我们的任务，就是补全这个缺失的LANG_CHINESE分支。
汉化流程四步走
第一步：提取原始资源脚本
使用工具如 ResHacker 打开tcmh32.dll，导出.rc文件：
STRINGTABLE LANGUAGE LANG_ENGLISH, SUBLANG_DEFAULT BEGIN IDM_FILE_NEW "New File" IDM_FILE_OPEN "Open File" IDM_PROJECT_NEW "New uVision Project" IDM_BUILD_BUILD "Build Target" IDM_DEBUG_STARTSTOP "Start/Stop Debug Session" END第二步：逐条翻译为中文
注意保持 ID 与原文一致，仅修改引号内的内容：
STRINGTABLE LANGUAGE LANG_CHINESE, SUBLANG_CHINESE_SIMPLIFIED BEGIN IDM_FILE_NEW "新建文件" IDM_FILE_OPEN "打开文件" IDM_PROJECT_NEW "新建工程" IDM_BUILD_BUILD "编译" IDM_DEBUG_STARTSTOP "启停调试" IDM_FLASH_DOWNLOAD "下载程序" END第三步：编译成新的 DLL
借助 Windows SDK 提供的资源编译器（rc.exe）和链接器（link.exe）：
:: build_chs.bat rc -r -fo tcmh32.res tcmh32.rc link -dll -out:zh_CN\tcmh32.dll -base:0x11000000 tcmh32.obj kernel32.lib⚠️ 必须确保输出路径为
zh_CN\，因为 Keil 会根据系统区域自动加载该子目录下的资源 DLL。
第四步：部署并测试
- 备份原
UV4\tcmh32.dll； - 创建
UV4\zh_CN\目录，放入新生成的 DLL； - 将操作系统区域设置为“中文(简体, 中国)”；
- 启动 Keil，观察菜单是否已变为中文。
✅ 成功效果示例：
| 原始英文 | 中文显示 |
|---|---|
| Build Target | 编译 |
| Rebuild All | 重新编译全部 |
| Start Debug Session | 开始调试 |
| Flash DownLoad | 下载程序 |
遇到问题了吗？这些坑你一定要避开！
❌ 乱码问题：编码不对！
Keil 使用的是Unicode UTF-16 LE编码。如果你用记事本保存.rc文件选择了 ANSI 或 UTF-8 without BOM，结果就是满屏口口口。
✔️ 解决方案：使用支持编码选择的编辑器（如 Notepad++），保存为UTF-16 LE + BOM。
❌ 显示截断：“重新编译全部”太长了！
部分按钮宽度固定，中文字符比英文宽得多。“Rebuild All”占 10 个字符，“重新编译全部”却有 7 个汉字（相当于 14 英文字母宽度），超出控件范围会被裁剪。
✔️ 折中翻译建议：
| 英文原词 | 推荐中文译法 | 说明 |
|---|---|---|
| Rebuild All | 重编全部 | 简洁达意 |
| Clean Project | 清理工程 | 比“清除项目”更符合工程语境 |
| Stop Debugging | 停止调试 | 避免口语化“退出调试” |
❌ Keil 启动报错：“无法加载资源模块”
某些高版本 Keil（v5.30+）启用了数字签名验证，检测到tcmh32.dll被篡改后拒绝启动。
✔️ 替代方案登场：API Hook 注入技术。
方案二：运行时拦截——绕过签名保护的黑科技
当文件替换行不通时，我们就换个思路：不改文件，改行为。
利用 Windows 的 API Hook 技术，在 Keil 运行时拦截其调用LoadStringW的过程，强行返回中文字符串。
核心原理图解
[Keil主进程] ↓ 调用 LoadStringW(ID=40002) [系统API] ← 被Hook劫持 → [自定义DLL] ↓ 查询映射表 返回 L"编译"这种方式无需修改任何安装文件，完全规避了签名校验风险。
实战代码：基于 Detours 的轻量级 Hook
#include <windows.h> #include <map> #include <detours.h> // 中文映射表（可扩展至数百项） static std::map<UINT, std::wstring> g_zh_map = { {40002, L"编译"}, {40003, L"重编全部"}, {40004, L"下载程序"}, {40005, L"启停调试"}, {40006, L"清理工程"} }; // 原始函数指针 int (WINAPI *True_LoadStringW)( HINSTANCE hInstance, UINT uID, LPWSTR lpBuffer, int cchBufferMax ) = ::LoadStringW; // 拦截函数 int WINAPI Hooked_LoadStringW( HINSTANCE hInstance, UINT uID, LPWSTR lpBuffer, int cchBufferMax ) { // 只处理来自 tcmh32.dll 的请求 HMODULE hMod = GetModuleHandle(L"tcmh32.dll"); if (hInstance == hMod) { auto it = g_zh_map.find(uID); if (it != g_zh_map.end()) { size_t len = std::min(it->second.length(), (size_t)cchBufferMax - 1); wcsncpy_s(lpBuffer, cchBufferMax, it->second.c_str(), len); lpBuffer[len] = L'\0'; return (int)len; } } // 其他情况交还给原始函数 return True_LoadStringW(hInstance, uID, lpBuffer, cchBufferMax); } // DLL入口点 BOOL APIENTRY DllMain(HMODULE hModule, DWORD dwReason, LPVOID lpReserved) { if (dwReason == DLL_PROCESS_ATTACH) { DisableThreadLibraryCalls(hModule); DetourRestoreAfterWith(); DetourTransactionBegin(); DetourUpdateThread(GetCurrentThread()); DetourAttach(&(PVOID&)True_LoadStringW, Hooked_LoadStringW); DetourTransactionCommit(); } return TRUE; }如何注入？
常见方法包括：
- 注册表注入：写入
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Windows\AppInit_DLLs - 远程线程注入：使用
CreateRemoteThread + LoadLibrary动态加载 - 启动器包装：写一个启动脚本先注入再运行 Keil
⚠️ 注意事项：
- 必须静态链接 CRT，避免运行时依赖冲突；
- 建议在虚拟机中测试稳定性，防止崩溃影响开发环境。
工程实践建议：别一个人蛮干
✅ 推荐组合策略
| 场景 | 推荐方案 |
|---|---|
| 教学/培训环境 | 资源DLL替换（简单直观） |
| 企业内部统一部署 | 自研插件 + 签名绕过检测 |
| 高安全要求项目 | API Hook（无文件改动） |
| 版本频繁升级 | 建立翻译数据库 + 自动化构建流程 |
🛠️ 构建你的汉化流水线
- 建立翻译数据库（JSON/CSV）：
[ { "id": 40002, "en": "Build", "zh": "编译", "context": "Menu item under Project" } ]- 自动化生成 .rc 文件
编写 Python 脚本读取 JSON，生成标准资源脚本。
- CI/CD 打包工具链
结合 GitHub Actions 或本地批处理，一键生成适用于不同 Keil 版本的汉化包。
- 版本匹配提醒机制
在 DLL 内嵌版本信息，启动时检查 Keil 版本是否兼容，避免错配导致空白菜单。
更进一步：字体适配与用户体验优化
即使菜单变中文了，你还可能遇到：
- 字体显示模糊（默认使用 MS Shell Dlg）
- 汉字笔画粘连、缺损
解决方案：强制加载中文字体
可在 Hook DLL 中进一步挂钩CreateWindowExW或WM_SETFONT消息，将控件字体替换为SimSun或Microsoft YaHei UI。
例如：
LOGFONT lf = {0}; wcscpy_s(lf.lfFaceName, L"SimSun"); lf.lfCharSet = GB2312_CHARSET; HFONT hFont = CreateFontIndirect(&lf); SendMessage(hWnd, WM_SETFONT, (WPARAM)hFont, MAKELPARAM(TRUE, 0));虽然复杂度上升，但可实现真正意义上的“原生中文体验”。
写在最后：这不是简单的翻译，而是降低技术门槛的努力
Keil5 汉化从来不是一个“要不要做”的问题，而是一个“怎么做才安全、可持续”的工程命题。
我们做的不仅是把 “Build” 改成 “编译”，更是：
- 让一名大一学生不再因看不懂菜单放弃嵌入式课程；
- 让一家小厂的技术员能独立完成固件更新；
- 让国产芯片生态少一点对英文文档的依赖。
未来，VSCode + Cortex-Debug + CMake 的现代化工具链终将普及，真正的国际化支持也会成为标配。
但在今天，在很多角落还有人在用 Keil v5.28 开发电机控制器、智能电表、医疗设备的时候——
让我们先给他们一个看得懂的菜单栏吧。
如果你正在尝试实现 Keil5 中文化，欢迎在评论区分享你的经验或踩过的坑。我们可以一起维护一份开源的高质量汉化资源库，让后来者少走弯路。
