刚拿到 Cursor 这个 AI 编辑器的时候,最让人头疼的往往不是写代码,而是满屏的英文菜单。很多人到处搜“Cursor汉化”、“Cursor设置中文”,其实这事没有想象中复杂,无非两条路:装语言包,或者改配置文件。这篇教程就把两种简单方法给你整理清楚,顺便把中间容易踩的坑都列出来,看完照着做,三分钟就能把界面切到简体中文,所以无论你是刚下载 Cursor 的新手,还是想给团队统一配置的组长,都建议先收藏再慢慢看。
1. 为什么 Cursor 默认是英文,汉化和 VS Code 还有关系?
1.1 Cursor 和 VS Code 的关系:为什么能共用语言包
想搞清楚汉化原理,得先知道 Cursor 的“出生背景”。Cursor 本质上是一个基于 VS Code 二次开发出来的 AI 编辑器,底层的编辑器框架、扩展机制、快捷键体系,甚至很多 UI 组件都是从 VS Code 继承过来的。这就带来一个特别直接的好处:VS Code 生态里的大量扩展,Cursor 基本都能直接安装使用,其中就包括官方中文语言包。
很多人一开始不知道这一点,跑去搜“Cursor中文版下载”,反而下载到一堆来路不明的修改包。其实完全没必要,Cursor 官方版本本身就能汉化,只是界面默认显示英文而已。你只需要让 Cursor 加载一个中文语言包,或者手动告诉它“使用 zh-cn 这个语言标识”,界面就会切成简体中文。
1.2 为什么官方不默认给中文
可能有朋友会问:既然有中文语言包,为什么 Cursor 官方不默认设置成中文?这其实是个产品策略问题。Cursor 的目标用户是全球开发者,默认选择英文可以保持和代码、终端、文档的一致性,减少不同语言环境导致的显示问题。另外,编辑器这种工具,很多人用惯了英文菜单,突然切中文反而不习惯。
不过在中文开发者社区里,大家早就习惯了把 VS Code 汉化后再用,所以 Cursor 也继承了这套方案:通过扩展商店安装语言包,或者通过语言配置文件自动加载。好消息是,这两种方式 Cursor 都支持,而且操作非常简单,不需要任何代码基础。
1.3 两种汉化思路其实就在这里
简单概括一下,目前最常用的两种汉化方法分别是:
- 方法一:在扩展商店安装“中文语言包”,然后通过命令面板切换显示语言。
- 方法二:直接修改 Cursor 的 locale 配置文件,把语言标识改成
zh-cn,重启后生效。
方法一适合绝大多数人,因为它操作可视化、不容易出错;方法二适合扩展商店打不开、或者你想批量部署配置、希望一次搞定的场景。两种方法本质上都是让 Cursor 加载同一个语言资源,只是入口不同,并不存在谁比谁更“高级”的区别。
2. 方法一:扩展商店装中文语言包,全程鼠标点击
2.1 第一步:打开扩展商店,搜索 Chinese
先打开 Cursor,在左侧活动栏里找到那个类似“田字格”的扩展图标,点击它,或者直接用快捷键Ctrl+Shift+X(macOS 上按Cmd+Shift+X)呼出扩展面板。这个时候你会看到搜索框,在里面输入Chinese。
搜索结果里会出现一个名叫Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code的扩展,发布者一般是 Microsoft,图标是一个“中”字或者类似字体标识,注意别选错。这个语言包虽然是给 VS Code 做的,但 Cursor 可以直接用,相当于直接借用了 VS Code 的语言资源。
点击扩展名称进入详情页,再点右侧的Install按钮,等待几秒钟安装完成。这个过程中不用关闭 Cursor,安装完成后页面右下角通常会弹出一个提示,问你是否切换到中文,如果弹了就直接点切换,如果没有也别急,手动切换也很简单。
2.2 第二步:用命令面板把显示语言切成中文
语言包装完之后,还需要让 Cursor“激活”它。这里有个非常关键的小细节:安装语言包不等于立刻汉化,你得在命令面板里告诉 Cursor 接下来使用哪种显示语言。
按下Ctrl+Shift+P(macOS 是Cmd+Shift+P),顶部会弹出一个命令输入框,在里面输入Configure Display Language,然后回车。界面会列出一堆语言选项,找到中文(简体),或者对应的zh-cn,选中它。这时候 Cursor 通常会提示你重启编辑器,点击Restart或手动重启即可。
重启后再看一眼界面,菜单栏、设置面板、侧边栏这些地方基本都变成中文了。整个过程只需要安装一次语言包,后续如果要切回英文,还是在同一个命令面板里选择English就行,非常方便。
2.3 为什么这个方法最简单,以及我给你的额外建议
我个人最推荐方法一,原因有三个:第一,安装语言包是官方扩展机制,出错概率低;第二,以后 Cursor 更新时,语言包通常还能继续用,不需要额外维护;第三,扩展商店里还能顺便装其他中文辅助工具,比如中文拼写检查、中文代码注释翻译之类的。
不过这里有一个建议:安装语言包的时候,最好保持 Cursor 版本在最新状态。因为 Cursor 更新迭代很快,某些旧版本和最新语言包之间偶尔会有兼容性小问题,虽然大多数时候不影响使用,但为了省心,先更新到最新版再安装语言包是更稳的做法。
3. 方法二:直接改 locale 配置文件,适合开不了商店的人
3.1 找到 Cursor 的用户配置文件
有些情况下,扩展商店可能加载不出来,或者你所在团队希望统一把所有同事的 Cursor 都设置成中文,一个一个去点扩展安装太慢了,这时候直接改配置文件就是更快的方式。
Cursor 和 VS Code 一样,会把用户配置放在系统用户目录下的一个专属文件夹里。在 Windows 上,通常是这个路径:
C:\Users\你的用户名\AppData\Roaming\Cursor\UsermacOS 上一般是:
/Users/你的用户名/Library/Application Support/Cursor/UserLinux 上一般是:
/home/你的用户名/.config/Cursor/User注意,不同版本、不同操作系统可能有细微差别,但总体上都离不开Cursor/User这个目录。如果你找不到,可以先在 Cursor 里打开命令面板,输入Open User Settings (JSON),它打开的那个文件所在的文件夹就是你要找的位置。
3.2 把 locale 改成 zh-cn
进入用户配置目录后,找到locale.json这个文件。如果目录里没有,也别急,自己新建一个同名文件就行,但要注意文件名必须是locale.json,不要写成locale.txt或者Local.json。
用任意文本编辑器打开这个文件,把内容改成下面这样:
{ "locale": "zh-cn" }如果文件里原来已经有内容了,千万别直接把整个文件清空,只需要保留原来的键值对,再额外加上这一行。比如原来是:
{ "workbench.colorTheme": "Default Dark+" }改完就是:
{ "workbench.colorTheme": "Default Dark+", "locale": "zh-cn" }注意,JSON 语法对逗号很敏感,最后一行千万不要多加逗号,否则语言设置可能加载不了。保存文件后,完全退出 Cursor,再重新打开,界面就会变成中文。
3.3 命令行启动参数“一条命令切中文”
除了改配置文件,还有一个藏在命令行里的技巧:通过启动参数强制指定语言。如果你平时习惯用终端启动 Cursor,可以这样写:
cursor --locale=zh-cnWindows 上也可以在你的 Cursor 快捷方式上右键,进入“属性”,在“目标”一栏的末尾加上--locale=zh-cn,然后每次用这个快捷方式启动,就会自动加载中文界面。这个方法在大多数基于 VS Code 内核的编辑器里都通用,不过 Cursor 更新版本之后,某些版本对启动参数的兼容性会有变化,如果你试了没效果,就还是用前两种方法。
3.4 方法一和方法二到底怎么选
我在不同场景下两种方法都用过,简单说说我的选择逻辑:如果只是自己电脑上想汉化,直接用方法一,因为操作直观,而且后续切回英文也方便;如果是要给几台电脑批量配置,或者扩展商店打不开,就用方法二,直接把locale.json文件拷过去,覆盖到每台机器的用户目录下,重启生效。
另外,方法二还有一个隐性好处:它不需要从扩展商店下载任何东西,所以它依赖的“外部条件”更少。哪怕办公室里网络环境不稳定,只要你能拿到那个 JSON 文件的内容,手动新建一个同样能生效。对于比较在意部署效率的开发者,这个方法相当实用。
4. 汉化之后最常见的坑与排查方法
4.1 语言包装了,界面还是英文
这是我最常被问到的问题。安装语言包后界面没变,通常不是安装失败,而是还没有切换显示语言。语言包只是把中文语言资源放到本地,它本身不会默认生效,你必须通过命令面板里的Configure Display Language选中中文,再重启才能生效。
另一个常见原因是:安装语言包时,Cursor 正处于某个“设置未保存”的状态,导致切换指令没有正常执行。解决办法很简单,重新打开命令面板,再执行一次Configure Display Language,确认“中文(简体)”那一项前面有对勾,然后完全退出 Cursor 再重新打开,不要直接关闭窗口,而是通过菜单里的Exit彻底退出。
4.2 扩展商店搜索不到 Chinese
如果搜索Chinese没有任何结果,先确认扩展商店面板是不是真的加载出来了。有时候 Cursor 刚启动,扩展列表还在后台加载中,你点搜索词太快,会出现空结果。等一两秒再搜一次,或者干脆按Ctrl+Shift+P输入Extensions: Show Installed Extensions看看能不能显示已安装的扩展,如果连这个都是空白,说明扩展商店本身没加载好。
遇到这种情况,优先重启 Cursor,一般就能解决。如果重启后依旧搜不到,可以考虑手动下载语言包 VSIX 文件,再在扩展面板的右上角菜单中选择Install from VSIX,按路径选择你下载好的文件安装。这里要提醒一句,VSIX 文件最好从 VS Code 官方市场获取,不要从来路不明的网站下载。
4.3 中文显示成方块或乱码
切到中文之后,如果界面上的中文变成了一个个小方块或者乱码,一般是字体的问题。Cursor 默认的字体栈里如果没有合适的中文字体,中文就会显示异常。解决办法是打开设置,搜索Font Family,在字体列表里加上你系统里的中文字体。
Windows 上可以写成:
'Cascadia Code', 'Microsoft YaHei', monospacemacOS 上可以写成:
'Menlo', 'PingFang SC', monospace设置完保存,再重启 Cursor,中文字符基本就正常了。这个问题在 Linux 上更容易出现,通常安装一个fonts-noto-cjk之类的字体包就能解决。
4.4 部分菜单和 AI 聊天面板仍然显示英文
这个需要提前说明,免得大家误以为汉化失败。Cursor 主要是把 VS Code 那一层界面汉化了,但它在上面新增的 AI 功能,比如一侧的 AI 对话面板、模型选择下拉框、某些设置项,很多是独立开发的,还没有完整的中文语言包。所以你会看到编辑器菜单是中文,但 AI 面板里可能还留着Chat、Agent、Model这些英文词。
这是正常现象,不代表你操作有误。随着 Cursor 版本更新,这些新增界面也在逐步本地化,但目前不用为了那几个英文单词反复尝试不同汉化方法,白费时间。
4.5 更新 Cursor 之后汉化失效
Cursor 更新频率很高,有时候大版本更新会重置部分用户配置,导致语言又变回英文。遇到这种情况,不需要重新安装语言包,只需要再次执行命令面板里的Configure Display Language,把语言切回中文,或者检查一下locale.json文件还在不在,如果文件被删了,重新创建再重启就行。
我个人习惯是:每次 Cursor 更新后,先看一眼界面语言,如果英文了,就花十秒钟切回中文。这已经成了固定动作,基本不会再被这个小问题困扰。
5. 汉化完之后,这几件事能让中文界面更好用
5.1 顺手调一下字号和字体渲染
刚切完中文,很多人会觉得界面字体有点别扭,尤其是 Windows 上默认字体渲染偏轻,中文小字看着累。打开设置,搜索Editor: Font Size,把字号调到 14 或 15,再搜Window: Zoom Level,可以按Ctrl加鼠标滚轮快速缩放整个界面。
如果用的是高分屏,建议同时打开Editor: Font Ligatures保持代码连字的观感。这些都是个人偏好,但调完之后,中文界面的阅读体验会明显提升。
5.2 把常用快捷键也整理成中文习惯
汉化之后,菜单虽然变成中文了,但快捷键默认还是 VS Code 那套习惯。很多人记不住锈快捷键,比如多行注释是Ctrl+K Ctrl+C,切换到搜索框是Ctrl+Shift+F。建议打开命令面板,直接输入中文关键词,比如“全选所有匹配项”、“格式化文档”,看看快捷键提示,用多了就发现一个规律:只要菜单变中文,命令面板里搜中文关键词也能搜到,效率反而比之前英文时更高。
5.3 AI 聊天和注释里的中英混排问题
汉化只解决界面语言,不改变 AI 模型的行为。你在 Cursor 的聊天框里输入中文,模型大概率会用中文回复,但生成代码里的注释有时候还是英文。这不是汉化失效,而是模型根据上下文自动选择语言。如果你希望注释也尽量中文,可以在对话里明确加一句“请用中文写注释,代码标识符保持不变”,或者在自己写注释的时候顺手用中文,让 AI 跟着你的习惯走。
另外,设置里搜索Code Spell Checker,装个中文拼写检查扩展,可以避免注释里出现错别字。这和汉化无关,但当你开始经常看中文界面、写中文注释时,这个扩展会变得非常有用。
根据我自己的经验,最省心的还是方法一,装一次语言包,之后切语言只是十秒钟的事。如果以后要换新电脑,我通常直接把locale.json和相关配置备份下来,到新环境里一放,中文界面立刻就回来了。你现在用哪种方法?如果操作中还有卡住的地方,可以按上面的排查思路逐条对一遍,基本都能解决。