必须安装microsoft官方中文语言包、执行configure display language命令选zh-cn并彻底重启,三者缺一不可;装第三方插件、仅重载窗口或改settings.json均无效。

装完官方语言包 ≠ 菜单变中文,必须执行 Configure Display Language 命令选 zh-cn 并彻底重启进程,否则菜单、设置页、命令面板全保持英文。
认准唯一有效的中文语言包
搜“中文”“汉化”大概率装错——第三方插件(如 Chinese Language Pack、VSCode Chinese)不维护、不更新,还会导致 Configure Display Language 命令在命令面板里直接消失。
- 只装这个扩展:
Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 按
Ctrl+Shift+X打开扩展面板,搜小写chinese,只点带蓝勾认证、下载量超千万的那个 - 安装后右下角弹出 Restart Now 提示——必须点它;点 “重新加载窗口” 无效,
Code.exe进程没退出,语言资源根本不会加载 - 网络受限搜不到?去 GitHub 下载
vscode-language-pack-zh-hans.vsix,用命令行安装:code --install-extension vscode-language-pack-zh-hans.vsix
执行 Configure Display Language 命令才是关键
语言包只是翻译字典,真正打开中文开关的是这个命令。它不显眼、名字不含“中文”,但缺它菜单就永远是英文。
- 按
Ctrl+Shift+P调出命令面板,输入Configure Display Language(注意 C 和 D 大写,中间空格,结尾无标点) - 从下拉列表中严格选择
zh-cn—— 不是zh、不是zh_CN、不是Chinese,写错会导致locale.json里存入非法值,后续手动改都救不回来 - 选完弹窗提示“是否重启窗口”,必须点 是;此时 VS Code 会完全退出再重开,界面才真正走中文 locale
- 如果命令面板里搜不到该命令,说明语言包压根没装成功,或安装后没点 Restart Now
手动编辑 locale.json 是最稳的兜底方式
VS Code 1.70+ 彻底弃用 settings.json 中的 "locale": "zh-cn",现在只认独立的 locale.json 文件,且路径、编码、JSON 格式稍有差池就静默失效。
- 关闭所有 VS Code 窗口,Windows 上确认任务管理器里没有残留的
Code.exe进程 - 定位并编辑
locale.json:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容只能是标准 JSON,仅一行,无空格、无逗号、无 BOM:
{"locale":"zh-cn"} - 务必用 VS Code 自己新建并保存该文件,右下角状态栏确认编码显示为 UTF-8(不是 UTF-8 with BOM 或 GBK)
为什么终端、调试控制台、部分插件还是英文?
这不是汉化失败,而是设计如此。VS Code 的终端和调试面板不走主 locale 配置,它们的语言由底层系统或运行时决定。
- 终端(Terminal)显示英文,是因为它调用的是系统 shell(如 PowerShell、bash),语言取决于操作系统区域设置,VS Code 不干预
- 调试控制台里的变量名、报错堆栈来自 Node.js / Python 解释器等运行时,也与 VS Code 主 locale 无关
- 插件菜单/设置页仍英文,是因为多数插件(如 ESLint、GitLens)自身未提供中文翻译,其 UI 文字依赖 VS Code 主体语言,但实际适配率很低
- 个别插件(如 Tailwind CSS Intellisense ≥ v0.10.0)支持中文,需单独配置插件级语言项,如
tailwindCSS.language
真正卡住人的地方,往往不是找不到插件,而是没意识到 Configure Display Language 必须配合彻底重启,或者把 locale.json 放错路径、存成带 BOM 的 UTF-8。这些细节一错,整个汉化流程就停在英文界面上不动了。











