必须安装Microsoft官方中文语言包并重启,执行Configure Display Language命令选zh-cn,或手动在settings.json中添加"locale": "zh-cn"。

安装 Microsoft 官方中文语言包
只装这一个插件,其他名字带“中文”“汉化”的第三方插件全都不用碰。认准扩展名 Chinese (Simplified) Language Pack for Visual Studio Code,作者必须是 Microsoft,图标带蓝勾认证。
按 Ctrl+Shift+X 打开扩展面板,搜 chinese(小写),点安装。装完右下角会弹 Restart Now 提示——必须点它,不能只“重新加载窗口”,否则后续步骤无效。
- 装错插件的典型表现:命令面板里搜不到
Configure Display Language - 如果搜不到这个插件,说明网络受限,可去 GitHub 下载
vscode-language-pack-zh-hans.vsix离线安装 - 插件 ID 是
MS-CEINTL.vscode-language-pack-zh-hans,可直接在命令行用code --install-extension MS-CEINTL.vscode-language-pack-zh-hans安装
执行 Configure Display Language 命令
这是真正切换语言的关键动作,不是装完插件就自动生效。很多新手卡在这步,因为命令名不含“中文”二字,纯靠拼音缩写。
按 Ctrl+Shift+P 调出命令面板,输入 Configure Display Language(注意大小写和空格),回车后选 zh-cn ——不是 zh、不是 zh_CN、也不是 Chinese,必须严格小写加连字符。
- 选错后界面仍英文,且设置里
"locale"字段可能被写成错误值 - 如果命令面板里没这个选项,说明语言包根本没装成功或没重启
- 选完提示“是否重启窗口”,一定要选“是”,否则配置不加载
手动改 settings.json 强制生效
当命令面板打不开、或选了 zh-cn 但重启后还是英文,说明 VS Code 没读到 locale 配置。这时直接改 JSON 文件最稳。
按 Ctrl+Shift+P 输入 Open User Settings (JSON) 回车,在打开的 settings.json 里加一行:"locale": "zh-cn"。已有该字段就只改值,别重复写 key。
- 保存后必须彻底退出 VS Code:Windows 任务管理器里确认
Code.exe进程已结束 - Mac/Linux 用户注意路径:
$HOME/Library/Application Support/Code/User/settings.json(macOS)或$HOME/.config/Code/User/settings.json(Linux) - 文件编码必须是 UTF-8 无 BOM,否则中文乱码或配置不解析
验证时只看这三个地方
别被局部英文骗了。终端、调试控制台、Git 输出、部分插件弹窗天生不走 locale 配置,显示英文 ≠ 汉化失败。
只盯以下三处:
- 顶部菜单栏:
文件、编辑、视图、终端是否为中文 - 命令面板:
Ctrl+Shift+P打开后,输入框上方是否显示请输入命令或搜索设置 - 设置界面:
Ctrl+,打开后,左侧导航栏用户、工作区、扩展及搜索框占位符是否为中文
右键菜单、状态栏图标文字、某个插件界面仍是英文,属于正常现象,不用折腾。
容易被忽略的三个致命动作
90% 的“汉化失败”其实就栽在这三件事上,而且每一件都不可跳过:
- 插件安装后没点
Restart Now,而是点了“重新加载窗口”或直接关了再开 - 命令输成
Configure Language或Change Language,根本搜不到正确命令 -
"locale": "zh-cn"写成"locale": "zh"或"locale": "Chinese",VS Code 直接忽略该配置
只要这三步做对,VS Code 界面 90% 以上区域都会是中文;剩下的非核心区域保持英文,是设计如此,不是你没配好。


















