最可靠方式是执行configure display language命令选zh-cn并重启:vs code 1.70+已弃用settings.json的locale配置,仅通过该命令自动生成用户级locale.json(内容{"locale":"zh-cn"}),并确保安装microsoft官方中文语言包。

直接执行 Configure Display Language 命令最可靠
VSCode 1.70+ 版本起,settings.json 中写 "locale": "zh-cn" 已被完全弃用,改了也无效。唯一被官方支持且能自动处理路径、校验语言包、生成正确配置的入口,就是命令面板里的 Configure Display Language。
操作步骤极简:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Configure Display Language,回车执行 - 从下拉列表中选
zh-cn(注意:必须是小写 + 连字符,zh_CN、zh-CN、Chinese (Simplified)都不识别) - 若提示“语言包未安装”,点
Install;已安装则直接保存并弹出重启提示 - 点击右下角
Reload Window(不是关掉重开,也不是Ctrl+R刷新)
这个命令会自动在用户级目录(如 %APPDATA%\Code\User\locale.json 或 ~/.config/Code/User/locale.json)创建或更新 locale.json,内容为 {"locale":"zh-cn"} —— 手动写错路径或格式,是汉化失败最常见的原因。
中文语言包必须装 Microsoft 官方版
扩展市场搜 chinese 会出现一堆第三方汉化插件,但只有作者是 Microsoft、名称为 Chinese (Simplified) Language Pack for Visual Studio Code 的那个才真正完整翻译菜单、状态栏、错误提示、内置扩展说明等全部 UI 元素。
其他非官方包可能只改部分文本,或与新版 VSCode 不兼容,甚至引发界面闪烁、命令面板乱码等问题。
安装要点:
- 在扩展面板(
Ctrl+Shift+X)搜索时,认准蓝勾认证和下载量 >1000 万 - 安装后不要仅靠“已安装”就以为生效——必须配合
Configure Display Language命令指定使用它 - 如果扩展图标变灰,说明被禁用,右键启用后再执行语言切换
重启必须彻底,否则 locale.json 不加载
很多人点了 Reload Window 后还是英文,根本原因是后台进程残留。VSCode 的 locale.json 只在**全新启动窗口**时读取,热重载(Reload Window)只是刷新当前渲染进程,不重新初始化语言环境。
尤其在 Windows 上,任务管理器里常有多个 Code.exe 或 Code Helper 进程没退出;macOS 上 Activity Monitor 里也可能残留 Code Helper (Renderer)。
稳妥做法:
- 点击右下角提示中的
Restart,而非Reload Window - 关闭所有 VSCode 窗口后,手动检查并结束所有
Code相关进程 - 再双击图标或终端执行
code重新打开 - 验证时重点看顶部菜单栏(文件、编辑、视图)、命令面板提示语、设置页左侧标签——这些是核心 UI,比右键菜单更可靠
离线环境或公司内网怎么装语言包?
扩展市场打不开时,Configure Display Language 命令会提示“无法连接”,但语言包本身是静态资源,支持离线安装。
操作流程:
- 在有网络的机器上,访问微软官方 GitHub Release 页面,搜索
vscode-language-pack-zh-hans - 下载最新版
.vsix文件(如vscode-language-pack-zh-hans-1.90.0.vsix) - 复制到目标机器,在 VSCode 扩展面板右上角三个点 →
Install from VSIX...→ 选择该文件 - 安装完成后,仍需执行
Configure Display Language→zh-cn→Restart
注意:.vsix 文件名里的版本号要尽量匹配你本地 VSCode 版本(可通过 Help > About 查看),低版本语言包在高版本 VSCode 上可能缺失部分新 UI 字符串。
最关键的细节是:语言包安装和语言设置是两个独立动作,缺一不可;而 locale.json 的位置、编码(UTF-8 无 BOM)、字段名大小写,三者错一个,中文就不会出来。











