正确汉化VS Code只需三步:安装Microsoft官方简体中文语言包(ID:ms-ceintl.vscode-language-pack-zh-hans)、执行Configure Display Language命令并严格选择zh-cn、彻底重启。

装对插件 + 执行 Configure Display Language 命令选 zh-cn + 彻底重启,三步到位;其他任何操作都是绕路或埋坑。
安装 Microsoft 官方中文语言包必须认准 ID 和作者
第三方“汉化插件”名字里带“Chinese”“Pro”“Menu”都别点——它们只改右键菜单几个字,命令面板、报错信息、设置项全是英文,还可能引发 Cannot read property 'translate' of undefined 错误。真正起作用的只有一个: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)打开扩展面板,粘贴全名搜索,认准蓝勾图标和 Microsoft 署名后点击 Install。安装完右下角会弹 Restart Now 提示——必须点它,不能只点“重新加载窗口”。
- 搜不到?可能是网络受限,可去 GitHub 下载
vscode-language-pack-zh-hans.vsix离线安装,或用命令行执行code --install-extension ms-ceintl.vscode-language-pack-zh-hans - VS Code 版本低于 1.80 可能不显示该插件,需先升级(Help → Check for Updates)
Configure Display Language 命令只接受严格小写的 zh-cn
插件只是放好了翻译资源,真正激活中文靠的是 Configure Display Language 命令。它不接受任何变体:zh、zh_CN、ZH-CN、Chinese 全无效,且不报错,界面静默维持英文。
按 Ctrl+Shift+P(macOS 用 Cmd+Shift+P)呼出命令面板,输入 Configure Display Language(注意大小写和空格),回车后从下拉列表中**明确点击 zh-cn** ——不是“简体中文”文字项(那是显示名),而是值为 zh-cn 的那一行。
- 选错后
settings.json或locale.json可能被写入错误值,导致后续反复失效 - 没这个命令选项?说明语言包根本没装成功,或未完成首次重启
- 提示“是否重启窗口”时,必须点
Restart,点Reload Window不会重新读取语言配置
命令失效时直接编辑 locale.json 是最稳兜底方案
命令面板卡死、输不了字、或选了 zh-cn 重启后仍是英文,说明 VS Code 没成功写入配置。此时绕过 UI 层,手动编辑 locale.json 是唯一可靠解法。
彻底退出 VS Code:Windows 查任务管理器杀光所有 Code.exe;macOS 在活动监视器结束 Code Helper 进程。然后打开对应路径的 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"}(无 BOM、无多余空格、无逗号、JSON 格式合法)。如果文件不存在,就新建一个;如果已有 settings.json 里写了 "locale" 字段,它优先级更低,得删掉或注释掉。
终端、调试控制台、Git 输出仍是英文是正常现象
顶部菜单栏(文件/编辑/视图)、命令面板占位符(“请输入命令或搜索设置”)、设置界面左侧导航(“用户”“工作区”)这三处变成中文,才算真汉化成功。
终端、调试控制台、Git 输出、部分插件界面显示英文,不是汉化失败——它们走各自独立的本地化逻辑,和 VS Code 主体的 locale 无关。盯住那三个关键位置验证即可。
Remote-SSH / WSL 下仍英文?那是远程实例没配,得去远程机器的 ~/.vscode-server/data/Machine/xxx/locale.json 单独写一遍。


















