Cursor 的界面汉化是个反复被问起的需求。虽然官方在 Chat 设置里提供了语言选项但那只影响 AI 回话内容整个 IDE 的菜单、设置页、右键菜单依旧是英文。在迭代了几个版本后我直接做了一个一键中文汉化工具重点解决“设置菜单汉化”这个硬骨头。它能够自动定位安装目录、备份原始资源、解包、替换中文语言映射、清理缓存并在数秒内让 Cursor 的界面焕然一新。整个过程不需要安装额外的全局工具脚本本身就只有一百多行架在 Python 和 Node 之上。遇到新版升级后重新跑一次就能恢复汉化。如果你是重度用户或者想分享给不会配环境的同事这篇文章应该能帮上忙。1. 整体设计与方案拆解1.1 为什么 Cursor 没有官方中文界面Cursor 基于 Electron 架构本质上是一个深度定制的 VS Code 分支。Electron 应用通常都内置了 i18n 能力VS Code 本体可以在“语言”设置里一键切换成简体中文。但 Cursor 官方目前的策略很保守默认只保留英文界面很多社区用户希望官方开放更多语言包官方路线图里也一直把这个需求排在后面。更直接的原因是Cursor 的核心功能区域包括设置菜单、命令面板、资源管理器右键菜单大多使用了自研组件和 VS Code 原生的语言机制并不完全兼容。比如“设置”页顶部那一排分组标签以及 AI 模型供应商相关的配置项都是 Cursor 自己用 TypeScript 写的并没有内置完整的中文 nls 文件。就算你在 config 里强行设置locale:zh-cn也会发现只有部分系统提示词变中文设置菜单里的“Appearance”“General”“AI”这些标题全部纹丝不动。所以汉化的关键不在“改设置”而在“改资源”。1.2 汉化方案选型三种路线对比我在动手之前把能想到的三条路线都试过一遍先列个表格对比会更直观方案原理优点缺点修改 Cursor 内置 locale 配置在 settings.json 或命令参数中强制--localezh-cn操作简单适合新手只能影响官方支持的多语言字符串设置菜单依旧英文手动替换 app.asar通过 asar 工具解包安装目录里的resources/app.asar找到英文字符串并替换成中文汉化彻底能覆盖菜单和设置项需要每一步手动操作容易打错命令升级后失效一键汉化工具自动完成版本检测、资源备份、解包、字符串映射、重打包、缓存清理可重复执行升级后几秒钟恢复汉化需要信任脚本来源杀毒软件可能误报最后我选择做“一键汉化工具”而不是“纯手动替换”原因是 Cursor 更新频率太高。它任何时候都可能在后台触发自动更新一旦 app.asar 被覆盖手动汉化流程就得重来一遍。如果写成脚本更新后双击运行一次就能完事后面即使升级也不慌。1.3 一键工具的整体模块划分这个工具内部其实分成了五个模块写代码之前先把边界划定清楚后面接新版的时候会省很多心版本检测模块读取 Cursor 的package.json版本号确保翻译映射表和当前版本匹配。备份模块在汉化前把原始app.asar完整复制到备份目录所有还原操作都依赖这份备份。解包与重打包模块调用 asar 库把归档文件解压到临时目录替换完成后重新打包回原位置。翻译映射模块用一个独立的zh_CN.json文件维护原文到译文的对照关系这个文件就是汉化工具的核心资产。缓存清理模块删除 Electron 应用的用户缓存目录里与代码缓存相关的文件这一步直接决定汉化后是否能看到完整效果。模块划分清楚之后维护成本会低很多。尤其翻译映射模块后续 Cursor 每出一个新版本只需要跑一个 diff 脚本把新增英文词条补上就行不需要回到主流程里翻逻辑。2. 核心实现与实操要点2.1 安装目录与关键资源定位要汉化 Cursor第一步是找到它到底装在哪儿以及核心文件长什么样。不同操作系统路径不一样我自己主要维护的是 Windows 和 macOS 两条路径Windows%LocalAppData%\Programs\cursor\resources\app.asarmacOS/Applications/Cursor.app/Contents/Resources/app.asarLinux/opt/Cursor/resources/app.asar注意 Windows 下 Cursor 默认安装路径不在Program Files而在%LocalAppData%这一定程度避开了管理员权限冲突。但如果你在安装时选择了“安装到所有用户”安装目录可能在C:\Program Files\Cursor那么运行汉化工具时需要右键以管理员身份运行否则没有写入resources目录的权限。确定文件路径后我还需要确认两个附加目录app.asar.unpacked包含原生二进制模块一般不用动但重打包时必须保证它不被破坏。用户数据目录Windows 下在%AppData%\Cursor缓存清理主要作用于此。实际脚本里我不会硬编码路径而是通过进程信息动态获取。先用os.popen或psutil找到 Cursor 可执行文件的完整路径再得出resources目录。思路很简单Cursor 进程名是Cursor.exe在运行状态下通过进程路径定位比写死一个路径通用不少。2.2 认识 app.asar 和文本资源格式Electron 应用不像传统 C/S 软件那样把界面文本放在外部语言包目录它把大部分业务代码打包进一个类似 JSON 容器的归档文件app.asar。这个格式本身是公开的官方提供了electron/asar命令行工具可以像 tar 一样对它做解包和重打包。汉化工具的核心操作就是解包app.asar。在解包后的 JS 文件中定位英文 UI 字符串。将字符串替换为对应中文。重新打包。听起来像“找文本替换文本”但实际没那么轻松。Cursor 里的字符串不是全放在一个messages.json里而是散落在不同的 bundle 文件例如out/vs/workbench/workbench.desktop.main.js中嵌入了大量命令面板和菜单文本。out/vs/nls.bundle.zh-cn.js是 VS Code 体系自带的简体中文本地化包正常情况下已经存在。Cursor 自研功能区的字符串则有独立文件比如 settings 相关的 renderer 模块。所以汉化工具需要扫描解包目录中所有.js文件提取匹配的英文字符串再根据映射表替换。如果直接对整个文件做正则替换很容易误伤代码逻辑因为有些英文字符串同时也是变量名或函数参数。我的解决方案是只替换“字符串字面量”即引号内部的文本并且只替换那些在映射表里存在的 key。这样能最大程度避免改动 JS 语法结构。2.3 设置菜单汉化的关键文件“包括设置菜单汉化”这句话是这个标题的核心因为设置菜单本身就是汉化难度最高的区域。它不像文件菜单只有“File”“Edit”“Selection”几条设置页里包括了搜索框、分组标题、JSON 编辑器字段、快捷键按钮提示等大量文本。实际操作时我重点盯住了这几块设置页左侧栏的顶级分类General、Appearance、AI、Code Intelligence、Editor、Extensions、Privacy、Account、Update。每个分类下的子项标题和描述例如 “AI Model”“Provider”“API Key”“Auto Reconnect” 等。设置搜索框里用来匹配的词条这部分如果漏掉用户搜索中文字关键词会搜不到对应设置项。这些文本并不在同一个文件里有的在workbench.desktop.main.js有的在settings.renderer.js还有的在 Cursor 自己的extension模块中。我的映射表会按照“文件相对路径”分组维护每条翻译带上所属文件路径。这样工具执行替换时只处理对应的文件既避免全量扫描带来偶发错误也方便排查“某个菜单项为什么没汉化”。2.4 中文映射表的维护方法映射表是汉化工具的灵魂。我给工具配了一个zh_CN.json结构大致长这样{ Appearance: 外观, General: 常规, AI: 人工智能, Code Intelligence: 代码智能, Auto Reconnect: 自动重连, Show Chat: 显示聊天面板, Font Size: 字体大小, ... }这个映射表看起来简单但维护起来有几个坑占位符不能吞掉。有些英文文本是Open {0}这种格式{0}是运行时的动态占位符翻译成中文时必须保留{0}比如打开 {0}。快捷键提示不能乱改。Copy (⌘C)这类文本中文应该是复制 (⌘C)快捷键符号保持不变。上下文不同翻译不同。同一个单词 “Model” 在 AI 设置页里翻译成“模型”但在文件对比场景里可能指“模式”。映射表只做精确匹配不搞“模糊替换”避免张冠李戴。不同版本不要混用映射表。我用版本号对映射表做目录隔离例如mappings/v0.42.2.json因为 Cursor 更新频繁上一版的 key 在下一版可能就不存在了。每次新版本发布后我会先跑一遍英文提取脚本生成一个全新的en.json临时文件再用 diff 工具和现有zh_CN.json做比对找出新增和删除的条目补完翻译后再发布一键工具新版本。这套流程基本可以把维护时间压缩在十分钟以内。3. 一键汉化工具实操过程3.1 准备环境工具有一点环境要求但门槛很低。我是在 Windows 10 / macOS 13 上测试的都需要 Python 3.9 以上和 Node.js 16 以上。Python 用来写自动化主流程Node.js 则用来调用 asar 工具。因为electron/asar是一个 npm 包可以通过npx直接执行不需要全局安装到系统目录。为了减少依赖我没有用重量级的 GUI 框架而是直接用命令行交互。用户下载工具包后在项目目录下执行pip install -r requirements.txt npm init -y npm install electron/asar --save-dev如果你的电脑上没有 Node.js也可以把electron/asar打包成一个独立的.exe工具放到脚本同目录。但考虑到多数写代码的读者电脑里都有 Node 环境直接用 npx 省事不少。3.2 核心脚本源码解析我先给一个简化但能跑通的核心脚本框架让大家看看主体逻辑长什么样。实际项目里我会增加异常处理和日志输出但核心骨架是稳定的。import json import os import shutil import subprocess import tempfile from pathlib import Path def find_cursor_resources(): candidates [ Path(os.environ.get(LOCALAPPDATA, )) / Programs / cursor / resources, Path(/Applications/Cursor.app/Contents/Resources), Path(/opt/Cursor/resources), ] for path in candidates: if path.exists(): return path raise FileNotFoundError(未找到 Cursor 安装目录) def backup_asar(resources_dir, backup_dir): src resources_dir / app.asar dst backup_dir / app.asar.bak shutil.copy2(src, dst) print(f备份完成: {dst}) def unpack_asar(resources_dir, work_dir): asar_path resources_dir / app.asar subprocess.run([npx, electron/asar, extract, str(asar_path), str(work_dir)], checkTrue) def apply_translations(work_dir, mapping_file): with open(mapping_file, r, encodingutf-8) as f: mapping json.load(f) for root, _, files in os.walk(work_dir): for name in files: if not name.endswith(.js): continue filepath Path(root) / name content filepath.read_text(encodingutf-8, errorsignore) original content for en, zh in mapping.items(): content content.replace(f{en}, f{zh}) if content ! original: filepath.write_text(content, encodingutf-8) print(f已更新: {filepath.name}) def repack_asar(work_dir, resources_dir): subprocess.run( [npx, electron/asar, pack, str(work_dir), str(resources_dir / app.asar)], checkTrue, ) def clear_cache(): cache_dir Path(os.environ.get(APPDATA, )) / Cursor / Cache if cache_dir.exists(): shutil.rmtree(cache_dir, ignore_errorsTrue) print(缓存已清理) def main(): resources_dir find_cursor_resources() backup_dir Path(backups) backup_dir.mkdir(exist_okTrue) backup_asar(resources_dir, backup_dir) with tempfile.TemporaryDirectory() as tmp: work_dir Path(tmp) unpack_asar(resources_dir, work_dir) apply_translations(work_dir, zh_CN.json) repack_asar(work_dir, resources_dir) clear_cache() print(汉化完成请重启 Cursor) if __name__ __main__: main()这段代码里比较关键的是apply_translations函数中的content.replace(f{en}, f{zh})。之所以用带引号的替换是因为我必须确保它只替换字符串字面量而不是嵌入在变量名或函数调用里的字符。例如General这个单词除了可能出现在菜单里还可能作为 JS 变量名的一部分带引号替换会降低误替换概率。虽然这种策略还是有一点漏网之鱼比如模板字符串中出现的英文但最后通过人工查看覆盖基本都能补上。另一个细节是clear_cache。Electron 应用会缓存 JavaScript 编译结果即使你替换了 asar 里的 JS 文件缓存不清理的话界面很可能还是老样子。这个环节经常被忽略但它对汉化是否生效有决定性影响。3.3 执行步骤和验证整个工具的执流程其实简单到不需要做太多交互我习惯按下面这个顺序跑先关闭所有 Cursor 窗口和后台进程。确认脚本目录下有zh_CN.json和main.py。在终端运行python main.py。等待输出里的“备份完成”“汉化完成”提示。重新打开 Cursor。这里要特别强调如果 Cursor 正在运行脚本虽然能修改 asar 文件但重新打开时会因为进程锁或内存中的旧缓存出现异常。所以我会在脚本开头加一段进程检测发现Cursor.exe在运行就直接提示用户退杀而不是强行继续。打开 Cursor 之后我建议按下面这张表逐项检查验证区域检查内容预期结果顶部菜单栏File / Edit / View / Go / Run / Terminal / Help文件 / 编辑 / 视图 / 转到 / 运行 / 终端 / 帮助设置菜单General / Appearance / AI / Extensions常规 / 外观 / 人工智能 / 扩展设置搜索框输入“自动重连”等中文词能搜到对应设置项右键菜单在代码区右键Copy / Paste / Go to Definition 均变中文命令面板按 CtrlShiftP 输入“设置”出现中文命令条目如果某一项没汉化大概率是那几个字符串没有命中映射表这个时候就需要用到后面我会讲的排查方法。3.4 还原英文界面和汉化同样重要的是“原样还原”。因为有些朋友可能使用一段时间后觉得英文界面更稳或者新版本 Cursor 出了语言问题想回到官方原版。我的工具里带了restore.py逻辑也很直接把汉化前的备份文件复制回resources/app.asar再清一次缓存。import shutil from pathlib import Path resources_dir Path(os.environ[LOCALAPPDATA]) / Programs / cursor / resources backup_path Path(backups) / app.asar.bak target resources_dir / app.asar shutil.copy2(backup_path, target) print(已还原英文界面请重启 Cursor)不建议直接卸载重装 Cursor。卸载重装虽然也能回到英文但会丢失本地的登录状态、插件配置和快捷键设置代价有点大。备份还原则只替换程序资源用户数据不动无副作用。4. 常见问题与排查技巧实录4.1 汉化后无法启动先别慌多半是 asar 重打包问题我最早在测试脚本时遇到过几次汉化后 Cursor 根本打不开、启动后立刻闪退的情况。排查下来发现原因主要集中在这三类asar 重打包时没有保留原文件的权限属性。electron/asar的 pack 操作默认会读取文件的权限但如果你在 Windows 上把解包目录放到临时目录再跨文件系统复制偶尔会丢失特殊权限。替换时误伤了非字符串代码。如果映射表的 key 出现单引号和双引号格式不一致比如原文件里是单引号字符串而映射表用双引号去替换就会导致 JS 语法错误。缓存没有清干净。有些版本的 Cursor 除了Cache目录还会在Code Cache、GPUCache里存缓存只删一个目录不彻底。遇到闪退最稳妥的恢复方式就是执行restore.py回滚备份。回滚后如果没有异常再把映射表检查一遍确认没有破坏 JS 语法再重新跑汉化。这一步提醒我任何汉化工具都必须内置自动备份和快速回滚否则用户拿到手只会有不安全感。4.2 部分菜单还是英文映射表覆盖度不够汉化后最常被问的问题是“为什么我有些菜单还是英文”。原因通常很直接那份菜单对应关键词没有加到zh_CN.json里。每次 Cursor 更新后都会新增或调整界面文本我应该针对新版重新提取英文词条。排查方法也比较简单打开英文原版界面截图记下未汉化的英文文本。在解包后的 JS 文件里搜索该文本确认它在哪个文件、哪个字符串位置。把它加入到映射表对应分组里重新执行汉化。我实际使用中发现右键菜单里的 “Paste” 偶尔会漏掉原因是它同时出现在多个 JS bundle 中有的 bundle 文件名带min映射表只处理了部分路径。后来我把映射表从“按字符串查”改成“按文件路径分组 字符串查”漏翻译的情况明显减少。4.3 更新后汉化失效让工具接管更新闭环Cursor 的自动更新机制会在后台下载新版本然后在进程重启时替换自身文件。这一行为对汉化工具来说是“破坏性”的——新版本把 app.asar 还原成官方英文之前做的汉化全部失效。为了解决这个问题我的建议不是关闭自动更新而是让汉化工具成为更新流程的一部分。具体做法是在系统计划任务里加一条定时脚本每天检查 Cursor 安装目录的文件修改时间。如果发现app.asar已被替换或内容哈希发生变化自动执行汉化主流程。如果汉化失败自动调用还原脚本至少保证 Cursor 能用。我更推荐的方式是让用户先主动更新 Cursor 到最新版然后手动跑一次一键汉化。等稳定的新版本出现工具同步发布匹配的映射表这时候再汉化兼容性最好。4.4 杀毒软件误报与安全提示这个项目在传播过程中最麻烦的不是技术问题而是 Windows Defender 和第三方杀毒软件经常把汉化工具的可执行文件判定为风险程序。原因可以理解工具会修改 Electron 应用的资源文件行为特征和某些补丁工具类似。我做了几件事来降低误报率开源脚本不发布闭源编译的 exe用户可以自行查看代码逻辑。在脚本里只做文本替换不涉及内存注入、钩子、调试器附加这些可疑行为。在 README 里明确告诉用户运行前需要自行确认备份谨慎使用来源不明的打包版工具。如果你是普通用户我建议优先运行 Python 脚本而不是下载别人编译好的 exe。至少源代码摆在那里每一行替换了什么都能看到心里更有底。4.5 权限、路径和中文路径问题在 Windows 上%LocalAppData%路径下一般没有权限问题。但如果你使用便携版或者绿色版 Cursor安装目录可能被放在有管理员保护和写入限制的位置比如C:\Program Files\Cursor这时汉化脚本会报 “Access Denied”。解决办法是右键“以管理员身份运行命令提示符”再运行脚本。还有就是不要把汉化工具和解压临时目录放在含中文或空格的路径下执行。虽然 Python 本身支持 Unicode 路径但 Node 的 asar 工具在部分版本下对中文路径处理不够友好很可能报路径编码错误。我遇到过一次后来统一用C:/Users/public/tools这种纯英文路径问题立刻消失了。5. 一些额外的维护心得汉化工具做出来之后很长一段时间我都在迭代“映射表更新”这件事。最开始的版本是等 Cursor 发版之后手动对比字符串后来发现一个更省力的办法把英文版本的app.asar解包后跑一边字符串提取再和当前映射表做一个 diff新增英文串会非常明显。这样每次官方发版我一小时内就能发布适配新版的汉化包。我建议想要长期维护汉化工具的朋友把下面这几件小事也纳入自己的流程维护一个CHANGELOG.md记录每个版本映射表新增和修改的词条。在映射表里给每个 key 加备注标明它出现的文件路径和上下文。定期对比原版英文界面和汉化后的截图防止实际界面文本发生变化但映射表没跟上。把整个工具上传到 GitHub 或 Gitee 私有仓库方便自己多台设备同步同时保留历史提交记录出问题可以快速回退。最后再分享一个小技巧如果只是想临时应急不需要完整汉化设置菜单可以先用 VS Code 官方简体中文包的思路把 Cursor 用户目录下的locale.json临时改成locale: zh-cn。虽然覆盖不完整但至少文件菜单、帮助菜单里的一部分内容会变成中文。等真正有空了再回来用完整汉化工具做一次彻底替换。我自己现在的主机上都保留了这两个方案平时用完整汉化遇到 Cursor 刚更新还没适配映射表时就切到内置 zh-cn 应急互不冲突。