必须安装微软官方chinese (simplified) language pack for visual studio code,id严格为ms-ceintl.vscode-language-pack-zh-hans,发布者必须是microsoft;安装后需执行configure display language命令选zh-cn并彻底重启,手动编辑locale.json为{"locale":"zh-cn"}才生效。

VSCode官方中文语言包ID必须是ms-ceintl.vscode-language-pack-zh-hans
不是“Chinese Language Pack”或“VSCode Chinese”,那些都不是微软维护。真正起作用的只有一个:发布者是Microsoft、ID 严格为ms-ceintl.vscode-language-pack-zh-hans的扩展。它在 VS Code 1.80+ 中是唯一被加载的语言资源包,其他同名插件早在 2024 年就已停更,装了也白装。
搜索时务必粘贴全名:Chinese (Simplified) Language Pack for Visual Studio Code,别输“中文插件”或“chinese lang”——首页全是仿冒包。安装后右下角会弹 Restart Now 提示,必须点它,点 Reload Window 不会生效。
Configure Display Language命令才是语言切换的关键入口
装完插件界面仍是英文?正常。插件只是提供了翻译字典,VS Code 默认仍用英文界面,必须显式调用命令触发切换逻辑。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择
Configure Display Language(注意不是Change Language或Set Language) - 在打开的
locale.json文件中,把"locale": "en"改成"locale": "zh-cn" - 保存后,弹窗里点
Restart—— 这一步不可跳过,且不能用重载窗口代替
手动编辑locale.json路径和格式最容易出错
如果命令面板搜不到 Configure Display Language,或改完重启还是英文,说明 VS Code 没读到配置,直接编辑文件更可靠。
先彻底退出所有进程(Windows 查任务管理器是否有残留 Code.exe,macOS 看活动监视器里 Electron 是否还在),再定位并编辑对应路径下的 locale.json:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
内容必须是标准 JSON:{"locale":"zh-cn"}。常见错误包括:"zh_CN"、"zh-hans"、"Chinese"、"zh" —— 全部无效;大小写、短横线、双引号缺一不可。
右下角locale显示灰色?说明被环境变量或策略锁死了
如果点击状态栏右下角的 locale 显示灰色、不可点,基本可以确定是被外部强制覆盖了。优先检查:
- 是否设置了环境变量
VSCODE_LANG=en(尤其在终端启动 VS Code 时) - 是否在企业环境中被组策略或 IT 管理工具锁定
- 是否使用 Snap 安装的 VS Code(它默认忽略用户级 locale 配置)
临时绕过方法:终端中运行 code --locale=zh-cn 启动。但长期方案得先解除环境变量或策略限制——否则改任何配置都没用。











