vs code 中文界面需同时满足两个硬条件:安装 microsoft 官方中文语言包(id ms-ceintl.vscode-language-pack-zh-hans)且执行 configure display language 命令选 zh-cn 并彻底重启;仅装插件不重启、或只改 settings.json 未装包,界面必为英文。

装完插件不重启,或只改 settings.json 但没装语言包,界面一定还是英文——VS Code 的中文显示依赖两个硬条件:已安装官方中文语言包 + locale 配置为 "zh-cn",缺一不可。
必须装 Microsoft 官方中文语言包
第三方“汉化插件”基本不可靠,很多会覆盖核心 UI 资源、导致命令面板异常或设置项消失。只认准这个扩展:
- 名称:
Chinese (Simplified) Language Pack for Visual Studio Code - 作者:
Microsoft(带蓝勾认证) - 插件 ID:
MS-CEINTL.vscode-language-pack-zh-hans
安装后右下角会弹出 Restart Now 提示——必须点它,不能只“重新加载窗口”,否则语言资源不会加载。
如果网络受限,可去 GitHub 下载 vscode-language-pack-zh-hans.vsix 离线安装,然后执行:code --install-extension vscode-language-pack-zh-hans.vsix
Configure Display Language 命令才是关键开关
装完插件只是准备好了翻译资源,真正触发切换的是 Configure Display Language 这个命令。它会直接写入 locale.json(不是 settings.json),优先级更高。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(注意大小写和空格) - 回车后选择
zh-cn——不是zh_CN、不是Chinese、也不是zh - 选完会提示“是否重启窗口”,必须选“是”
如果命令面板里搜不到这个选项,说明语言包根本没装成功,或安装后没重启过 VS Code。
手动改 settings.json 是兜底方案,但有前提
当命令面板打不开、或执行命令后仍无效时,才用这招。但它只在 locale.json 不存在或被忽略时起作用。
- 按
Ctrl+Shift+P输入Preferences: Open Settings (JSON) - 在 JSON 对象里加一行:
"locale": "zh-cn"(注意双引号、逗号、小写连字符) - 保存后,必须彻底退出 VS Code:Windows 任务管理器中确认所有
Code.exe进程已结束 - 文件编码必须是 UTF-8 无 BOM,否则配置解析失败
Linux/macOS 用户注意路径:
macOS:$HOME/Library/Application Support/Code/User/settings.json
Linux:$HOME/.config/Code/User/settings.json
中文能显示 ≠ 终端/代码/报错也中文
界面语言只控制菜单、设置面板、欢迎页等外壳部分。以下三类内容不受影响:
- 终端(Terminal)输出:取决于 shell 和系统 locale,例如
echo $LANG在 WSL 中应为zh_CN.UTF-8 - 代码文件内容:文本本身不会被翻译,乱码需检查文件编码(推荐统一设为 UTF-8)
- 调试器/语言服务报错:如 Python 的 Pylint、C++ 的 IntelliSense 错误,由对应插件决定是否提供中文本地化
最常被忽略的一点:Windows 系统区域设置若未勾选“Beta 版:使用 Unicode UTF-8 提供全球语言支持”,WSL 中中文路径就会被识别为乱码,即使 VS Code 界面是中文,cd /mnt/c/中文目录 也会失败。











