给 Cursor 换上中文界面：这款 Cursor-chinese汉化工具值得一试

Administrator 1
自有项目

给 Cursor 换上中文界面：这款一键汉化工具值得一试

如果你在用 Cursor 写代码，大概率有过这样的体验：功能是真强大，但界面里总有那么些英文看着别扭。尤其是设置页、Agent 运行状态、工具调用、套餐用量、MCP、权限这些进阶界面，官方一直没有完整的中文支持。对英语没那么熟练的开发者来说，每次翻设置都像做一次阅读理解。

今天推荐一个解决这个痛点的开源项目——cursor-chinese，一款支持 Windows、macOS、Linux 的 Cursor 界面一键汉化工具。它通过修改 Cursor 本地安装目录中的前端资源文件，把常见英文界面文案替换成中文，还支持一键恢复英文原版。

它解决什么问题

Cursor 官方界面仍有不少英文文案，特别是设置页、Agent 运行状态、工具调用状态、套餐与用量、MCP、Hooks、权限、沙盒等区域。cursor-chinese 主要做这几件事：

  • 将 Cursor 常见英文 UI 文案替换为中文；
  • 补充新版本中遗漏或新增的英文界面；
  • 支持一键汉化和一键恢复英文原版；
  • 自动备份原始资源文件，方便回退；
  • 自动更新 product.json 校验值，尽量减少"安装已损坏"的提示；
  • macOS 下自动清理隔离属性并重新签名，减少系统拦截。

怎么用：三种方式随便挑

方式一：用预编译成品（最省事）

去 GitHub Release 下载对应你平台的压缩包，解压后直接运行：

# macOS Apple Silicon
tar -xzf cursor-chinese-macos-arm64.tar.gz
./cursor-chinese-macos-arm64

# Windows
Expand-Archive .\cursor-chinese-win-x64.zip
.\cursor-chinese-win-x64\cursor-chinese-win-x64.exe

# Linux x64
tar -xzf cursor-chinese-linux-x64.tar.gz
./cursor-chinese-linux-x64

运行后会看到交互菜单，选"一键汉化"即可，选"恢复英文"就能还原，选"退出"关闭工具。

方式二：从源码运行（更透明）

如果你不想用预编译二进制，也可以装好 Node.js 后从源码跑：

npm install
npm start          # 启动交互式菜单

# 直接指定路径静默汉化
node index.js --action=translate --cursor-path="/Applications/Cursor.app/Contents/Resources/app"

# 直接恢复英文
node index.js --action=restore --cursor-path="/Applications/Cursor.app/Contents/Resources/app"

它是怎么工作的

工具的运行逻辑其实很清晰：

  1. 定位 Cursor 安装目录（优先命令行指定，其次已保存的配置，最后自动扫描常见路径）；
  2. 定位三个核心资源文件：workbench.desktop.main.js、workbench.html、product.json；
  3. 首次运行自动备份原始文件（.backup）；
  4. 用安全词典做汉化替换——对 Read、file、Agent 这类高频词，尽量用上下文精准替换，避免误伤代码逻辑；
  5. 更新 product.json 中的校验值；
  6. macOS 下自动执行 xattr 清理和本地重新签名。

安全吗？数据会被上传吗？

这个可能是大家最关心的问题。项目的安全边界写得非常清楚：

  • 不是官方项目，只处理本机 Cursor 的应用资源文件；
  • 不修改你的账号、模型、插件、项目代码或云端配置；
  • 日常汉化流程不需要联网，也不会主动上传文件、代码或用户数据；
  • 采用 MIT 许可证 开源，放心审查；
  • 保留 .backup 备份，随时可一键恢复英文原版。

不过要提醒一句：工具会修改 Cursor 安装目录里的资源文件，使用前记得先完全退出 Cursor，并且保留好备份文件，从可信来源获取工具或自行从源码构建更稳妥。

注意事项

几个实际使用中会遇到的点，提前了解不踩坑：

  • Cursor 更新后英文会回来。官方更新会覆盖已修改的资源文件，重新运行一次汉化即可；如果新版新增了英文文案，需要等作者更新词库。
  • 提示"安装已损坏"？工具会自动更新校验值，如果仍出现，试试关闭 Cursor 重新汉化，或用"恢复英文"回退后再汉化。
  • macOS 下载后显示成"文稿"？这是裸文件丢可执行权限的常见问题，不是文件损坏，推荐下载 .tar.gz 包解压运行。
  • 汉化后没变化，先确认是否完全退出并重启了 Cursor，以及选对当前安装目录。

我的推荐理由

老实说，界面汉化这种需求"卡脖子"却很少有人做利索。cursor-chinese 打动我的几点：一是支持全平台，Windows、macOS（Intel/Apple Silicon）、Linux（x64/arm64）都有对应的预编译产物；二是安全边界清晰，本地操作、不上传数据、开源可审查、可一键还原，让人放心；三是使用门槛极低，下载解压跑一下就行，还能从源码构建更透明。

如果你经常被 Cursor 的英文界面劝退，或者想推荐给英语不好的朋友入坑 Cursor，这个工具值得一试。汉化不满意？一条命令就能恢复原版，没有后顾之忧。

项目地址：https://github.com/rongwei-lab/cursor-chinese