简介这份汉化包面向使用 MyEclipse 10.7 的中国 Java 开发者针对英文界面在菜单、提示与帮助文档理解上的门槛提供较完整的中文语言替换方案。压缩包共 484 个文件以 jar 语言资源、html 帮助页面、xml 配置、properties 文本及少量 jpg 界面图为主整体约 2.44MB体积轻便便于随包留存和分发。汉化范围覆盖启动画面与主界面、工程创建导入、代码提示与语法检查、Maven/Ant 构建配置、断点调试、服务器运行配置以及数据库管理、JSP/HTML 编辑、UML 建模等内置插件和在线帮助并兼顾中文字符较宽带来的控件宽度与排列适配。已有 216 人学习适合希望在不改变原有开发习惯的前提下降低语言障碍、快速熟悉 IDE 功能布局的初中级开发者也可作为团队统一中文环境的参考。资源侧重界面本地化与文档同步而非功能增强使用前宜保留原文件以便回退。1. MyEclipse 10.7 汉化到底改的是哪一层先认清 Eclipse 3.7 的 NL 机制很多人拿到 MyEclipse 10.7 汉化包的第一反应是解压、拖进安装目录、重启然后发现菜单还是英文于是断定“包是坏的”。真实的翻车点往往不在这。MyEclipse 10.7 的界面文字是分两套来源的一套来自 Eclipse 3.7 底座另一套来自 MyEclipse 自己的商业插件。所谓汉化包本质上是一批命名成xxx.nl_zh_CN_版本号.jar的 NL fragment只有被 OSGi 识别、且版本号和宿主插件对上启动时才会被挂载。底座对上了文件 / 编辑 / 窗口 / 首选项这一层才是中文MyEclipse 特有的透视图和服务器面板多数情况下仍是英文这不是安装失败。这篇按“认底座 → 选包 → 落地 → 调参 → 排错”的顺序走一遍适合还在维护老项目、必须用 10.7 这套环境的人。2. 版本对齐把 10.7 的底座和 zh_CN 语言包配成一对汉化能不能成八成取决于这一步。Eclipse 的 NL fragment 是“贴着宿主插件版本走”的宿主的org.eclipse.ui是 3.7.2你就不能塞一个 3.6.x 的翻译包进去哪怕文件名看着差不多。所以动手之前先把底座版本钉死再去挑包顺序不能反。2.1 确认底座版本三个比“关于”对话框更可靠的入口最省事的做法是启动 IDE 看“帮助 → 关于”但这一步有个前提IDE 得能正常起来。一旦你已经被半吊子汉化包搞到启动卡死这招就废了。我一般直接看文件三个位置任选位置关键内容能读出什么安装根目录.eclipseproductversion3.7.2底座主版本最直接Common\plugins\org.eclipse.core.runtime_*.jar文件名里的版本段运行时版本判断 SR 级别configuration\org.eclipse.equinox.simpleconfigurator\bundles.info每行 CSV含 bundle 符号名与版本实际被加载的插件清单排错时最有用MyEclipse 10.x 的插件目录不在安装根目录下而是在Common\plugins和Common\features这一点和纯 Eclipse 不一样很多人第一次找插件版本会在这里迷路。写个小脚本扫一遍比手工翻目录快得多import re import pathlib # 改成你自己的安装根目录路径里有空格记得用原始字符串 IDE_HOME pathlib.Path(rD:\MyEclipse\MyEclipse 10) PLUGINS IDE_HOME / Common / plugins # 只关心决定 UI 语言的那几个宿主插件 TARGET re.compile(r^(org\.eclipse\.(?:ui|core\.runtime|platform|ui\.workbench))_(\d\.\d\.\d)) found {} for jar in PLUGINS.glob(*.jar): m TARGET.match(jar.name) if m: found.setdefault(m.group(1), set()).add(m.group(2)) for name in sorted(found): print(f{name:32s} - {, .join(sorted(found[name]))})这段脚本干的事很简单遍历Common\plugins下的 jar用正则把插件符号名 主次修订版本号抠出来按插件名归并。TARGET里我只留了ui、core.runtime、platform、ui.workbench四个因为它们才是菜单、对话框、首选项页面的文字来源。跑出来的结果如果是3.7.2那你要的语言包就必须是 Indigo SR2 那一批如果冒出3.6.x的混杂版本说明这个安装目录被前人手功覆盖过先别急着汉化把底座修干净再说。提示bundles.info是带启动顺序和 start-level 的用 Excel 或文本编辑器打开时按逗号分列能一眼看出某个 NL jar 到底有没有被登记进去比翻configuration日志快。2.2 语言包选型整包、社区翻译包、第三方整合包的差别市面上能拿到的 zh_CN 包大致三类名字都很像实际差别不小类型典型形态优点风险点官方整包一个压缩包内含完整featuresplugins命名带 SR 号版本严格对应覆盖完整体积大只覆盖底座不含 MyEclipse 自有插件社区翻译项目分包按插件拆成多个*.nl_zh_CN_*.jar可按需取用版本粒度细需要自己挑挑错版本号直接不加载第三方整合包打包成“一键安装”脚本或自解压程序省事常混入旧版本 jar覆盖式安装后极难回退选型原则就一条NL fragment 的版本号必须等于它要翻译的那个宿主插件的版本号。举例org.eclipse.ui.nl_zh_CN_3.7.2.xxxxxxxx.jar对应的是org.eclipse.ui_3.7.2.xxxxxxxx.jar最后那串构建号最好也一致。差一个修订号大多数时候还能凑合加载差一个次版本号轻则界面部分回退成英文重则启动阶段抛MissingResourceException连欢迎页都进不去。我在实际项目里更倾向于用官方整包因为它和底座的版本是一起发布的省去逐条比对。如果只是想补几个高频界面的中文社区分包更灵活但也更考验你对版本号的眼力。2.3 文件落地形态features 与 plugins 里到底该有什么解压一个合格的 zh_CN 语言包目录结构应该长这样langpack/ └── eclipse/ ├── features/ │ ├── org.eclipse.platform.nl_zh_CN_3.7.2.xxxx.jar │ └── org.eclipse.rcp.nl_zh_CN_3.7.2.xxxx.jar └── plugins/ ├── org.eclipse.ui.nl_zh_CN_3.7.2.xxxx.jar ├── org.eclipse.ui.workbench.nl_zh_CN_3.7.2.xxxx.jar └── org.eclipse.core.runtime.nl_zh_CN_3.7.2.xxxx.jarplugins下的 jar 是插件级翻译负责具体视图、编辑器、对话框的字符串features下的 jar 是特性级翻译负责“安装详情”“关于”这类以 feature 为单位聚合的描述文本。两者缺一表现不一样只放plugins主菜单会变中文但“帮助 → 关于”里的特性描述还是英文只放features则是反过来的效果。这就是为什么有些人汉化完说“汉化了一半”其实不是包的问题是他只拷了半个目录。对照检查的方法很土但有效把语言包plugins里的 jar 名去掉.nl_zh_CN_版本号后缀得到宿主插件名再回头看Common\plugins里有没有同名宿主。有说明这条翻译用得上没有就是冗余文件留着也不会加载但会让目录越来越乱。3. 三种落地方式dropins、links、覆盖安装的取舍版本对齐之后才轮到“往哪儿放”。这三种方式我都在真机上跑过结论是日常用 links临时试水用 dropins覆盖安装只在被逼到墙角时用。3.1 dropins 方式改动最小但要接受首次启动不生效dropins 是 Eclipse 留给外部扩展的目录MyEclipse 安装根目录下默认没有需要自己建。放法有两种我推荐带子目录的那种便于整块删除echo off set IDE_HOMED:\MyEclipse\MyEclipse 10 set LANG_SRCD:\download\langpack\eclipse REM 建立独立的语言包目录不要直接往 dropins 根下撒 jar if not exist %IDE_HOME%\dropins\zh_CN\plugins mkdir %IDE_HOME%\dropins\zh_CN\plugins if not exist %IDE_HOME%\dropins\zh_CN\features mkdir %IDE_HOME%\dropins\zh_CN\features xcopy %LANG_SRC%\plugins\*.jar %IDE_HOME%\dropins\zh_CN\plugins\ /Y /Q xcopy %LANG_SRC%\features\*.jar %IDE_HOME%\dropins\zh_CN\features\ /Y /Q echo done./Y是覆盖时不询问/Q是静默两个参数在批量刷机器时很省心。关键在于目录层级dropins\zh_CN\下面必须是plugins和features两个目录p2 的 dropins 扫描器才认得出来如果你把 jar 直接丢在dropins\zh_CN\根下它会被当成普通 jar 忽略掉。这个层级的坑我踩过不止一次表现就是“明明拷进去了重启毫无变化”。dropins 的第二个坑是首次启动不生效。NL fragment 的挂载依赖-nl参数在启动早期生效而 dropins 目录的扫描发生在 p2 reconciler 阶段比它晚。所以正确姿势是拷完文件带-clean启动一次让它把新 bundle 写进bundles.info再正常启动。后面第 4 章会细说。3.2 links 方式多语言切换和批量部署的正解links 方式是我现在只用的一种。原理是在links目录下放一个.link文本文件内容是path指向语言包的实际位置启动器读这个指针去加载。好处是语言包本体可以放在安装目录之外装在 D 盘、共享盘、甚至 U 盘都行IDE 目录本身不被污染。# 文件D:\MyEclipse\MyEclipse 10\links\zh_CN.link # 内容只有一行路径用正斜杠不要加引号不要以分号结尾 pathD:/MyEclipse/langpack/zh_CN而D:/MyEclipse/langpack/zh_CN这个目录下同样要有features和plugins两个子目录结构和 2.3 节一致。.link文件有三个容易写错的地方一是路径分隔符必须用正斜杠/写成反斜杠在部分版本上会被吃掉二是路径里带空格时不要加引号加了反而解析失败三是行尾不要留多余的分号Eclipse 3.x 的解析器不接受。写完之后配合-clean启动一次然后在“帮助 → 关于 → 安装详细信息 → 插件”里搜nl_zh_CN能搜到就说明加载成功。links 方式真正的价值在切换。你要临时回到英文界面不用卸载把zh_CN.link改名成zh_CN.link.off再带-clean启动一次即可。第 6 章会把这个动作做成脚本。3.3 覆盖安装什么时候才值得用以及必须做的备份覆盖安装就是把语言包的features和plugins里的 jar直接拷进Common\features和Common\plugins。它唯一的好处是“一定能被加载”因为文件就躺在宿主插件旁边不存在扫描不到的问题。在老版本启动器不认 dropins、links 又配不对路径的情况下这是最后的后悔药。代价是你失去了回退能力。Common\plugins里原本就有几百个 jar语言包往里一掺事后想分清哪些是后来加的只能靠文件名里的nl_zh_CN去筛。所以覆盖之前必须先备份哪怕只是把整个Common目录压缩一份echo off set IDE_HOMED:\MyEclipse\MyEclipse 10 set BACKUPD:\backup\myeclipse10_common_%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%.zip REM 用系统自带的 tarWin10 1803 可用打包避免依赖第三方压缩工具 tar -a -c -f %BACKUP% -C %IDE_HOME% Common echo backup - %BACKUP%tar -a会根据输出文件扩展名自动选择压缩格式.zip走 zip.tar.gz走 gzipWindows 10 之后自带不用装 7-Zip。备份完再覆盖出问题直接把Common整个还原回去。注意覆盖安装之后如果将来用 IDE 自带的更新机制升级NL jar 会被当成“未知来源的插件”处理升级过程可能报校验失败。这也是我不推荐覆盖的原因之一。三种方式的取舍可以这么记只做一次、机器就一台links要批量刷十几台开发机links 加共享路径最省事试水阶段怕搞坏环境dropins 加-clean前两种都被环境卡住才上覆盖并且先备份。4. 启动参数与缓存让汉化真正生效的那几个开关包放对了参数没配对界面照样是英文。这一步是纯配置活但细节密度很高尤其是 ini 文件的参数顺序。4.1 ini 文件认哪个myeclipse.ini 和 eclipse.ini 不是一回事MyEclipse 10 的安装根目录下启动器是myeclipse.exe它读的是同目录的myeclipse.ini。有些人的目录里同时存在eclipse.ini可能是从别的 Eclipse 拷贝过来的或者旧版本残留改了半天没反应就是改错了文件。判断方法很简单myeclipse.ini的第一行通常是-startup紧跟着的--launcher.library指向Common\plugins下的 launcher 插件路径里带Common就对了。一个可用的myeclipse.ini关键片段长这样-startup ../Common/plugins/org.eclipse.equinox.launcher_1.2.0.v20110502.jar --launcher.library ../Common/plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.100.v20110502 -vm C:/Java/jdk1.6.0_45/bin/javaw.exe -nl zh_CN -vmargs -Xms256m -Xmx1024m -XX:MaxPermSize256m -Duser.languagezh -Duser.countryCN参数顺序是硬约束-nl属于启动器参数必须写在-vmargs之前-vmargs之后的所有内容都会原样传给 JVM这时候再写-nl就没用了JVM 不认识它会直接忽略。这个顺序错位导致的“汉化不生效”占了我在群里见到的故障的一半以上。-Duser.languagezh和-Duser.countryCN是给 JVM 的默认 Locale 兜底主要影响日期、数字格式以及部分没读-nl的第三方插件。加上没坏处但别指望它单独就能把界面变中文。4.2 -clean 的时机什么时候必须加加几次-clean的作用是清掉configuration目录下的 OSGi 缓存强制重新扫描所有 bundle。它和汉化的关系是只要你动过plugins、features、dropins、links里的任何一处旧缓存里的 bundle 清单就和实际文件对不上了必须-clean一次重建。判断要不要加我一般看两件事场景要不要 -clean说明首次安装语言包要重建 bundle 清单登记 NL fragment修改.link文件的 path要路径变了旧清单失效只改 ini 里的-nl值要Locale 变化需要重新解析 fragment日常启动不要每次加会拖慢启动十几秒起步换工作空间不要工作空间和 bundle 缓存是两回事还有个细节-clean在 Eclipse 3.7 上只清一次就够第二次启动不要带否则每次启动都在重建缓存。有些教程让你常驻-clean那是把启动速度当儿戏血泪经验是别学。4.3 验证汉化生效的四个检查点别只看菜单。四个检查点按可信度从低到高排主菜单文件 / 编辑 / 窗口 / 帮助变中文。最直观但也最容易被“半汉化”骗过去。首选项页窗口 → 首选项左侧树的中文覆盖率。这里如果只有顶层是中文、展开后全是英文说明plugins级 NL 缺了一部分。安装详细信息帮助 → 关于 MyEclipse → 安装详细信息 → 插件搜nl_zh_CN。能列出条目说明 fragment 被 OSGi 认了这是最硬的证据。bundles.info打开configuration\org.eclipse.equinox.simpleconfigurator\bundles.info搜nl_zh_CN。有记录 已登记没记录 加载链路断了回去查 dropins 层级或.link路径。这四个点如果只有 1 通过、3 和 4 都不通过说明你看到的中文其实是某个插件的内置翻译不是你装的语言包在起作用别高兴太早。5. 排查与避坑汉化后启动失败、半中半英的五个现场下面五条都是我在老机器上真实遇到过的按“现象 → 原因 → 解决”写遇到同款可以直接对号入座。5.1 改了 ini 重启毫无变化菜单依旧英文现象按教程在eclipse.ini里加了-nl zh_CN重启多次界面纹丝不动。原因启动器读的是同目录的myeclipse.inieclipse.ini根本没被加载或者你把-nl写到了-vmargs后面被当成 JVM 参数吞掉了。解决确认myeclipse.ini里-startup段的路径含Common把-nl和zh_CN移到-vmargs之前然后带-clean启动一次。改完先别急着看菜单去bundles.info里搜一下有没有 NL 记录那才是准信号。5.2 启动卡在 splash或者起来后直接闪退现象加完语言包双击myeclipse.exe进度条走到一半停住或者窗口一闪就没了。原因语言包的版本和底座不匹配。典型是拿了 3.6 的包往 3.7.2 上怼NL fragment 声明了对某个宿主版本的依赖OSGi 解析依赖失败启动链在早期就断了。解决先看工作空间\.metadata\.log搜MissingResourceException或Could not resolve module日志里会明确写出是哪个 bundle 解析失败。确认是版本问题后把语言包整个撤掉dropins 直接删目录、links 就改.link后缀、覆盖安装就还原备份换成与底座完全一致的版本再试。不要试图靠删几个 jar “修”版本问题那是在给自己挖坑。5.3 菜单中文了但 MyEclipse 特有的面板全是英文现象文件 / 编辑是中文切到 MyEclipse 透视图服务器连接器、部署面板、数据库浏览器全是英文。原因这不是故障。MyEclipse 自有插件是商业组件官方语言包里不包含它们的 NL fragment社区翻译项目也极少覆盖。汉化的边界就在 Eclipse 底座这一层。解决接受这个边界或者只对高频菜单做局部汉化自己写 NL fragment 不现实工作量大且随版本失效。另外检查一下是不是只拷了plugins没拷features那种情况下“帮助 → 关于”里的特性描述会残留英文容易和上面这种正常现象混淆。5.4 首次启动没反应第二次启动突然变中文了现象装完语言包第一次启动界面英文什么都没改第二天再开变中文了。原因dropins 或 links 的 bundle 扫描发生在启动流程靠后的阶段第一次启动只是把新 bundle 登记进bundles.info真正挂载要等下一次启动。这就是“首次不生效”的机制。解决装完立刻带-clean启动一次然后再正常启动一次一次搞定省掉一天的困惑。反过来说如果你遇到“怎么都不生效”先确认是不是每次都只启动了一次就放弃了。5.5 汉化之后项目里的中文注释和字符串全变乱码现象界面中文了打开原有项目Java 文件里的中文注释变成一堆问号或方块控制台输出也是乱码。原因和汉化包没关系。-nl zh_CN只影响界面 Locale工作空间的文本编码是另一套设置。老项目多半是 GBK而新工作空间默认跟随系统或 UTF-8一错位就乱码。解决窗口 → 首选项 → 常规 → 工作空间把“文本文件编码”显式设成项目实际用的编码GBK 或 UTF-8单个项目还可以在项目属性里覆盖。同时检查 ini 里有没有多余的-Dfile.encoding有的话统一成和项目一致的值。这一条最容易背锅给汉化包其实改两行设置就好了。6. 进阶做一个中英文一键切换的启动脚本维护老项目的时候我经常需要在中英文之间来回切自己看中文舒服但截图给外部对接方、或者排查某个只记得英文名的菜单项时又得切回英文。手工改.link后缀、带-clean、再启动一天折腾几遍谁都烦。所以我把这套动作固化成了一个批处理放在桌面双击就切。思路是语言包目录保持不动只改links\zh_CN.link的启用状态然后自动带-clean启动一次 IDE。脚本里用两个标记文件判断当前状态避免重复切换。echo off setlocal enabledelayedexpansion REM 按实际安装路径修改 set IDE_HOMED:\MyEclipse\MyEclipse 10 set LINK_FILE%IDE_HOME%\links\zh_CN.link set FLAG%IDE_HOME%\links\.lang_state if not exist %LINK_FILE% ( echo [ERROR] link file not found: %LINK_FILE% exit /b 1 ) set STATEen if exist %FLAG% set /p STATE%FLAG% if /i %STATE%zh ( REM 当前中文切英文改名禁用 link清状态 ren %LINK_FILE% zh_CN.link.off del /q %FLAG% 2nul echo switched to EN ) else ( REM 当前英文切中文恢复 link写状态 if exist %LINK_FILE%.off ren %LINK_FILE%.off zh_CN.link echo zh%FLAG% echo switched to ZH ) REM 带 -clean 启动一次重建 bundle 清单 start %IDE_HOME%\myeclipse.exe -clean endlocal脚本里有几个点值得说明。setlocal enabledelayedexpansion是为循环和变量展开准备的这个场景其实用不上但养成习惯没坏处。ren改后缀这一步是关键Eclipse 只认.link结尾的文件.link.off会被忽略等于软禁用语言包本体一个字节都没动随时能切回来。-clean通过命令行传比改 ini 更灵活用完就没了不会让每次启动都背着这个包袱。状态判断用的是一个标记文件.lang_state里面写zh表示当前是中文态。这个做法有点土但比去解析bundles.info稳得多——后者在异常退出时可能写不完整反而误判。第一次运行时标记文件不存在脚本默认走英文态会把.link恢复回来这个行为是符合直觉的。如果你机器上装了好几套环境这个脚本稍微改改就能复用把IDE_HOME抽成参数外面套一层菜单一个脚本管三四个安装目录。我一般还会在脚本末尾加一行timeout /t 3避免窗口一闪而过看不到输出。提示切换之后如果发现 IDE 启动报 bundle 冲突先别怀疑脚本去links目录看看是不是残留了.link.off和.link同时存在的情况。ren在目标文件已存在时会失败脚本里没做覆盖保护这是唯一需要人工确认的点。从那以后我每次装完语言包都会先把 ini 参数顺序、bundles.info里的 NL 记录、links目录的实际状态这三样强制过一遍再谈“汉化成功”。这三处任何一处没对上界面上的中文都只是巧合。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/24 4:20:15 · 阅读 1.2k MyEclipse 10.7 汉化：NL fragment 版本对齐与部署避坑
简介这份汉化包面向使用 MyEclipse 10.7 的中国 Java 开发者针对英文界面在菜单、提示与帮助文档理解上的门槛提供较完整的中文语言替换方案。压缩包共 484 个文件以 jar 语言资源、html 帮助页面、xml 配置、properties 文本及少量 jpg 界面图为主整体约 2.44MB体积轻便便于随包留存和分发。汉化范围覆盖启动画面与主界面、工程创建导入、代码提示与语法检查、Maven/Ant 构建配置、断点调试、服务器运行配置以及数据库管理、JSP/HTML 编辑、UML 建模等内置插件和在线帮助并兼顾中文字符较宽带来的控件宽度与排列适配。已有 216 人学习适合希望在不改变原有开发习惯的前提下降低语言障碍、快速熟悉 IDE 功能布局的初中级开发者也可作为团队统一中文环境的参考。资源侧重界面本地化与文档同步而非功能增强使用前宜保留原文件以便回退。1. MyEclipse 10.7 汉化到底改的是哪一层先认清 Eclipse 3.7 的 NL 机制很多人拿到 MyEclipse 10.7 汉化包的第一反应是解压、拖进安装目录、重启然后发现菜单还是英文于是断定“包是坏的”。真实的翻车点往往不在这。MyEclipse 10.7 的界面文字是分两套来源的一套来自 Eclipse 3.7 底座另一套来自 MyEclipse 自己的商业插件。所谓汉化包本质上是一批命名成xxx.nl_zh_CN_版本号.jar的 NL fragment只有被 OSGi 识别、且版本号和宿主插件对上启动时才会被挂载。底座对上了文件 / 编辑 / 窗口 / 首选项这一层才是中文MyEclipse 特有的透视图和服务器面板多数情况下仍是英文这不是安装失败。这篇按“认底座 → 选包 → 落地 → 调参 → 排错”的顺序走一遍适合还在维护老项目、必须用 10.7 这套环境的人。2. 版本对齐把 10.7 的底座和 zh_CN 语言包配成一对汉化能不能成八成取决于这一步。Eclipse 的 NL fragment 是“贴着宿主插件版本走”的宿主的org.eclipse.ui是 3.7.2你就不能塞一个 3.6.x 的翻译包进去哪怕文件名看着差不多。所以动手之前先把底座版本钉死再去挑包顺序不能反。2.1 确认底座版本三个比“关于”对话框更可靠的入口最省事的做法是启动 IDE 看“帮助 → 关于”但这一步有个前提IDE 得能正常起来。一旦你已经被半吊子汉化包搞到启动卡死这招就废了。我一般直接看文件三个位置任选位置关键内容能读出什么安装根目录.eclipseproductversion3.7.2底座主版本最直接Common\plugins\org.eclipse.core.runtime_*.jar文件名里的版本段运行时版本判断 SR 级别configuration\org.eclipse.equinox.simpleconfigurator\bundles.info每行 CSV含 bundle 符号名与版本实际被加载的插件清单排错时最有用MyEclipse 10.x 的插件目录不在安装根目录下而是在Common\plugins和Common\features这一点和纯 Eclipse 不一样很多人第一次找插件版本会在这里迷路。写个小脚本扫一遍比手工翻目录快得多import re import pathlib # 改成你自己的安装根目录路径里有空格记得用原始字符串 IDE_HOME pathlib.Path(rD:\MyEclipse\MyEclipse 10) PLUGINS IDE_HOME / Common / plugins # 只关心决定 UI 语言的那几个宿主插件 TARGET re.compile(r^(org\.eclipse\.(?:ui|core\.runtime|platform|ui\.workbench))_(\d\.\d\.\d)) found {} for jar in PLUGINS.glob(*.jar): m TARGET.match(jar.name) if m: found.setdefault(m.group(1), set()).add(m.group(2)) for name in sorted(found): print(f{name:32s} - {, .join(sorted(found[name]))})这段脚本干的事很简单遍历Common\plugins下的 jar用正则把插件符号名 主次修订版本号抠出来按插件名归并。TARGET里我只留了ui、core.runtime、platform、ui.workbench四个因为它们才是菜单、对话框、首选项页面的文字来源。跑出来的结果如果是3.7.2那你要的语言包就必须是 Indigo SR2 那一批如果冒出3.6.x的混杂版本说明这个安装目录被前人手功覆盖过先别急着汉化把底座修干净再说。提示bundles.info是带启动顺序和 start-level 的用 Excel 或文本编辑器打开时按逗号分列能一眼看出某个 NL jar 到底有没有被登记进去比翻configuration日志快。2.2 语言包选型整包、社区翻译包、第三方整合包的差别市面上能拿到的 zh_CN 包大致三类名字都很像实际差别不小类型典型形态优点风险点官方整包一个压缩包内含完整featuresplugins命名带 SR 号版本严格对应覆盖完整体积大只覆盖底座不含 MyEclipse 自有插件社区翻译项目分包按插件拆成多个*.nl_zh_CN_*.jar可按需取用版本粒度细需要自己挑挑错版本号直接不加载第三方整合包打包成“一键安装”脚本或自解压程序省事常混入旧版本 jar覆盖式安装后极难回退选型原则就一条NL fragment 的版本号必须等于它要翻译的那个宿主插件的版本号。举例org.eclipse.ui.nl_zh_CN_3.7.2.xxxxxxxx.jar对应的是org.eclipse.ui_3.7.2.xxxxxxxx.jar最后那串构建号最好也一致。差一个修订号大多数时候还能凑合加载差一个次版本号轻则界面部分回退成英文重则启动阶段抛MissingResourceException连欢迎页都进不去。我在实际项目里更倾向于用官方整包因为它和底座的版本是一起发布的省去逐条比对。如果只是想补几个高频界面的中文社区分包更灵活但也更考验你对版本号的眼力。2.3 文件落地形态features 与 plugins 里到底该有什么解压一个合格的 zh_CN 语言包目录结构应该长这样langpack/ └── eclipse/ ├── features/ │ ├── org.eclipse.platform.nl_zh_CN_3.7.2.xxxx.jar │ └── org.eclipse.rcp.nl_zh_CN_3.7.2.xxxx.jar └── plugins/ ├── org.eclipse.ui.nl_zh_CN_3.7.2.xxxx.jar ├── org.eclipse.ui.workbench.nl_zh_CN_3.7.2.xxxx.jar └── org.eclipse.core.runtime.nl_zh_CN_3.7.2.xxxx.jarplugins下的 jar 是插件级翻译负责具体视图、编辑器、对话框的字符串features下的 jar 是特性级翻译负责“安装详情”“关于”这类以 feature 为单位聚合的描述文本。两者缺一表现不一样只放plugins主菜单会变中文但“帮助 → 关于”里的特性描述还是英文只放features则是反过来的效果。这就是为什么有些人汉化完说“汉化了一半”其实不是包的问题是他只拷了半个目录。对照检查的方法很土但有效把语言包plugins里的 jar 名去掉.nl_zh_CN_版本号后缀得到宿主插件名再回头看Common\plugins里有没有同名宿主。有说明这条翻译用得上没有就是冗余文件留着也不会加载但会让目录越来越乱。3. 三种落地方式dropins、links、覆盖安装的取舍版本对齐之后才轮到“往哪儿放”。这三种方式我都在真机上跑过结论是日常用 links临时试水用 dropins覆盖安装只在被逼到墙角时用。3.1 dropins 方式改动最小但要接受首次启动不生效dropins 是 Eclipse 留给外部扩展的目录MyEclipse 安装根目录下默认没有需要自己建。放法有两种我推荐带子目录的那种便于整块删除echo off set IDE_HOMED:\MyEclipse\MyEclipse 10 set LANG_SRCD:\download\langpack\eclipse REM 建立独立的语言包目录不要直接往 dropins 根下撒 jar if not exist %IDE_HOME%\dropins\zh_CN\plugins mkdir %IDE_HOME%\dropins\zh_CN\plugins if not exist %IDE_HOME%\dropins\zh_CN\features mkdir %IDE_HOME%\dropins\zh_CN\features xcopy %LANG_SRC%\plugins\*.jar %IDE_HOME%\dropins\zh_CN\plugins\ /Y /Q xcopy %LANG_SRC%\features\*.jar %IDE_HOME%\dropins\zh_CN\features\ /Y /Q echo done./Y是覆盖时不询问/Q是静默两个参数在批量刷机器时很省心。关键在于目录层级dropins\zh_CN\下面必须是plugins和features两个目录p2 的 dropins 扫描器才认得出来如果你把 jar 直接丢在dropins\zh_CN\根下它会被当成普通 jar 忽略掉。这个层级的坑我踩过不止一次表现就是“明明拷进去了重启毫无变化”。dropins 的第二个坑是首次启动不生效。NL fragment 的挂载依赖-nl参数在启动早期生效而 dropins 目录的扫描发生在 p2 reconciler 阶段比它晚。所以正确姿势是拷完文件带-clean启动一次让它把新 bundle 写进bundles.info再正常启动。后面第 4 章会细说。3.2 links 方式多语言切换和批量部署的正解links 方式是我现在只用的一种。原理是在links目录下放一个.link文本文件内容是path指向语言包的实际位置启动器读这个指针去加载。好处是语言包本体可以放在安装目录之外装在 D 盘、共享盘、甚至 U 盘都行IDE 目录本身不被污染。# 文件D:\MyEclipse\MyEclipse 10\links\zh_CN.link # 内容只有一行路径用正斜杠不要加引号不要以分号结尾 pathD:/MyEclipse/langpack/zh_CN而D:/MyEclipse/langpack/zh_CN这个目录下同样要有features和plugins两个子目录结构和 2.3 节一致。.link文件有三个容易写错的地方一是路径分隔符必须用正斜杠/写成反斜杠在部分版本上会被吃掉二是路径里带空格时不要加引号加了反而解析失败三是行尾不要留多余的分号Eclipse 3.x 的解析器不接受。写完之后配合-clean启动一次然后在“帮助 → 关于 → 安装详细信息 → 插件”里搜nl_zh_CN能搜到就说明加载成功。links 方式真正的价值在切换。你要临时回到英文界面不用卸载把zh_CN.link改名成zh_CN.link.off再带-clean启动一次即可。第 6 章会把这个动作做成脚本。3.3 覆盖安装什么时候才值得用以及必须做的备份覆盖安装就是把语言包的features和plugins里的 jar直接拷进Common\features和Common\plugins。它唯一的好处是“一定能被加载”因为文件就躺在宿主插件旁边不存在扫描不到的问题。在老版本启动器不认 dropins、links 又配不对路径的情况下这是最后的后悔药。代价是你失去了回退能力。Common\plugins里原本就有几百个 jar语言包往里一掺事后想分清哪些是后来加的只能靠文件名里的nl_zh_CN去筛。所以覆盖之前必须先备份哪怕只是把整个Common目录压缩一份echo off set IDE_HOMED:\MyEclipse\MyEclipse 10 set BACKUPD:\backup\myeclipse10_common_%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%.zip REM 用系统自带的 tarWin10 1803 可用打包避免依赖第三方压缩工具 tar -a -c -f %BACKUP% -C %IDE_HOME% Common echo backup - %BACKUP%tar -a会根据输出文件扩展名自动选择压缩格式.zip走 zip.tar.gz走 gzipWindows 10 之后自带不用装 7-Zip。备份完再覆盖出问题直接把Common整个还原回去。注意覆盖安装之后如果将来用 IDE 自带的更新机制升级NL jar 会被当成“未知来源的插件”处理升级过程可能报校验失败。这也是我不推荐覆盖的原因之一。三种方式的取舍可以这么记只做一次、机器就一台links要批量刷十几台开发机links 加共享路径最省事试水阶段怕搞坏环境dropins 加-clean前两种都被环境卡住才上覆盖并且先备份。4. 启动参数与缓存让汉化真正生效的那几个开关包放对了参数没配对界面照样是英文。这一步是纯配置活但细节密度很高尤其是 ini 文件的参数顺序。4.1 ini 文件认哪个myeclipse.ini 和 eclipse.ini 不是一回事MyEclipse 10 的安装根目录下启动器是myeclipse.exe它读的是同目录的myeclipse.ini。有些人的目录里同时存在eclipse.ini可能是从别的 Eclipse 拷贝过来的或者旧版本残留改了半天没反应就是改错了文件。判断方法很简单myeclipse.ini的第一行通常是-startup紧跟着的--launcher.library指向Common\plugins下的 launcher 插件路径里带Common就对了。一个可用的myeclipse.ini关键片段长这样-startup ../Common/plugins/org.eclipse.equinox.launcher_1.2.0.v20110502.jar --launcher.library ../Common/plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.100.v20110502 -vm C:/Java/jdk1.6.0_45/bin/javaw.exe -nl zh_CN -vmargs -Xms256m -Xmx1024m -XX:MaxPermSize256m -Duser.languagezh -Duser.countryCN参数顺序是硬约束-nl属于启动器参数必须写在-vmargs之前-vmargs之后的所有内容都会原样传给 JVM这时候再写-nl就没用了JVM 不认识它会直接忽略。这个顺序错位导致的“汉化不生效”占了我在群里见到的故障的一半以上。-Duser.languagezh和-Duser.countryCN是给 JVM 的默认 Locale 兜底主要影响日期、数字格式以及部分没读-nl的第三方插件。加上没坏处但别指望它单独就能把界面变中文。4.2 -clean 的时机什么时候必须加加几次-clean的作用是清掉configuration目录下的 OSGi 缓存强制重新扫描所有 bundle。它和汉化的关系是只要你动过plugins、features、dropins、links里的任何一处旧缓存里的 bundle 清单就和实际文件对不上了必须-clean一次重建。判断要不要加我一般看两件事场景要不要 -clean说明首次安装语言包要重建 bundle 清单登记 NL fragment修改.link文件的 path要路径变了旧清单失效只改 ini 里的-nl值要Locale 变化需要重新解析 fragment日常启动不要每次加会拖慢启动十几秒起步换工作空间不要工作空间和 bundle 缓存是两回事还有个细节-clean在 Eclipse 3.7 上只清一次就够第二次启动不要带否则每次启动都在重建缓存。有些教程让你常驻-clean那是把启动速度当儿戏血泪经验是别学。4.3 验证汉化生效的四个检查点别只看菜单。四个检查点按可信度从低到高排主菜单文件 / 编辑 / 窗口 / 帮助变中文。最直观但也最容易被“半汉化”骗过去。首选项页窗口 → 首选项左侧树的中文覆盖率。这里如果只有顶层是中文、展开后全是英文说明plugins级 NL 缺了一部分。安装详细信息帮助 → 关于 MyEclipse → 安装详细信息 → 插件搜nl_zh_CN。能列出条目说明 fragment 被 OSGi 认了这是最硬的证据。bundles.info打开configuration\org.eclipse.equinox.simpleconfigurator\bundles.info搜nl_zh_CN。有记录 已登记没记录 加载链路断了回去查 dropins 层级或.link路径。这四个点如果只有 1 通过、3 和 4 都不通过说明你看到的中文其实是某个插件的内置翻译不是你装的语言包在起作用别高兴太早。5. 排查与避坑汉化后启动失败、半中半英的五个现场下面五条都是我在老机器上真实遇到过的按“现象 → 原因 → 解决”写遇到同款可以直接对号入座。5.1 改了 ini 重启毫无变化菜单依旧英文现象按教程在eclipse.ini里加了-nl zh_CN重启多次界面纹丝不动。原因启动器读的是同目录的myeclipse.inieclipse.ini根本没被加载或者你把-nl写到了-vmargs后面被当成 JVM 参数吞掉了。解决确认myeclipse.ini里-startup段的路径含Common把-nl和zh_CN移到-vmargs之前然后带-clean启动一次。改完先别急着看菜单去bundles.info里搜一下有没有 NL 记录那才是准信号。5.2 启动卡在 splash或者起来后直接闪退现象加完语言包双击myeclipse.exe进度条走到一半停住或者窗口一闪就没了。原因语言包的版本和底座不匹配。典型是拿了 3.6 的包往 3.7.2 上怼NL fragment 声明了对某个宿主版本的依赖OSGi 解析依赖失败启动链在早期就断了。解决先看工作空间\.metadata\.log搜MissingResourceException或Could not resolve module日志里会明确写出是哪个 bundle 解析失败。确认是版本问题后把语言包整个撤掉dropins 直接删目录、links 就改.link后缀、覆盖安装就还原备份换成与底座完全一致的版本再试。不要试图靠删几个 jar “修”版本问题那是在给自己挖坑。5.3 菜单中文了但 MyEclipse 特有的面板全是英文现象文件 / 编辑是中文切到 MyEclipse 透视图服务器连接器、部署面板、数据库浏览器全是英文。原因这不是故障。MyEclipse 自有插件是商业组件官方语言包里不包含它们的 NL fragment社区翻译项目也极少覆盖。汉化的边界就在 Eclipse 底座这一层。解决接受这个边界或者只对高频菜单做局部汉化自己写 NL fragment 不现实工作量大且随版本失效。另外检查一下是不是只拷了plugins没拷features那种情况下“帮助 → 关于”里的特性描述会残留英文容易和上面这种正常现象混淆。5.4 首次启动没反应第二次启动突然变中文了现象装完语言包第一次启动界面英文什么都没改第二天再开变中文了。原因dropins 或 links 的 bundle 扫描发生在启动流程靠后的阶段第一次启动只是把新 bundle 登记进bundles.info真正挂载要等下一次启动。这就是“首次不生效”的机制。解决装完立刻带-clean启动一次然后再正常启动一次一次搞定省掉一天的困惑。反过来说如果你遇到“怎么都不生效”先确认是不是每次都只启动了一次就放弃了。5.5 汉化之后项目里的中文注释和字符串全变乱码现象界面中文了打开原有项目Java 文件里的中文注释变成一堆问号或方块控制台输出也是乱码。原因和汉化包没关系。-nl zh_CN只影响界面 Locale工作空间的文本编码是另一套设置。老项目多半是 GBK而新工作空间默认跟随系统或 UTF-8一错位就乱码。解决窗口 → 首选项 → 常规 → 工作空间把“文本文件编码”显式设成项目实际用的编码GBK 或 UTF-8单个项目还可以在项目属性里覆盖。同时检查 ini 里有没有多余的-Dfile.encoding有的话统一成和项目一致的值。这一条最容易背锅给汉化包其实改两行设置就好了。6. 进阶做一个中英文一键切换的启动脚本维护老项目的时候我经常需要在中英文之间来回切自己看中文舒服但截图给外部对接方、或者排查某个只记得英文名的菜单项时又得切回英文。手工改.link后缀、带-clean、再启动一天折腾几遍谁都烦。所以我把这套动作固化成了一个批处理放在桌面双击就切。思路是语言包目录保持不动只改links\zh_CN.link的启用状态然后自动带-clean启动一次 IDE。脚本里用两个标记文件判断当前状态避免重复切换。echo off setlocal enabledelayedexpansion REM 按实际安装路径修改 set IDE_HOMED:\MyEclipse\MyEclipse 10 set LINK_FILE%IDE_HOME%\links\zh_CN.link set FLAG%IDE_HOME%\links\.lang_state if not exist %LINK_FILE% ( echo [ERROR] link file not found: %LINK_FILE% exit /b 1 ) set STATEen if exist %FLAG% set /p STATE%FLAG% if /i %STATE%zh ( REM 当前中文切英文改名禁用 link清状态 ren %LINK_FILE% zh_CN.link.off del /q %FLAG% 2nul echo switched to EN ) else ( REM 当前英文切中文恢复 link写状态 if exist %LINK_FILE%.off ren %LINK_FILE%.off zh_CN.link echo zh%FLAG% echo switched to ZH ) REM 带 -clean 启动一次重建 bundle 清单 start %IDE_HOME%\myeclipse.exe -clean endlocal脚本里有几个点值得说明。setlocal enabledelayedexpansion是为循环和变量展开准备的这个场景其实用不上但养成习惯没坏处。ren改后缀这一步是关键Eclipse 只认.link结尾的文件.link.off会被忽略等于软禁用语言包本体一个字节都没动随时能切回来。-clean通过命令行传比改 ini 更灵活用完就没了不会让每次启动都背着这个包袱。状态判断用的是一个标记文件.lang_state里面写zh表示当前是中文态。这个做法有点土但比去解析bundles.info稳得多——后者在异常退出时可能写不完整反而误判。第一次运行时标记文件不存在脚本默认走英文态会把.link恢复回来这个行为是符合直觉的。如果你机器上装了好几套环境这个脚本稍微改改就能复用把IDE_HOME抽成参数外面套一层菜单一个脚本管三四个安装目录。我一般还会在脚本末尾加一行timeout /t 3避免窗口一闪而过看不到输出。提示切换之后如果发现 IDE 启动报 bundle 冲突先别怀疑脚本去links目录看看是不是残留了.link.off和.link同时存在的情况。ren在目标文件已存在时会失败脚本里没做覆盖保护这是唯一需要人工确认的点。从那以后我每次装完语言包都会先把 ini 参数顺序、bundles.info里的 NL 记录、links目录的实际状态这三样强制过一遍再谈“汉化成功”。这三处任何一处没对上界面上的中文都只是巧合。希望帮到你。本文还有配套的精品资源点击获取