必须安装微软官方中文语言包ms-ceintl.vscode-language-pack-zh-hans,通过Configure Display Language设置zh-cn并重启生效,locale.json路径和内容须严格匹配,插件语言需单独配置。

必须装 Microsoft 官方中文语言包,其他都无效
VS Code 的中文显示不是靠“汉化插件”实现的,而是依赖官方语言包提供的翻译资源。第三方名字带“汉化”“Pro”“Ultimate”的扩展,要么不更新、要么只改菜单栏、甚至引发命令面板乱码或崩溃。
- 只认发布者为
Microsoft、ID 为ms-ceintl.vscode-language-pack-zh-hans的扩展 - 搜索时务必粘贴全名:
Chinese (Simplified) Language Pack for Visual Studio Code - 安装后不要点右上角的 Reload 按钮——它只重载逻辑,不触发语言切换
- 低于 VS Code 1.13 版本可能搜不到该插件,需先升级
Configure Display Language 是唯一生效入口
从 VS Code 1.70 版本起,settings.json 中写 "locale": "zh-cn" 已被完全弃用。改了它,VS Code 启动时会静默忽略——不报错、不警告、也不生效。
- 必须按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入并选择
Configure Display Language(注意不是Change Language等近似项) - 在下拉列表中严格选
zh-cn(小写、短横线;zh_CN、zh-hans、Chinese均无效) - 弹出提示后,必须点 Restart,而不是
Reload Window或Ctrl+R
locale.json 路径和内容必须精准匹配
VS Code 只读用户级 locale.json,且只在**全新启动窗口**时加载一次。手动创建、复制粘贴、写错路径或格式,都会导致白配。
- 正确路径(务必确认你改的是这个):
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容必须严格为:
{"locale":"zh-cn"}(双引号、冒号后无空格、无多余逗号) - 工作区目录下的
.vscode/locale.json是无效的 - 系统环境变量(如
VSCODE_LANG=en)或 GPO 策略可能强行覆盖你的配置
插件自身语言需单独设置,不继承主界面
GitLens、ESLint、Prettier 等主流插件自带多语言支持,但默认不读取 VS Code 的 locale,得手动指定。
-
GitLens:在settings.json中加"gitlens.language": "zh-cn" -
ESLint报错仍是英文?因为错误来自 Node.js 进程,不受locale.json控制;要中文提示需额外装eslint-plugin-i18n或换用支持本地化的 LSP 客户端 - 终端标题栏、调试控制台、WebView 面板等底层模块,根本不在 VS Code 翻译范围内,它们的语言取决于系统
LANG或 Electron 渲染机制 - 验证方式:打开命令面板,输入插件相关命令(如
GitLens: Toggle File Blame Annotations),看提示文字是否已汉化


















