vscode 默认无中文界面,需安装微软官方简体中文语言包并重启窗口才生效;通过“configure display language”命令查看/修改 locale.json 中的 "zh-cn" 配置,且必须重启窗口而非仅重载。

VSCode 默认不带中文界面,必须手动安装官方汉化插件,且安装后需重启窗口才生效——不是装完就变中文,这点最容易被忽略。
怎么确认 VSCode 当前语言环境
VSCode 本身没有“语言设置”入口页,它的界面语言由 locale 配置决定。打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),输入并执行:Configure Display Language。这会打开 locale.json 文件,里面就是当前生效的语言标识符。
- 如果内容是
"zh-cn",说明已设为简体中文,但界面仍英文?大概率是没重启窗口 - 如果是
"en-us"或空,说明还没配置 - 该文件路径通常是:
~/.vscode/locale.json(macOS/Linux)或%USERPROFILE%\AppData\Roaming\Code\User\locale.json(Windows)
安装官方 Chinese (Simplified) Language Pack
这是微软维护的唯一推荐汉化方案,非第三方插件。在扩展市场搜 Chinese (Simplified) Language Pack for Visual Studio Code,认准发布者是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 不要装名字类似但发布者是个人或不明组织的“汉化插件”,它们可能注入脚本或覆盖核心行为
- 安装后不会立即切换语言——必须执行一次
Developer: Restart Window(命令面板里搜这个) - 如果装了多个语言包(比如中/日/韩),
locale.json里的值决定最终用哪个,不是“谁装得晚谁生效”
为什么改了 locale.json 还是英文
常见原因不是配置错,而是 VSCode 没读到新配置。它只在启动时加载 locale.json,运行中修改文件无效。
- 改完
locale.json后,必须重启整个 VSCode 窗口(不是关标签页,是关所有窗口再重开) - 如果用命令行启动 VSCode(如
code .),确保终端没设VSCODE_LANG或LC_ALL环境变量干扰 - 某些 Linux 发行版预装的 Snap 版 VSCode 有沙盒限制,可能导致语言包无法加载,建议改用 .deb/.rpm 官方包或 tarball
真正卡住人的地方,往往不是不会装插件,而是改完配置忘了重启窗口,或者误以为“安装即生效”。语言包本身没缓存机制,也不支持热更新——它就是一个启动时读取的静态开关。











