必须安装微软官方“Chinese (Simplified) Language Pack”、通过Configure Display Language命令设置zh-cn、并彻底重启VS Code,三者缺一不可;其他方法在2026年均已失效。

VSCode 英文界面切中文,不是装个插件就完事——必须装对包、设对值、重启到位,三者缺一不可;其他任何“改 settings.json 里 locale”“手动复制语言文件”“搜‘中文’随便点安装”的做法,2026 年已全部失效。
怎么装对唯一有效的中文语言包
搜“中文”“汉化”大概率装错第三方包,比如 Chinese Menu 或 VSCode Chinese,它们只改顶部菜单几个字,命令面板、设置项、错误提示全是英文,还可能报 Cannot read property 'translate' of undefined。
- 打开扩展面板:
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS) - 搜索框里**粘贴完整名称**:
Chinese (Simplified) Language Pack for Visual Studio Code(注意大小写、空格、括号) - 只认发布者是 Microsoft、ID 是
ms-ceintl.vscode-language-pack-zh-hans的那一项(蓝白 VS 图标 + 蓝勾) - 安装后右下角弹出
Restart Now提示——必须点它,Reload Window不触发语言切换
Configure Display Language 命令为什么总没反应
这个命令不是可选项,而是唯一能正确生成 locale.json 的入口。它不接受任何变体,也不报错,只会静默失败。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(不能少字母、不能拼错) - 从下拉列表中**滚动找到并点击**
zh-cn(全小写、连字符;zh_CN、zh-hans、Chinese全无效) - 弹窗提示“需要重启窗口”,必须点 Restart,点了 No 或关掉弹窗,配置根本不会写入
- 如果命令面板没反应、列表为空、或点了没变化,基本说明语言包压根没加载成功,不是命令用错了
手动编辑 locale.json 是最稳的兜底方式
当命令面板卡死、切换后仍英文、或企业策略锁死 UI 设置时,直接改文件绕过所有中间层——关键是路径、编码、格式三者都得对。
- 先彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 在活动监视器结束Code Helper - 打开对应路径的
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"}(无 BOM、无多余空格、无逗号、JSON 合法) - 远程开发(WSL / Remote-SSH)要单独配:进
~/.vscode-server/data/Machine/xxx/locale.json改同一行
真正容易被忽略的是:终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。


















