vscode启动后显示中文的关键是执行configure display language命令并选择zh-cn,而非仅安装语言包;该命令生成locale.json文件以启用中文,手动改settings.json在1.70+版本已失效。

VSCode 启动后显示中文,关键不在“装没装语言包”,而在于是否正确触发了语言切换开关——Configure Display Language 命令必须执行且选对 zh-cn,否则即使语言包已安装,VSCode 仍以英文启动。
为什么装了中文包还是英文?核心是 locale 没生效
安装 Chinese (Simplified) Language Pack for Visual Studio Code(发布者必须是 Microsoft,ID 是 MS-CEINTL.vscode-language-pack-zh-hans)只是准备好了翻译资源;VSCode 默认仍读取 en。真正决定启动语言的是 locale 配置值,它必须被明确设为 "zh-cn" 并由 VSCode 在进程启动早期加载。
常见错误现象:
- 命令面板搜不到
Configure Display Language→ 要么根本没装官方语言包,要么装的是第三方“汉化插件”(如名字含“一键汉化”“免配置”的),这类插件不提供合法 locale 支持 - 右下角状态栏始终显示
en,点开也无zh-cn选项 → 语言包未被识别,需卸载重装(尤其注意扩展面板里是否出现黄色警告图标) - 菜单部分中文、弹窗乱码 → 第三方插件注入脚本污染了运行时,应立即禁用所有非官方中文相关扩展
手动改 settings.json 失效?检查这三个硬条件
当命令面板不可用或反复失败时,直接编辑用户级 settings.json 是最稳的兜底方式,但必须满足:
- 打开的是用户级配置:用
Ctrl+Shift+P→Open User Settings (JSON),不是工作区或默认设置 - 文件编码为 UTF-8 无 BOM:用 VSCode 自带的编码切换功能(右下角点击编码名 → Save with Encoding → UTF-8)
- 只写一行:
"locale": "zh-cn",已有该字段就只改值,不要重复添加或拼错成"locale": "zh"、"locale": "zh_CN"
Linux/macOS 路径示例:$HOME/.config/Code/User/settings.json(Linux)$HOME/Library/Application Support/Code/User/settings.json(macOS)
Remote-SSH / WSL 连接后仍是英文?远程端 locale.json 没配
本地设成中文,不影响远程实例的界面语言。Remote-SSH 或 WSL 中的 VSCode Server 是独立进程,它读取的是远程机器上的 locale.json 文件(路径通常为 ~/.vscode-server/data/Machine/locale.json)。
操作步骤:
- 先在远程终端中确认 VSCode Server 已运行(如执行
ps aux | grep vscode) - 手动创建或编辑远程的
locale.json,内容仅一行:{"locale":"zh-cn"} - 重启远程 VSCode Server:断开连接 → 在本地 VSCode 中按
Ctrl+Shift+P→Remote-SSH: Kill VS Code Server on Host...→ 重连
字体和终端乱码不是语言包问题,而是编码/字体链缺失
界面变中文后,如果终端输出中文是方块、编辑器里中文注释显示异常,这和 locale 设置无关,属于系统级编码或字体 fallback 问题:
- 终端乱码:确保远程 Linux 的
LANG环境变量为zh_CN.UTF-8(在~/.bashrc或~/.zshrc中加export LANG=zh_CN.UTF-8) - 编辑器内中文显示过小或模糊:在设置中搜索
editor.fontFamily,显式指定中文字体,例如:"editor.fontFamily": "'Microsoft YaHei', 'PingFang SC', 'sans-serif'" - 某些插件面板仍为英文:这是插件自身未做 i18n,比如 Python 插件的 Lint 输出、C/C++ 的 IntelliSense 提示,它们的语言取决于底层工具链(如 Pylint、clangd)是否支持中文本地化
最易被忽略的一点:VSCode 的“中文界面”只管外壳,不接管编译器、调试器、终端、甚至部分插件的文案。别指望 locale 一改,所有报错都自动变中文——那得看 clang 或 Python 解释器自己支不支持。











