必须安装microsoft官方中文语言包、执行configure display language命令设locale为"zh-cn"并彻底重启三者缺一不可;搜“中文”易装错,应严格输入全名chinese (simplified) language pack for visual studio code,认准发布者microsoft,安装后右下角提示change and restart须点击生效。

安装官方中文语言包是唯一可靠方式
VSCode 没有“中文版安装包”,所有中文界面都依赖 Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code 这个官方扩展。第三方所谓“汉化补丁”或“绿色中文版”极可能篡改主程序、注入广告,甚至破坏更新机制。装完后界面仍是英文?大概率是没启用语言包,而不是包没装上。
- 打开扩展面板:按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS) - 搜索关键词:
chinese,认准发布者是Microsoft、带蓝勾认证的条目 - 点击“Install”,安装完成后右下角会弹出提示框——必须点里面的
Change and Restart,不是关掉弹窗再手动重启
Configure Display Language 命令比改设置更直接
很多人在设置里搜 locale 找到选项,选了 zh-cn 却不生效,是因为该设置项只写入用户配置,但 VSCode 启动时优先读取的是 locale.json 文件。用命令面板操作能绕过这个层级,一步到位写入并触发重启逻辑。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language,回车 - 在弹出列表中选择
zh-cn,然后点Restart - 如果命令面板里搜不到该命令,说明语言包根本没装成功,先回上一步检查扩展状态
locale.json 文件路径和手动修复场景
当 VSCode 卡在英文界面、命令面板失效、远程开发连不上 GUI 时,直接编辑 locale.json 是最稳妥的兜底方案。它不依赖插件市场、不触发扩展加载逻辑,纯配置驱动。
- 文件路径必须准确:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
- Windows:
- 内容只需一行 JSON:
{"locale":"zh-cn"},不要加注释、不要多余空格、不要逗号结尾 - 如果文件不存在,直接新建;如果存在但内容为空或格式错误,删掉重写
- 改完后必须完全退出 VSCode(包括系统托盘进程),再重新启动
界面变中文后仍显示英文的常见原因
不是所有“英文”都是 VSCode 本体的问题。很多新手看到调试器变量名、终端输出、Python 插件的 lint 提示还是英文,就以为汉化失败。其实这些跟界面语言无关,是各自插件或工具链的本地化支持程度问题。
-
Python插件的 Pylint 报错、C/C++扩展的 IntelliSense 提示,默认就是英文,需单独配置插件级语言(如 Python 插件的python.defaultInterpreterPath不影响语言) - 终端(Terminal)里运行
gcc、node、python -m py_compile的错误信息,由对应工具自身决定,VSCode 只负责渲染,无法翻译 - 远程开发(SSH / WSL)场景下,语言包只装在本地 VSCode,远程服务器上没有语言资源,所以远程窗口的命令面板、设置页仍可能是英文
- 某些旧版本 VSCode(zh-cn 的 fallback 支持不全,部分菜单项会退回到英文,升级到最新版可解决











