vscode 中文界面需手动配置 locale 为 zh-cn 并重启:安装 microsoft 官方简体中文语言包后,通过 ctrl+shift+p 运行 configure display language 命令选择 zh-cn 并重启;若失效,可手动创建 %appdata%\code\user\locale.json(windows)等对应路径文件,内容为 {"locale": "zh-cn"},再彻底重启验证。

VSCode 默认不显示中文界面,装完语言包也不自动切语言——必须手动指定 locale 为 zh-cn 并重启,否则永远是英文。
安装官方中文语言包必须认准发布者 Microsoft
第三方“中文汉化”“Pro版”插件基本失效或带广告,只用这个:Chinese (Simplified) Language Pack for Visual Studio Code。它在扩展市场里搜 chinese 就能出来,但务必确认发布者是 Microsoft、ID 是 ms-ceintl.vscode-language-pack-zh-hans。
安装后右下角会弹提示,但此时别点 “Reload Window”,那只是重载扩展,不会触发语言切换。
- Windows 用户按
Ctrl+Shift+X,Mac 用户按Cmd+Shift+X打开扩展面板 - 搜索框里直接粘贴全名,避免拼写误差
- 安装完成后,先不关窗口,下一步再操作
Configure Display Language 命令才是关键开关
语言包只是“翻译词典”,VSCode 不会自己翻。必须通过命令显式告诉它用哪种语言——Configure Display Language 是唯一可靠入口。
按 Ctrl+Shift+P(Mac 用 Cmd+Shift+P)调出命令面板,输入并选择该命令,然后从列表中选 zh-cn(注意不是 zh_CN、zh 或 Chinese)。
- 选完会弹窗问是否重启,必须点
Restart,不能只点Reload Window - 如果命令面板里没这个选项,说明语言包没装成功,或版本太低(低于 1.80)
- 部分旧版 VSCode 可能需先升级:Help → Check for Updates
手动改 locale.json 是兜底方案,路径不能错
命令面板失效、重启后仍英文、或者企业环境被策略锁定时,就得直接改配置文件。VSCode 只读取特定路径下的 locale.json,其他位置的文件一概忽略。
正确路径:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容只需一行:{"locale": "zh-cn"}。如果不存在,就新建;如果已有 settings.json 里写了 locale,优先级更低,得删掉或注释掉那一行。
改完保存,彻底退出 VSCode(包括托盘进程),再重新打开。
验证和常见卡点
重启后看顶部菜单栏(文件、编辑、视图)是否变中文。如果只有部分区域是中文,比如设置页还是英文,大概率是工作区里有 .vscode/settings.json 覆盖了用户级配置,删掉或改掉里面的 locale 字段即可。
右下角状态栏点 locale 显示灰色不可编辑?说明被环境变量 VSCODE_LANG 或组策略锁死了,这时候改配置文件也没用。
终端、调试控制台、Git 输出默认不汉化——那是 Shell 或 Git 自己的语言,和 VSCode 界面语言无关,不用折腾。











