必须安装microsoft发布的chinese (simplified) language pack for visual studio code(id:ms-ceintl.vscode-language-pack-zh-hans),并手动修改locale.json中"locale"为"zh-cn"后重启vs code。

VSCode官方中文语言包必须装哪个?认准ID和发布者
只装一个:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 必须是 ms-ceintl.vscode-language-pack-zh-hans。其他所有名字带“汉化”“Pro”“Ultimate”“中文语言包”的插件,包括 Chinese Language Pack(作者 13xforever)和 VSCode Chinese,2024 年起已停止维护,VS Code 1.80+ 版本根本不会加载——装了不仅没用,还可能干扰 locale.json 读取。
搜索时别输“中文插件”,直接粘贴全名;安装页底部看 ID,图标必须是蓝白 VS Code logo + 中文“中”字;发布者字段不能是 “Microsoft Corporation” 或其他变体,只认 “Microsoft”。
装完还是英文?三步缺一不可
插件只是提供翻译资源,不自动切换语言。必须手动走完整流程:
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language - 在打开的
locale.json文件里,把"locale": "en"改成"locale": "zh-cn"(注意:小写、短横线、双引号包裹) - 保存后,弹窗点
Restart—— 不要点Reload Window,它不重载语言配置
改错格式如 "zh_CN"、"zh"、"Chinese" 全部无效;改完不重启,或只重载窗口,界面一定还是英文。
locale.json 路径和覆盖优先级容易搞错
VS Code 只从特定路径读取 locale.json,且按固定优先级生效:工作区 > 用户 > 系统。多数人只需改用户级配置,但路径常被写错:
- Windows:
%APPDATA%\Code\User\locale.json(不是settings.json,也不是Code - Insiders目录) - macOS:
~/Library/Application Support/Code/User/locale.json(注意拼写是locale,不是local) - Linux:
~/.config/Code/User/locale.json
如果项目根目录下有 .vscode/locale.json,它会覆盖用户级设置——这点常被忽略,导致你在用户配置里改了,但打开某个项目时界面仍是英文。
汉化后部分界面仍显英文?这是正常设计
官方语言包覆盖率约 85%,以下位置保留英文属于预期行为,不是 bug:
- 调试器(Debugger)面板里的变量类型、调用栈帧名
- 集成终端(Integrated Terminal)输出的命令行工具原始信息(如
npm install日志) - 部分高级设置项(如
editor.smoothScrolling的描述文字) - 第三方插件自带的 UI(比如
ESLint插件的警告提示框)
想补全右键菜单可用 Chinese Menu,想深度汉化设置项可试 vscode-zh-hans-menu,但它们只是辅助,不能替代官方语言包——也不建议依赖这类非官方补丁,容易与新版冲突。











