真正起作用的中文语言包只有 microsoft 官方的 chinese (simplified) language pack for visual studio code(id:ms-ceintl.vscode-language-pack-zh-hans),需通过 configure display language 命令设为 zh-cn 并重启窗口,远程环境须单独配置 locale.json 且安装同款语言包。

装对插件:只认 Microsoft 官方扩展 ID
第三方“汉化插件”名字相似但完全不可靠,比如 Chinese Language Pack、VSCode Chinese Pro,它们不翻译命令面板、设置项、错误提示,还可能引发 Cannot read property 'translate' of undefined 报错。真正起作用的只有一个:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 必须是 ms-ceintl.vscode-language-pack-zh-hans。
操作要点:
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索完整名称:
Chinese (Simplified) Language Pack for Visual Studio Code(注意大小写和空格) - 安装后右下角弹出 Restart Now 提示——必须点它;
Reload Window不触发语言切换
执行 Configure Display Language 命令:只接受 zh-cn
语言包只是翻译资源,真正激活中文靠的是 Configure Display Language 命令。它不读 settings.json,也不响应手动改 locale 字段,且对值极其严格:写成 zh_CN、zh-hans、Chinese 或 zh 全无效,且不报错,只会静默维持英文。
操作要点:
-
Ctrl+Shift+P打开命令面板,输入Configure Display Language - 从下拉列表中**明确点击**
zh-cn(不是“简体中文”文字项,那是显示名) - 弹窗提示“需要重启窗口”,必须点 Restart,不是
Reload Window - 如果没出现
zh-cn选项,说明语言包根本没装成功,命令会自动跳转到扩展页
手动编辑 locale.json:绕过 UI 失效场景
当命令面板卡死、输不了字、或选了 zh-cn 重启后仍是英文,大概率是 VS Code 没成功写入配置。此时直接改 locale.json 是最稳解法。
操作要点:
- 彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 在活动监视器结束Code Helper - 打开对应路径的
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容**严格为一行**:
{"locale":"zh-cn"}(无 BOM、无多余空格、无逗号、JSON 合法) - 工作区目录下的
.vscode/locale.json会被忽略,VS Code 只读用户级路径
Remote-SSH / WSL 场景下中文不生效?本地设置不管用
Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读的是远程机器上的 locale.json,和本地完全无关。你在本地装包、设 zh-cn,对远程窗口毫无影响。
操作要点:
- 先确认远程服务已运行:
code --list-extensions - 进入远程配置路径:
~/.vscode-server/data/Machine/xxx/(xxx是哈希目录名) - 在该目录下新建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口) - 远程端也需安装同一官方语言包,否则
locale.json有值也无翻译资源可用
真正容易被忽略的是:终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。











