必须手动执行configure display language命令并选zh-cn,否则插件仅提供翻译资源却不激活;右下角提示需点restart,非reload window;官方插件id为ms-ceintl.vscode-language-pack-zh-hans。

为什么装了中文插件还是英文界面?
因为只装插件不等于切换语言——Configure Display Language 命令必须手动执行,且必须选 zh-cn(小写、连字符,不是 zh_CN 或 Chinese)。很多用户卡在这步,以为安装完就自动生效。
- 装完插件后右下角弹出“Change Language and Restart”提示,必须点它;如果没弹,说明插件根本没装成功(比如搜的是
chinese但装了第三方汉化包) - 命令面板里搜不到
Configure Display Language?说明语言包没装对或没重启,重装MS-CEINTL.vscode-language-pack-zh-hans并彻底退出 VS Code 再试 - 选错语言后,
settings.json里可能被写成"locale": "zh"或"zh-CN",这些都不合法,VS Code 会忽略
怎么确认自己装的是官方中文包?
认准三要素:插件名是 Chinese (Simplified) Language Pack for Visual Studio Code,作者是 Microsoft,扩展 ID 是 MS-CEINTL.vscode-language-pack-zh-hans。其他名字带“汉化”“中文”的第三方插件一律不碰。
- 在扩展面板(
Ctrl+Shift+X)搜chinese(全小写),只看搜索结果里图标带蓝勾认证的那一个 - 装错的典型表现:菜单栏仍是英文、命令面板输入中文关键词无响应、终端和调试控制台显示英文(这正常,它们不走 locale)
- 网络受限装不上?直接用命令行离线安装:
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans
settings.json 手动改 locale 失效怎么办?
常见原因是文件路径错、编码错、或 VS Code 进程没彻底退出。Windows 用户尤其容易漏掉后台残留的 Code.exe 进程。
- 正确路径:
Windows:%APPDATA%\Code\User\settings.json
macOS:$HOME/Library/Application Support/Code/User/settings.json
Linux:$HOME/.config/Code/User/settings.json - 文件必须是 UTF-8 无 BOM 编码,用 VS Code 自己打开编辑,别用记事本保存
- 加这一行就够了:
"locale": "zh-cn",已有该字段就只改值,不要重复写 key - 改完保存,必须彻底退出 VS Code(任务管理器里确认
Code.exe进程已结束),再重新启动
哪些地方英文 ≠ 汉化失败?
别被局部英文骗了。VS Code 的 locale 配置只管 UI 主体,终端、Git 输出、调试控制台、部分插件弹窗天生不走这套机制。
- 只盯三个地方验证是否成功:
顶部菜单栏(文件、编辑、视图…)
命令面板(Ctrl+Shift+P输入框上方)
设置页面(Ctrl+,搜索框和选项文字) - 如果这三处是中文,其他地方英文就是正常现象,不是配置问题
- 插件自己的界面语言取决于插件自身支持,比如 Python 插件的调试面板、Jupyter 的 cell 提示,跟
locale无关
zh-cn 打成 zh_CN —— 这些细节不校验,前面全白做。











