中文不生效的首要原因是装错插件,唯一有效的是微软官方插件Chinese (Simplified) Language Pack for Visual Studio Code(ID:ms-ceintl.vscode-language-pack-zh-hans);必须执行Configure Display Language命令并选择zh-cn,或手动编辑locale.json为{"locale":"zh-cn"}。

装错插件是中文不生效的首要原因
搜“中文”“汉化”安装的第三方插件(比如 Chinese Language Pack、VSCode Chinese)基本都不可靠,轻则菜单乱码,重则触发 Cannot read property 'translate' of undefined 报错,甚至让 Configure Display Language 命令在命令面板里直接消失。
唯一有效插件是微软官方发布的:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须为 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 按
Ctrl+Shift+X打开扩展面板,搜索完整名称(小写),只点这个带蓝勾认证的 - 安装后右下角弹出
Restart Now提示——必须点它,Reload Window不会加载语言资源 - 若没弹窗,检查该插件是否被禁用(图标灰了),或手动执行
Developer: Reload Window
Configure Display Language 命令只认 zh-cn
插件只是“字典”,真正激活中文的是这个命令。它本质是往 locale.json 写入值,但下拉列表里显示的 “Chinese (Simplified)” 是假象,起效的只有底层字符串 zh-cn。
- 按
Ctrl+Shift+P呼出命令面板,输入Configure Display Language(注意大小写和空格) - 从下拉列表中**明确点击**
zh-cn——zh_CN、zh-CN、Chinese、zh全部无效,且无任何错误提示 - 选完弹出“Restart to apply changes”,必须点
Yes,否则配置不落盘 - Windows/macOS 用户需确认所有
Code.exe或Code Helper进程已退出,仅关闭窗口不够
手动编辑 locale.json 是最稳的兜底方式
当命令面板打不开、列表无 zh-cn、或反复重启仍英文时,直接改配置文件绕过 UI 层,优先级最高,且不依赖插件状态。
- 彻底退出 VS Code(Windows 查任务管理器杀光
Code.exe;macOS 运行killall -u $USER 'Code Helper') - 定位并编辑
locale.json:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容**只能是这一行**:
{"locale":"zh-cn"}(无空格、无 BOM、UTF-8 编码) - 如果文件不存在,直接新建;如果存在但内容是
{"locale":"en"},删掉重写
别被终端和插件界面的英文骗了
顶部菜单栏、左侧活动栏 hover 文字、设置页(Ctrl+,)搜索 locale 显示值为 zh-cn —— 这三处全中文,就说明主界面汉化成功。
而终端输出、调试控制台、Git 日志、部分插件弹窗默认不走 VS Code 的 locale 配置,它们依赖系统 shell 或插件自身本地化逻辑。看到这些地方仍是英文,不是汉化失败,是正常行为。
远程开发(Remote-SSH / WSL)场景下,中文不生效往往是因为远程实例读的是它自己机器上的 locale.json,不是你本地的——得在远程环境里重复上述步骤。


















