必须安装Microsoft官方中文语言包并执行Configure Display Language命令切换为zh-cn,再重启VS Code;手动编辑locale.json写{"locale":"zh-cn"}最可靠,验证仅看菜单栏、命令面板和设置界面三处。

装错插件就白忙,只认 Microsoft 官方扩展
VS Code 没有“中文插件”这个通用名称,搜“中文”“汉化”大概率点进非官方扩展,装完没变化还可能干扰更新。必须锁定唯一正确插件:Chinese (Simplified) Language Pack for Visual Studio Code,作者是 Microsoft,图标带蓝白 VS 标志和蓝勾认证。
操作上:按 Ctrl+Shift+X 打开扩展面板,搜索框里**严格输入**:Chinese (Simplified) Language Pack(注意括号、空格、大小写),别漏掉 for Visual Studio Code 后半段——少一个词都可能搜出错误结果。
- 装完右下角会弹提示,必须点 “Change Language and Restart” 或 “Reload”,仅“重新加载窗口”不够,某些版本不生效
- 如果没弹窗,手动彻底退出 VS Code(Windows 任务管理器确认
Code.exe进程已结束),再重开 - 插件 ID 是
MS-CEINTL.vscode-language-pack-zh-hans,离线安装可用命令:code --install-extension MS-CEINTL.vscode-language-pack-zh-hans
Configure Display Language 命令才是关键动作
装插件只是准备翻译资源,真正切换语言靠的是 Configure Display Language 命令。它不叫“切换中文”,也不在设置里直接可见,必须用命令面板触发。
按 Ctrl+Shift+P 调出命令面板,输入 Configure Display Language(注意大小写和空格),回车后选择 zh-cn ——不是 zh、zh_CN、zh-CN,也不是 “Chinese (Simplified)” 文字选项,必须是纯小写加短横线的字符串。
- 选错会导致
settings.json里被写入无效值,后续手动改也无效 - 选完弹出“是否重启窗口”,一定要点“是”,否则配置不加载
- 如果命令面板里根本搜不到这个命令,说明插件没装成功或没重启,先回去检查上一步
locale.json 或 settings.json 手动写才最稳
命令面板打不开、选了 zh-cn 但重启还是英文,基本是配置没落盘。这时绕过 UI,直接编辑配置文件最可靠。
关闭所有 VS Code 窗口,打开对应路径下的 locale.json(推荐)或 settings.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 编码。如果改 settings.json,就在顶层 JSON 对象里加 "locale": "zh-cn",已有该字段就只改值,别重复 key。
改完必须彻底退出 VS Code 再重开,否则缓存会覆盖新配置。
验证时盯死三处,别被终端骗了
终端、调试控制台、Git 输出、部分插件弹窗天生不走 locale 配置,显示英文完全正常,不代表汉化失败。
只看这三处:
- 顶部菜单栏:
文件、编辑、视图、终端是否为中文 - 命令面板:
Ctrl+Shift+P打开后,输入框上方是否显示请输入命令或搜索设置 - 设置界面:
Ctrl+,打开后,左侧导航栏用户、工作区、扩展及搜索框占位符是否为中文
右键菜单、某个插件界面仍是英文,不用折腾——这是设计如此,不是你配错了。


















