必须安装Microsoft官方语言包ms-ceintl.vscode-language-pack-zh-hans,再执行Configure Display Language命令选zh-cn并彻底重启,或手动配置locale.json为{"locale":"zh-cn"},二者缺一不可。

装完插件界面仍是英文,不是插件没装上,而是没激活 locale 设置——必须执行 Configure Display Language 命令或手动写 locale.json,否则永远是英文。
怎么搜对官方中文语言包
在扩展面板(Ctrl+Shift+X)里,**不要搜“中文”“汉化”“VSCode Chinese”**,这些关键词会带出大量失效/非官方插件。正确做法是:
– 完整输入:Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写)
– 只点发布者为 Microsoft、ID 为 ms-ceintl.vscode-language-pack-zh-hans 的那一项
– 其他同名但发布者不是 Microsoft 的,哪怕名字更短、评分更高,也一律跳过
装完插件后必须做的三件事
安装只是第一步,不完成后续动作,界面不会变中文:
– 等右下角弹出提示:“Language changed to Chinese (Simplified). Reload window to apply?” → 必须点 Reload(不是关窗口再开)
– 如果没弹窗,立刻按 Ctrl+Shift+P 打开命令面板,输入并执行 Configure Display Language
– 在弹出选项中选 zh-cn(小写、短横线,zh_CN、zh、Chinese 都无效)
– 点“是”后,**必须彻底退出所有 VSCode 进程**(Windows 可查任务管理器是否有残留 Code.exe)
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"}(保存为 UTF-8 无 BOM)
– 改之前务必关掉所有 VSCode 进程,否则改了也不加载
常见错误现象和对应检查点
界面还是英文?别重装插件,先查这几个地方:
– Ctrl+Shift+P 里搜不到 Configure Display Language → 插件根本没装成功,重装 ms-ceintl.vscode-language-pack-zh-hans
– settings.json 或工作区 .vscode/settings.json 里有 "locale": "en" 或空值 → 它会覆盖全局设置,删掉或改成 "zh-cn"
– 终端运行 code -v 报错 → 和语言包无关,是安装时没勾选“添加到 PATH”,重装并勾选该选项
– 重启后部分菜单中文、报错仍英文 → 说明插件 ID 不对,第三方包只翻 UI 不翻核心提示,必须换回 Microsoft 官方 ID
真正卡住人的从来不是“找不到下载链接”,而是以为装完插件就等于切换成功;插件和 locale 是两个独立开关,中间没有自动联动。


















