必须选zh-cn而非“简体中文”文字项;若命令面板无效,需手动编辑locale.json文件为{"locale":"zh-cn"}并彻底重启,且远程环境须单独配置。

Configure Display Language 命令必须选 zh-cn,不是“简体中文”文字项
VS Code 的 Configure Display Language 命令下拉列表里显示的是语言名称(如“简体中文”),但真正起效的是背后那个值——必须是严格小写的 zh-cn。点击“简体中文”文字本身不会生效,它只是显示名;你得在列表中**明确看到并点击 zh-cn 这一行**。如果没看到 zh-cn,说明中文语言包压根没装对或没装上。
locale.json 文件路径和内容必须完全合规
命令失效或重启后仍是英文,大概率是 VS Code 没成功写入配置。此时直接编辑 locale.json 是最稳的兜底方式:
- 彻底退出 VS Code:Windows 杀光所有
Code.exe,macOS 在活动监视器结束Code Helper,Linux 执行pkill -f 'code' - 定位文件路径:
%APPDATA%\Code\User\locale.json(Windows)、$HOME/Library/Application Support/Code/User/locale.json(macOS)、$HOME/.config/Code/User/locale.json(Linux) - 文件内容必须严格为:
{"locale":"zh-cn"}—— 无空格、无逗号、无 BOM、无注释、大小写敏感
别装第三方“汉化插件”,只认 Microsoft 官方语言包
搜索扩展时,只认这个 ID:ms-ceintl.vscode-language-pack-zh-hans,发布者必须是 Microsoft。名字带“汉化”“一键中文”“Chinese Pro”的第三方插件,99% 只改菜单栏几个字,命令面板、报错提示、调试控制台全是英文,还可能引发 Cannot read property 'translate' of undefined 错误。
装完官方包后,右下角弹出的 Restart Now 提示必须点——“重载窗口”不生效。
Remote-SSH / WSL 下中文不生效?那是另一个独立实例
你在本地设好了 locale.json,连上远程机器后界面还是英文,不是配置错了,而是 Remote-SSH 或 WSL 启动的是另一套 VS Code Server,读取的是远程机器上的用户配置。
- Remote-SSH 连接后,运行
Developer: Open User Data Folder,进User/目录编辑locale.json - WSL 中,进
~/.vscode-server/data/Machine/(路径含哈希后缀)下的User/locale.json - 语言包也得在远程端单独安装,本地装了不自动同步
locale.json 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。


















