vscode设置中文需安装microsoft官方简体中文语言包(id:ms-ceintl.vscode-language-pack-zh-hans),执行configure display language命令设locale为"zh-cn"并彻底重启,三者缺一不可;界面汉化不改变终端、编译器等底层工具的英文报错。

安装官方中文语言包是唯一可靠方式
VSCode 没有“中文版安装包”,所谓“绿色中文版”多为第三方打包,可能混入广告或修改核心文件。必须通过扩展市场安装 Microsoft 官方发布的 Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code。这个包只提供翻译资源,不改动任何程序逻辑,升级、卸载、切换语言都干净可控。
操作路径:打开扩展视图(Ctrl+Shift+X),搜索 Chinese,认准发布者是 Microsoft、安装量超千万、名称含 (Simplified) 的那个。安装后不生效是正常现象——语言包只是“备好说明书”,还没告诉 VSCode “现在要用中文版说明书”。
必须执行 Configure Display Language 命令
很多人装完语言包就重启,结果界面还是英文。根本原因是没触发语言配置变更:locale 这个设置项仍为默认的 en。VSCode 不会自动把装了中文包等同于“我要切中文”,它严格按配置走。
正确做法是:Ctrl+Shift+P 打开命令面板 → 输入 Configure Display Language → 回车 → 在弹出列表中选 zh-cn → 点击 Restart。这一步本质是往 locale.json 文件里写入 "locale": "zh-cn",只有这个值变了,启动时才会加载中文资源。
常见错误:
- 在设置 UI 里搜
locale并手动改成zh-cn,但没重启——改了等于白改 - 用快捷键
Ctrl+K Ctrl+S(这是打开键盘快捷键设置,不是语言设置) - 在远程开发(SSH/WSL)环境下只在本地改了 locale,远程窗口仍显示英文
中文界面 ≠ 中文报错,别对插件输出抱幻想
菜单、设置面板、右键菜单变成中文,只说明 VSCode 自身界面汉化成功。但真正写代码时看到的 ModuleNotFoundError、undefined reference to 'foo'、Pylint E1101 这些,全来自 Python 解释器、GCC 编译器、Pylint 插件本身——它们是否支持中文,和 VSCode 的 locale 设置无关。
比如你用 WSL 运行 Python,报错仍是英文,是因为 WSL 里的 Python 没配中文 locale;你在终端里运行 gcc 报错是英文,是因为 gcc 本身没做中文翻译。VSCode 只负责把“运行”按钮、“调试”菜单、“问题面板标题”翻成中文,管不了底层工具链。
所以如果看到控制台/终端/问题面板里一堆英文报错,不要怀疑语言包装错了——那是另一个维度的问题,得去查对应工具的 locale 配置或插件文档。
乱码、字体小、注释糊成一片?先盯住三个配置项
界面变中文后,常出现文字重叠、方块乱码、注释显示不全,根源不在语言包,而在编码和字体没对齐:
-
files.encoding必须设为utf8(不是UTF-8,大小写敏感),否则打开旧项目里的中文注释会直接变问号 -
editor.fontFamily至少包含一个中文字体,如"Microsoft YaHei", "SimSun", "Consolas";纯英文字体(如Consolas)在中文环境里会 fallback 失败 - 终端乱码?Windows 用户务必在 VSCode 启动前运行
chcp 65001,或在settings.json里加"terminal.integrated.env.windows": { "CHCP": "65001" }
这些配置和语言包安装是两件事,但缺一不可。很多人卡在“明明界面中文了,为什么我写的中文注释还是乱码”,答案往往就在这三项里漏了一项。











