vs code中文界面需安装microsoft官方简体中文语言包、执行configure display language命令设locale为"zh-cn"、并彻底重启,三者缺一不可;装错第三方插件、仅改settings.json或仅重载窗口均无效。

装错插件:搜“中文”就出问题
搜 chinese 或 中文,大概率装到第三方仿冒包——图标模糊、发布者不是 Microsoft、ID 不是 ms-ceintl.vscode-language-pack-zh-hans。这类插件装了也没用,命令面板里根本找不到 Configure Display Language。
- 必须在扩展面板(
Ctrl+Shift+X)里粘贴全名:Chinese (Simplified) Language Pack for Visual Studio Code - 只认发布者为
Microsoft、图标带蓝白 VS 标志 + 中文“中”字的那个 - 装完右下角弹的
Reload Window提示不能点——它不切换语言,点了等于白装
Configure Display Language 命令搜不到
这不是命令面板坏了,而是语言包压根没装成功,或者没重启。VS Code 不会自动读取新装的语言包,必须靠这个命令触发 locale 配置加载。
- 按
Ctrl+Shift+P输入Configure Display Language(注意大小写和空格,不能输成configure display language或config display lang) - 选
zh-cn——不是zh、不是zh_CN、也不是Chinese,小写加短横线,严格匹配 - 选完弹窗提示“是否重启窗口”,必须点
是;只“重新加载窗口”或手动关掉再开,配置不生效
settings.json 手动改 locale 失效
常见原因是路径错、编码错、格式错。VS Code 读不到配置,界面就永远卡在英文。
-
Open User Settings (JSON)打开的是用户级配置,路径固定:
Windows:%APPDATA%\Code\User\settings.json
macOS:$HOME/Library/Application Support/Code/User/settings.json
Linux:$HOME/.config/Code/User/settings.json - 文件必须是
UTF-8 无 BOM编码,否则中文乱码或整行被忽略 - 只加一行:
"locale": "zh-cn",已有该字段就直接改值,别重复写 key,也别漏双引号
验证时别被局部英文骗了
终端、调试控制台、Git 输出、部分插件弹窗本来就不走 locale 配置,显示英文 ≠ 汉化失败。只盯三处:
- 顶部菜单栏:
文件、编辑、视图、终端是否为中文 - 命令面板:
Ctrl+Shift+P打开后,输入框上方是否显示中文提示(如“请输入命令”) - 设置界面搜索框:
Ctrl+,进入后,搜索locale,结果页标题是否为“区域设置”
改完 settings.json 或执行完 Configure Display Language 后,一定要彻底退出 VS Code 进程——Windows 任务管理器里确认 Code.exe 已结束,macOS/Linux 用 ps aux | grep code 看有没有残留进程。











