1. 为什么我要写这份汉化教程Google Antigravity 是 Google 近期推出的一款 AI 驱动的集成开发环境主打“代理优先”的开发体验内置了基于 Gemini 模型的智能体可以自主规划任务、操作编辑器、运行终端命令甚至控制浏览器完成端到端的开发流程。对于长期关注 AI 编程工具的开发者来说这东西一出来就吸引了不少眼球。但问题也很明显——它目前只有英文界面对英文不太熟练的开发者来说上手门槛一下子就拉高了。我自己第一次打开 Antigravity 的时候满屏的英文菜单和设置项确实让人有点头大。虽然日常看英文文档没什么大问题但在高频操作中母语界面的效率优势是实打实的。于是我就琢磨着能不能把它汉化一下。搜了一圈发现网上关于 Antigravity 汉化的内容非常零散要么是只言片语要么是步骤跳跃太大对新手极不友好。所以我把整个汉化过程完整记录下来写成了这份教程。这份教程适合什么人看如果你是刚接触 Antigravity 的新手英文界面让你感到不适应想把它变成中文界面来降低操作门槛那这份内容就是为你准备的。如果你已经用了一段时间但一直忍着英文界面也可以跟着操作一遍整个过程大概十分钟就能搞定。需要说明的是Antigravity 本身是基于 Electron 框架构建的桌面应用它的汉化思路和 VS Code、Cursor 这类工具非常相似所以如果你之前有过类似工具的汉化经验这篇内容对你来说会更容易理解。在正式开始之前先交代一下我的操作环境操作系统是 Windows 11 专业版Antigravity 版本是当时最新的稳定版。不同版本之间文件结构可能有细微差异但核心思路是一致的。另外汉化本质上是对软件资源文件的替换或修改操作前建议先备份原始文件这一点后面会详细说。2. 汉化前的准备工作与核心原理2.1 先搞清楚 Antigravity 的界面是怎么渲染的Antigravity 和 VS Code 一样都是基于 Electron 构建的。Electron 的本质是把 Chromium 浏览器内核和 Node.js 运行时打包在一起用前端技术HTML、CSS、JavaScript来构建桌面应用的界面。这意味着它的界面文本并不是编译进二进制文件里的而是以资源文件的形式存在于安装目录中。具体来说Antigravity 的界面文本主要分布在两个地方一是主进程相关的菜单和对话框文本通常以 JSON 或 JavaScript 模块的形式存在二是渲染进程中的界面文本这部分可能被打包在 JavaScript 文件里也可能通过语言包的方式加载。VS Code 系工具通常使用package.nls.json和nls.messages.json这类文件来管理界面文本的本地化Antigravity 大概率也沿用了类似的机制。注意Antigravity 作为较新的工具其本地化机制可能和 VS Code 有差异。下面的操作基于我对 Electron 应用汉化的通用经验结合 Antigravity 的实际文件结构进行说明。如果你在操作中发现路径或文件名不一致以实际为准。2.2 汉化的两条路线语言包替换 vs 直接修改资源文件汉化 Electron 应用通常有两条路可走。第一条是找到官方或社区维护的语言包直接替换或加载。VS Code 就有官方中文语言包通过扩展市场安装即可。但 Antigravity 目前没有官方中文语言包社区语言包也还没成熟所以这条路暂时走不通。第二条路是直接修改应用安装目录下的资源文件。具体做法是找到包含英文界面文本的文件把其中的英文替换成中文然后让应用重新加载这些文件。这种方式的优点是直接有效不依赖第三方语言包的更新缺点是每次应用升级后可能需要重新操作而且如果修改不当可能导致应用无法启动。我选择的是第二条路因为它是目前最可行的方案。下面详细说说具体怎么操作。2.3 操作前必须做的两件事第一件事是备份。在修改任何文件之前先把整个resources目录复制一份到安全位置。这样即使改错了也能快速恢复。我一般会在同目录下创建一个resources_backup文件夹把原始文件完整拷贝进去。第二件事是确认 Antigravity 的安装路径。Windows 上默认安装在C:\Users\你的用户名\AppData\Local\Programs\Antigravity下但如果你安装时改了路径就需要去实际位置找。macOS 上通常在/Applications/Antigravity.app/Contents/Resources下。Linux 用户一般在/opt/Antigravity/resources或~/.local/share/Antigravity下。找到安装目录后重点关注resources文件夹里面通常有app子目录再往里是out目录界面资源文件就在这里面。3. 手把手实操从定位文件到完成汉化3.1 定位核心资源文件打开 Antigravity 的安装目录进入resources/app/out文件夹。你会看到一堆 JavaScript 文件和子目录。界面文本通常藏在以下几个位置vs/code/electron-main目录下主进程相关的菜单文本vs/workbench目录下工作台界面的文本nls.messages.json或类似名称的文件本地化消息映射我实际查看后发现Antigravity 的界面文本主要集中在vs/workbench/workbench.desktop.main.js这个打包后的文件里以及vs/code/electron-main/main.js中。这些文件是压缩过的直接搜索英文关键词可能会比较困难但用编辑器的搜索功能还是能找到的。提示推荐用 VS Code 或 Notepad 打开这些文件它们对大文件的支持比较好搜索速度也快。不要用系统自带的记事本打开大文件容易卡死。3.2 搜索并替换界面文本以workbench.desktop.main.js为例用编辑器打开后按CtrlF搜索常见的界面词汇比如 “File”、“Edit”、“View”、“Settings”、“Extensions” 等。你会看到这些词出现在类似这样的代码结构中{id:file,label:File,title:File,description:File Menu}这里的label和title就是界面上显示的文本。把File改成文件Edit改成编辑以此类推。注意只改引号内的文本不要动id字段因为id是程序内部用来识别菜单项的改了会导致功能异常。替换的时候有几个原则需要遵守。第一只替换界面显示文本不要替换代码逻辑中的字符串。比如if (command file.save)这种就不能动。第二注意大小写和上下文有些词在代码中既是界面文本又是逻辑标识需要根据上下文判断。第三替换后的中文要加引号保持 JSON 或 JavaScript 字符串的语法正确。我整理了一份常用界面词汇的对照表供你参考英文原文中文翻译出现位置File文件主菜单Edit编辑主菜单View视图主菜单Settings设置菜单/按钮Extensions扩展侧边栏Terminal终端菜单/面板Help帮助主菜单Search搜索侧边栏Explorer资源管理器侧边栏Run and Debug运行和调试侧边栏3.3 处理主进程菜单文本主进程的菜单文本在vs/code/electron-main/main.js或类似文件中。这部分主要控制应用顶部的菜单栏包括“文件”、“编辑”、“查看”、“窗口”、“帮助”等。搜索方式和上面一样找到对应的label字段进行替换。需要注意的是主进程的菜单文本有时候会从渲染进程动态获取也就是说你可能在main.js里改了但实际显示的还是英文。这种情况下需要回到workbench.desktop.main.js里去找对应的菜单定义。我的经验是先把渲染进程的文件改完再改主进程的文件这样能覆盖大部分场景。3.4 让修改生效文件改完后保存并关闭编辑器。然后完全退出 Antigravity注意是彻底退出不是最小化到托盘再重新启动。如果修改生效你会看到界面菜单已经变成中文了。如果重启后界面没有变化可能是以下几个原因一是文件没有保存成功检查一下文件修改时间二是 Antigravity 有缓存机制尝试清除缓存目录通常在%APPDATA%/Antigravity/Cache下三是修改的文件不是实际加载的文件可能需要检查是否有多个版本的资源文件。注意如果修改后 Antigravity 无法启动不要慌。把之前备份的resources目录恢复回去就能回到原始状态。这也是为什么我反复强调备份的重要性。4. 常见问题与排查技巧实录4.1 修改后界面部分中文部分英文这是最常见的情况。原因是 Antigravity 的界面文本分散在多个文件中你只改了其中一部分。解决办法是继续搜索其他文件把遗漏的文本补上。重点检查vs/workbench下的其他 JavaScript 文件以及vs/code/electron-main下的文件。另外有些文本可能是动态拼接的比如Open fileName这种直接搜索 “Open” 可能找不到完整的句子。这种情况下需要找到拼接的逻辑把前缀或后缀改成中文。比如把Open 改成打开 这样拼接出来的结果就是中文了。4.2 修改后应用启动报错这种情况通常是因为修改破坏了 JavaScript 语法。比如把引号删掉了或者把不该改的代码逻辑改了。解决办法是恢复备份然后重新操作这次更加小心。建议每次修改一个文件后就重启测试一下不要一次性改完所有文件再测试这样出问题了很难定位是哪个文件的问题。还有一个可能的原因是文件编码问题。Antigravity 的资源文件通常是 UTF-8 编码如果你用其他编码保存可能导致中文字符显示乱码或应用报错。确保编辑器保存时选择 UTF-8 编码。4.3 应用升级后汉化失效这是预期内的行为。Antigravity 升级时会覆盖resources目录下的文件你的修改自然就没了。解决办法有两个一是升级后重新执行一遍汉化操作二是把修改后的文件备份好升级后直接覆盖回去。我通常用第二种方法把改好的文件放在一个单独的文件夹里升级后复制粘贴就行。需要注意的是如果升级涉及界面结构的重大变化旧的中文替换可能不适用了需要重新对照新版本的文件进行调整。4.4 有没有更优雅的汉化方式直接修改资源文件虽然有效但确实不够优雅每次升级都要重新弄。更优雅的方式是做一个语言包扩展通过 Antigravity 的扩展机制加载中文语言包。VS Code 就是这么做的社区维护了官方中文语言包安装后自动生效升级也不受影响。Antigravity 目前还没有开放语言包扩展的接口但考虑到它和 VS Code 的渊源未来可能会支持。如果你不想每次都手动改文件可以关注一下社区有没有人做 Antigravity 的中文语言包。在那之前手动修改资源文件仍然是最实际的方案。4.5 常见问题速查表问题现象可能原因解决办法界面无变化文件未保存或缓存未清除检查文件修改时间清除缓存目录部分中文部分英文只改了部分文件继续搜索其他资源文件应用无法启动语法被破坏或编码错误恢复备份检查引号和编码升级后失效升级覆盖了修改重新汉化或恢复备份文件中文显示乱码文件编码不是 UTF-8用 UTF-8 编码重新保存5. 一些实操心得和后续建议整个汉化过程说起来不复杂但实际操作中还是有一些细节值得注意。我踩过的坑包括改错了id字段导致菜单点击没反应、文件保存成了 GBK 编码导致中文乱码、一次性改太多文件出问题后难以定位。这些经验教训都写在上面的内容里了希望能帮你少走弯路。另外说一个我个人的习惯我会把汉化过程中修改过的文件单独存一份放在一个叫antigravity_zh的文件夹里里面按照原始目录结构组织。这样每次 Antigravity 升级后我只需要把antigravity_zh里的文件复制到安装目录覆盖就行不用重新搜索和替换。这个习惯帮我省了不少时间。如果你对界面汉化的质量要求比较高还可以进一步优化。比如有些翻译可能不够准确你可以根据实际使用场景调整措辞。有些菜单项的翻译可能需要结合上下文来定比如 “Run” 在有些地方翻译成“运行”在有些地方可能翻译成“执行”更合适。这些细节可以根据自己的使用习惯来微调。最后提一句汉化只是手段不是目的。Antigravity 的核心价值在于它的 AI 代理能力界面语言只是使用体验的一部分。花十分钟把界面变成中文降低操作门槛然后把精力放在真正重要的开发工作上这才是汉化的意义所在。如果你在操作过程中遇到上面没覆盖到的问题欢迎在评论区交流我看到后会尽量回复。