vscode简体中文界面必须通过官方语言包+configure display language命令+完全重启三步实现;手动建locale.json无效,因vscode根本不读取该文件;zh-cn是唯一有效locale值,其他如zh、zh_cn均失效。

直接装官方语言包 + 执行 Configure Display Language 命令 + 完全重启,三步到位。其他方式(比如手动建 locale.json、改 settings.json 里 locale 字段)容易失效或被覆盖。
为什么不能手动创建 locale.json
VSCode 根本不读取 locale.json 文件——这个文件在它的配置体系中不存在。网上很多教程提到它,要么是混淆了旧版 Insiders 的临时调试行为,要么是套用了前端 i18n 库的命名习惯。你新建或修改 locale.json,VSCode 启动时完全忽略,也不会报错,只是白忙一场。
Configure Display Language 命令才是唯一可靠入口
这个命令会自动完成两件事:安装中文语言包(如果还没装)、写入正确的 "locale": "zh-cn" 到当前生效的 settings.json(用户级或工作区级)。它还规避了路径错误、大小写误写(如 zh-CN)、层级冲突等问题。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language,回车 - 选择
zh-cn,点击Restart
重启必须是“完全重启”,不是重载窗口
菜单语言在进程启动最早期加载,只重载窗口(Developer: Reload Window)不会重新读取 locale 配置,界面仍为英文。
- Windows/macOS:关闭所有 VSCode 窗口,再从开始菜单/Dock 启动
- Linux:确保终端没用
code --locale=en这类参数启动;桌面启动器的Exec=行应含--locale=zh-cn - macOS 用户若从终端执行
open -n -b "com.microsoft.VSCode" --args --locale=zh-cn,可绕过 Dock 启动时的 locale 遗失问题
常见失效原因就三个,优先排查
装了语言包但还是英文?别急着重装,先看:
- 是否真的安装了官方扩展:
Chinese (Simplified) Language Pack for Visual Studio Code(ID:MS-CEINTL.vscode-language-pack-zh-hans) - 是否被命令行参数覆盖:检查你是不是总用
code --locale=en启动 - 是否工作区设置覆盖了用户设置:打开命令面板,运行
Preferences: Open Settings (JSON),确认看到的是你要改的那一级settings.json,且里面只有唯一的"locale": "zh-cn"
简体中文唯一有效标识是 zh-cn,zh、zh_CN、ZH-CN 全部无效。界面汉化后,右键菜单、调试面板、命令面板都会变中文,但终端输出、编译器报错仍取决于对应插件或工具链本身,和 VSCode 界面语言无关——这点最容易被忽略。











