必须执行Configure Display Language命令并重启VS Code才能启用中文UI,仅安装语言包无效;远程开发需在远程机器的~/.vscode-server/data/Machine/[hash]/locale.json中配置{"locale": "zh-cn"}。

插件名称还是英文?根本没切到中文语言环境
插件管理页面(Ctrl+Shift+X)里所有插件名、分类、描述全是英文,不是插件本身的问题,而是 VS Code 根本没启用中文 UI 语言。装了中文语言包但没走 Configure Display Language 命令,等于只搬来了字典,没打开翻译开关。
实操建议:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Configure Display Language,**必须完整拼写、大小写一致** - 从下拉列表中**明确点击
zh-cn**(不是 “简体中文” 文字项,也不是zh-CN或zh-hans) - 弹出提示后点 Restart —— 注意不是
Developer: Reload Window,后者不重载语言配置 - 重启后检查右下角状态栏是否显示“中文(简体)”,再打开扩展面板确认效果
装了非官方“中文插件”,反而导致插件名乱码或消失
搜“中文”“汉化”安装的第三方插件(如 Chinese Language Pack、VSCode Chinese 等),常会覆盖核心翻译逻辑,造成插件市场部分字段显示为方块、问号,甚至报错 Cannot read property 'translate' of undefined,此时插件名可能直接不渲染。
实操建议:
- 卸载所有非官方中文相关扩展,只保留唯一合法项:
Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是 Microsoft,扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans - 安装后右下角弹窗出现时,**不要点 “Reload Window”**,必须执行上面的
Configure Display Language步骤 - 若已乱码,可打开开发者工具(
Ctrl+Shift+P→Developer: Toggle Developer Tools),清空控制台后执行location.reload()再重启
远程开发(Remote-SSH / WSL)下插件名仍是英文
本地设好 zh-cn,一连上 Remote-SSH 或 WSL,插件管理页又变英文——这是因为远程实例运行的是独立的 VS Code Server,它不读本地的 locale.json,而读自己路径下的同名文件。
实操建议:
- 登录远程机器(如 WSL 终端或 SSH 连接),执行
code --list-extensions确认 Server 已就绪 - 进入远程路径:
~/.vscode-server/data/Machine/(后面通常只有一个哈希命名子目录) - 在该目录下创建或编辑
locale.json,内容仅一行:{"locale": "zh-cn"},确保 UTF-8 无 BOM 编码 - 退出并重新连接远程窗口,插件名才会同步为中文
locale.json 文件位置或格式错误,导致切换失效
手动改过 locale.json 却没生效,大概率是路径错了,或者 JSON 格式非法(多空格、少引号、逗号错位)。VS Code 只读用户级路径下的该文件,其他位置写的全被忽略。
实操建议:
- 确认路径是否正确:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json
便携版:[安装目录]/data/user-data/User/locale.json - 文件内容必须严格为:
{"locale": "zh-cn"},不能有注释、不能换行、不能多逗号 - 用记事本或 VS Code 自带的编码切换功能(右下角点击编码 →
Reopen with Encoding→UTF-8)确保无 BOM - 改完后彻底退出 VS Code 进程(Windows 任务管理器杀光
Code.exe;macOS Activity Monitor 清掉所有Code和Code Helper)
Configure Display Language 并彻底重启,插件名就永远是英文——这不是 bug,是设计如此。


















