必须安装微软官方简体中文语言包、手动设为zh-cn并彻底重启,三者缺一不可;第三方插件会导致乱码或报错;唯一合法插件是Microsoft发布的Chinese (Simplified) Language Pack for Visual Studio Code;Configure Display Language命令仅识别全小写连字符格式的zh-cn;手动编辑locale.json文件({"locale":"zh-cn"})是最可靠兜底方案。

必须装 Microsoft 官方语言包 + 手动选 zh-cn + 彻底重启,三者缺一不可;任何一步出错都会导致“装了还是英文”。
装错插件会导致命令面板乱码或 Cannot read property 'translate' of undefined
搜“中文”“汉化”随手点安装,大概率会装到第三方包(比如 Chinese Language Pack、VSCode Chinese),这些不是微软维护的,不更新、不兼容、有的还注入广告。后果包括:
- 命令面板输入框文字错位或显示方块
- 设置页部分区域空白或报错
Cannot read property 'translate' of undefined -
Configure Display Language命令在命令面板里根本搜不到
唯一合法插件是:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。安装后右下角弹出 Restart Now 提示时,必须点它——只点 “Reload Window” 不生效,因为 Code.exe 进程没退出,locale 配置压根不会加载。
Configure Display Language 命令只认 zh-cn,其他写法全无效
这个命令不是“选择中文”,而是往 locale.json 里写字符串。它对输入值极其敏感:
- 有效值只有
zh-cn(全小写 + 连字符) -
zh_CN、ZH-CN、zh-cn(首字母大写)、Chinese (Simplified)、甚至只输zh—— 全部无效,且无任何错误提示,界面维持英文 - 命令名必须完整输入:
Configure Display Language(注意大小写和空格),不能简写成configure language或set language
执行后弹窗提示“是否重启窗口”,必须点 Yes,否则配置不会写入文件,也不会在新进程中读取。
命令面板打不开?直接编辑 locale.json 最可靠
当 VS Code 卡死、命令面板无法呼出、或反复切换仍无效时,手动改配置文件是绕过所有 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 - 文件内容只能是严格 JSON 格式的一行:
{"locale":"zh-cn"}(双引号、英文冒号、无空格、无 BOM、UTF-8 编码) - 如果文件不存在,直接新建;如果存在但内容是
{"locale":"en"},删掉重写
保存后重新启动 VS Code,界面立刻生效。
终端、调试控制台、Git 日志仍是英文?这不叫汉化失败
VS Code 的 locale 配置只控制主界面(菜单栏、设置页、命令面板、活动栏 hover 文字)。以下部分默认不走 locale:
- 集成终端输出(那是 shell 自己的语言环境)
- 调试控制台(取决于调试器,如 Node.js 或 Python 的本地化逻辑)
- Git 提交日志、diff 输出(由 Git 本身决定)
- 部分插件弹窗(如 Prettier、ESLint 插件自己的提示)
验证是否真汉化成功,只盯这三处:
– 顶部菜单栏(文件、编辑、视图、终端)是否为中文
– 左侧活动栏图标 hover 提示是否为中文
– 设置界面(Ctrl+,)搜索 locale,结果项显示值是否为 "zh-cn"


















