VSCode 汉化必须安装 Microsoft 官方简体中文语言包、执行 Configure Display Language 命令并严格输入 zh-cn、彻底重启;手动修改 locale.json 为 {"locale":"zh-cn"} 是兜底方案。

VSCode 界面默认是英文,改成中文不需要重装、不依赖系统语言、也不用改字体或手动复制翻译文件——只靠官方语言包 + 一条命令 + 彻底重启,三者缺一不可。其他所有“搜中文就装”“改 settings.json 里 locale”“建 locale.json 文件夹”的做法,要么失效,要么半残。
必须安装 Microsoft 官方中文语言包
第三方插件名字带“中文”“汉化”“Pro”“Menu”全是干扰项,它们不提供完整翻译,还可能污染命令面板或引发 Cannot read property 'translate' of undefined 报错。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索完整名称:
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是 Microsoft,扩展 ID 必须是
ms-ceintl.vscode-language-pack-zh-hans - 点 Install 后,右下角弹出提示时,必须点 Change and Restart;仅点 Reload Window 或关窗重开都不算数
Configure Display Language 命令只认 zh-cn
语言包只是“翻译资源”,真正启用中文的是 Configure Display Language 命令。它不接受任何变体,输错就静默失败,界面照旧英文,还不报错。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(注意大小写和空格,不是 “简体中文”) - 从下拉列表中**严格选择
zh-cn** ——ZH-CN、zh_CN、zh-hans、Chinese全无效 - 选完会弹窗提示“需要重启窗口”,必须点 Restart;点 Cancel 或关闭弹窗等于没执行
- VSCode 1.80+ 版本该命令已重命名为
Preferences: Configure Display Language,搜configure display就能命中
命令失效时直接改 locale.json 文件
当命令面板卡死、UI 无响应、或批量部署时,手动编辑 locale.json 是最稳的兜底方式。它优先级最高,不依赖插件状态,也不走 UI 流程。
- 彻底退出 VSCode:Windows 查任务管理器杀光所有
Code.exe进程;macOS 在活动监视器结束Code Helper;Linux 用pkill code - 打开对应路径的
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容**只能是标准 JSON 格式的一行**:
{"locale":"zh-cn"}(无多余空格、无逗号、无 BOM、不能有其他字段) - 保存后重新启动 VSCode,顶部菜单栏(文件/编辑/视图)、命令面板占位符、设置左侧导航栏全变中文才算成功
真正容易被忽略的是:终端、调试控制台、Git 输出、Jupyter 内核日志、甚至部分扩展(如 GitLens、ESLint)的界面文字,都不会随 VSCode 的 locale 变。这不是设置失败,而是它们各自依赖自己的语言环境。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。











