vscode中文界面需三步:装microsoft官方中文包、配置locale.json为{"locale":"zh-cn"}、彻底重启;远程开发需在远程机器对应路径单独配置,snap/flatpak版不兼容。

VSCode装完中文包还是英文界面?不是插件没装好,而是你漏掉了 Configure Display Language 这一步——它才是语言切换的唯一开关,改 settings.json 或点“重载窗口”全无效。
搜索时必须输入完整插件名
很多人搜 Chinese 就随手点安装,结果界面部分乱码、命令面板显示 Cannot read property 'translate' of undefined。根本原因是装了非官方包。
- 打开扩展面板(
Ctrl+Shift+X/Cmd+Shift+X) - 在搜索框里严格粘贴全名:
Chinese (Simplified) Language Pack for Visual Studio Code - 只认发布者是
Microsoft、ID 是ms-ceintl.vscode-language-pack-zh-hans的那一项 - 别选名字带
Chinese Language Pack、VSCode Chinese、Pro、Ultimate的第三方包——它们不更新、不兼容,有的还注入广告
Configure Display Language 命令不能跳过
插件只是“备好了字典”,VS Code 默认仍用英文。必须显式告诉它“我要中文”,而这个动作只能通过命令触发。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择:
Configure Display Language - 它会打开一个 JSON 文件(通常是
locale.json),把内容改成:{"locale":"zh-cn"} - 注意:
zh_CN、zh、Chinese都无效;必须小写、短横线、双引号包裹 - 保存后,弹窗提示“需要重启窗口以应用更改”,必须点
Restart—— 点Developer: Reload Window不会重新读取语言配置
远程开发(Remote-SSH / WSL)下中文不生效
本地设了中文,远程连接后还是英文?因为 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读的是远程机器上的 locale.json,和本地完全无关。
- 先确认远程 VS Code Server 已运行:在 WSL 终端执行
code --list-extensions - 进入远程配置路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀目录) - 在该目录下新建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口) - 如果用 Snap/Flatpak 安装的 VS Code,语言包大概率无法加载——换用
.deb或官方tarball版本
右下角状态栏显示 en 就说明没生效
真正起作用的只有三样东西:装对插件、locale.json 存在且内容合法、VS Code 进程是全新启动的。任何中间环节出错,都会卡在英文界面。
- 检查插件是否来自 Microsoft:扩展详情页看发布者和 ID
- 确认
locale.json路径正确(Windows:%APPDATA%\Code\User\locale.json;macOS:~/Library/Application Support/Code/User/locale.json;Linux:~/.config/Code/User/locale.json) - 彻底重启:关掉所有 VS Code 窗口 + 杀掉后台进程(任务管理器 / Activity Monitor /
killall code),再重开 - 工作区根目录下的
.vscode/locale.json不生效,别往那儿写











