VSCode 中文设置需三步齐备:安装微软官方简体中文语言包(ID ms-ceintl.vscode-language-pack-zh-hans)、通过命令面板执行 Configure Display Language 并设为严格小写的 zh-cn、彻底终止所有残留进程后重启;缺一不可,且终端等子界面不随主界面语言变化。

VSCode 没有真正意义上的“一键设置中文”快捷键,必须安装官方语言包 + 显式指定 zh-cn + 彻底重启三者齐备才生效;漏掉任何一环都会卡在英文界面。
装对插件:只认 Microsoft 官方 ID ms-ceintl.vscode-language-pack-zh-hans
搜“中文”“汉化”“Chinese”容易装错第三方包,比如 Chinese Menu 或 VSCode Chinese ——它们不翻命令面板、报错提示、设置项,属于半汉化,且多数已停止更新。官方包在扩展市场里名称是 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft(带蓝勾认证)。安装后右下角会弹 Restart Now 提示,必须点它,否则语言包只是静默存在,不会被加载。
切对 locale:zh-cn 是唯一有效值,大小写和连字符都不能错
Configure Display Language 命令只接受小写、连字符格式的 zh-cn;zh_CN、zh-CN、ZH-CN、zh-cn (末尾空格)全都不生效,且无任何错误提示,界面维持英文。该命令必须通过 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)触发——F1 在某些插件(如 Vim)下可能被劫持失效。列表里找不到 zh-cn?说明语言包根本没装成功,不是设置问题。
重启要彻底:残留进程会让新窗口回退成英文
点“Restart”只重启当前窗口,后台的 Code.exe(Windows)、Code Helper(macOS)等进程若还在运行,新开的 VS Code 窗口大概率仍是英文。必须手动杀干净:
– Windows:打开任务管理器,结束所有 Code.exe 进程
– macOS:活动监视器里搜索并结束 Code 和 Code Helper
– Linux:执行 pkill -f "code"
再启动,才能确保全局生效。
locale.json 手动覆盖:命令面板打不开时的兜底方案
当命令面板卡死、公司内网无法访问扩展市场、或反复切换失败时,直接编辑 locale.json 最稳:
– Windows 路径:%APPDATA%\Code\User\locale.json
– macOS 路径:$HOME/Library/Application Support/Code/User/locale.json
– Linux 路径:$HOME/.config/Code/User/locale.json
文件内容严格为:{"locale":"zh-cn"}(UTF-8 无 BOM,无多余空格、逗号、换行)。保存后仍需彻底退出再启动。
最容易被忽略的是:终端、调试控制台、部分插件界面默认不随 locale 变——那是 shell、调试器或插件自身的语言环境,和 VS Code 主界面无关。看到终端还是英文,不是汉化失败,而是正常现象。


















