VSCode 1.70+ 必须通过 Configure Display Language 命令选择 zh-cn 并点击 Restart 才能生效,因已弃用 settings.json 的 locale 配置;需安装 Microsoft 官方语言包 ms-ceintl.vscode-language-pack-zh-hans,且远程开发需单独配置 locale.json。

VSCode 1.70+ 版本(2023 年 11 月起)已彻底弃用 settings.json 中的 "locale" 配置,必须通过 Configure Display Language 命令设为 zh-cn 并彻底重启,否则中文界面一定不生效。
装错 Chinese (Simplified) Language Pack 就白忙
官方语言包 ID 是 ms-ceintl.vscode-language-pack-zh-hans,发布者必须是 Microsoft。搜 “chinese” 或 “汉化” 极大概率装到第三方插件,比如:
- 名称含 “Chinese Menu”“VSCode Chinese”“Pro”“Ultimate”的——只改菜单栏几个字,不翻命令面板、设置项、错误提示
- 作者不是 Microsoft、没蓝勾认证、更新时间早于 2025 年的——大概率与新版 VSCode 冲突,引发乱码或 UI 闪烁
- 扩展图标变灰(被禁用)却没手动启用——装了也等于没装
正确操作:按 Ctrl+Shift+X 打开扩展面板 → 粘贴全名 Chinese (Simplified) Language Pack for Visual Studio Code → 认准蓝白 VS 图标 + 蓝勾 + Microsoft 签名 → 点 Install。
Configure Display Language 命令只认 zh-cn
装完语言包只是“备好字典”,真正激活中文靠的是这个命令。它会自动生成合法路径下的 locale.json,内容为 {"locale":"zh-cn"}。任何变体都静默失败:
-
zh_CN、ZH-CN、zh-hans、Chinese (Simplified)—— 全无效 - 命令面板里输
Configure Display Language后,列表中要手动滚动找到带引号的zh-cn,不能靠关键词匹配 - 弹窗提示 “Restart Now” 时,必须点它;点 “OK” 或关掉弹窗,配置压根不写入
如果你的 VSCode 版本 ≥ 1.70(2026 年所有稳定版都满足),这一步就能完成全部切换。低于 1.40 的旧版才需手动建文件。
重启必须彻底,热重载(Reload Window)完全无效
Developer: Reload Window 只刷新渲染进程,不重新初始化语言环境。VSCode 的 locale.json 只在全新启动窗口时读取。常见失效场景:
- 点了右下角 “Reload Window” 提示 → 界面仍是英文,但你以为“已汉化” → 去中文搜索“自动保存”,结果搜不到(实际还是英文 UI)
- 后台残留
Code.exe(Windows)、Electron(macOS)或code(Linux)进程 → 新开窗口仍读旧配置 - Remote-SSH / WSL 下仍是英文 → 那是远程实例没配,得去远程机器的
~/.vscode-server/data/Machine/xxx/locale.json单独写一遍
兜底方案:关闭所有窗口 → 任务管理器杀光所有 Code.exe 进程 → 用记事本打开对应路径的 locale.json → 写入严格一行:{"locale":"zh-cn"} → 保存 → 全新启动 VSCode。
真正容易被忽略的是:那个 “Restart Now” 提示只出现一次,关了就得手动进命令面板再调 Configure Display Language——它不保存历史记录,也不自动重试。很多人卡在这一步,反复重装插件,其实只是没点对那个按钮。











