必须安装 microsoft 官方中文语言包并手动执行 configure display language 命令或编辑 locale.json 文件才能启用中文界面,第三方汉化插件可能导致乱码、广告或劫持;装完需重启而非仅重载窗口,且须彻底关闭所有 vs code 进程。

只装 Microsoft 官方中文语言包,别碰第三方“汉化插件”
搜“中文插件”“汉化包”大概率装错——第三方扩展可能界面乱码、带广告、甚至劫持主页。VS Code 的中文支持是标准语言资源包机制,不是补丁式汉化。
必须认准:Chinese (Simplified) Language Pack for Visual Studio Code,发布者是 Microsoft,插件 ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索框里**严格输入全名**,包括括号和空格,一个字符都不能少
- 只点那个带蓝白 VS Code logo + 中文“中”字图标的选项
- 装完右下角弹出的 “Reload window” 提示**不要点**——它不触发语言切换
- 如果搜不到,说明 VS Code 版本低于
1.13,需先升级
Configure Display Language 命令必须手动执行
装完语言包 ≠ 界面变中文。语言包只是“字典”,真正告诉 VS Code “用中文显示”的动作是 Configure Display Language 命令。这个命令不会自动运行,也不会出现在菜单里。
- 按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language(注意 C 和 D 大写、中间空格、无句号) - 在弹出列表中**严格选
zh-cn**:不是zh_CN、zh-hans、Chinese,这些全无效 - 选完会提示是否重启,必须点
Restart—— 仅“重新加载窗口”不生效 - 如果命令面板里根本搜不到该命令,说明语言包没装成功,或安装后没彻底重启过任何窗口
locale.json 手动编辑是兜底方案
当命令面板卡死、UI 崩溃、或批量部署时,直接改配置文件最可靠。VS Code 启动时优先读取 locale.json,它的优先级高于 settings.json 中的 locale 字段。
- 彻底关闭所有 VS Code 窗口,包括后台进程(Windows 查任务管理器中所有
Code.exe;macOS 查活动监视器里的Electron) - 定位并用任意编辑器打开:
%APPDATA%\Code\User\locale.json(Windows)、$HOME/Library/Application Support/Code/User/locale.json(macOS)、$HOME/.config/Code/User/locale.json(Linux) - 文件内容**只写一行**:
{"locale":"zh-cn"} - 确认编码为 UTF-8 无 BOM,不能有多余逗号、空格或换行
- 保存后全新启动 VS Code
验证时只看顶部菜单栏、命令面板和设置页
终端、调试控制台、Git 输出、部分插件弹窗天生不走 locale 配置,它们显示英文不代表汉化失败。别被这些区域骗了。
真正生效的标志是:左上角菜单栏(File、Edit、View…)、命令面板(Ctrl+Shift+P 弹出的列表)、设置页(Settings 标签页标题)全部变成中文。
容易被忽略的是:改完 locale.json 或执行命令后,必须杀掉所有残留进程再重开——只要后台还有 Code.exe 或 Electron,新配置就压根不加载。











