Cursor 汉化不生效、半中半英,常见问题一次排查清楚

Cursor 汉化翻车的人不少,而且翻车的样子五花八门:装了语言包没反应、界面半中半英、切了中文结果更乱。这些情况看着像同一个毛病,其实各有各的原因。下面几种对照着查,比瞎试强。

Cursor汉化报错排查

最冤的一种,是改了设置没生效。很多人图省事,直接去设置里搜 Language,改完就关窗口,结果没变化。问题出在没彻底退出。Cursor 右下角如果还有图标在托盘里,光关窗口不算退。得从菜单里选 Exit 彻底退出,再重新打开,语言才切得过来。

第二种,扩展商店搜 Chinese 啥也没有。这种情况大多是扩展面板没加载完。刚启动的时候你搜得太快,列表还在后台刷,出来的就是空。等一两秒再搜一次,或者重启 Cursor。要是重启了还搜不到,可以手动下一个语言包的 VSIX 文件,在扩展面板右上角选 Install from VSIX,按路径装上。这里得提醒一句,VSIX 最好从 VS Code 官方市场下,别去不明来路的网站。

第三种,手动改 settings.json 把 locale 写错了。这是最隐蔽的。正确的写法是 “locale”: “zh-cn”,注意是小写、带横杠。有人写成 “locale”: “zh”(没指定地区),有人写成 “locale”: “zh-CN”(大小写不对,这里得小写)。写错了,语言包加载不出来,界面就是英文。改完想验证,可以在命令面板执行 Developer: Toggle Developer Tools,打开控制台看有没有输出 [i18n] locale set to zh-cn。

第四种,全局设了中文,可某个项目打开还是英文。这多半是那个项目的配置把全局盖掉了。项目根目录下可能有个 .vscode/settings.json,里面写了 “locale”: “en-us” 之类的强制覆盖。验证办法很简单:关掉当前项目,开个空文件夹,看界面是不是中文。是的话,就是项目配置在作怪,去把那个 locale 字段删掉或者改成 zh-cn。

第五种,半中半英。前面说过,这是正常的,语言包盖不全 Cursor 自己加的那些 AI 功能。不用管它。

还有一种要单独提的,版本升级惹的祸。Cursor 从 0.45 版本开始改了国际化机制,早期那些第三方汉化插件在这个版本之后基本都失效了,装了不但没用,还可能跟新版本冲突,界面渲染出问题。所以别迷信第三方汉化包,官方语言包用着最稳。

一句话总结:先确认退干净了,再确认 locale 写对是小写 zh-cn,再查项目配置有没有覆盖,最后别用老第三方插件。这四步走完,绝大多数「汉化失败」都能找到原因。