vs code汉化必须安装microsoft官方中文语言包、执行configure display language命令设locale为"zh-cn"并彻底重启;搜“中文”“汉化”易装错第三方插件,仅全名chinese (simplified) language pack for visual studio code且发布者为microsoft才有效。

装错插件:搜“中文”“汉化”就出问题
搜“中文插件”大概率装错,VS Code 唯一支持的简体中文语言包是 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。第三方仿冒包图标模糊、描述含糊,有的带广告或乱码,装了也不生效。
常见错误现象:
- 命令面板里搜不到
Configure Display Language - 右下角弹窗提示“Reload Window”,点了还是英文界面
- 设置里搜索
locale没结果,或值为空/被写成zh_CN、zh-hans等无效格式
正确做法只有一条路径:
- 按
Ctrl+Shift+X打开扩展面板 - 在搜索框里**严格粘贴全名**:
Chinese (Simplified) Language Pack for Visual Studio Code - 只点那个带蓝白 VS Code logo + 中文“中”字图标的选项,确认发布者是
Microsoft - 点击
Install,别信右下角“Reload Window”——它不切换语言
Configure Display Language 命令找不到或选错
语言包只是“备好了翻译字典”,VS Code 默认仍用英文界面。必须手动告诉它“请用中文”,这步不能跳过,也不能靠设置界面里的旧选项。
操作要点:
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(注意大小写和空格) - 回车后从列表里选
zh-cn——不是zh、不是zh_CN、也不是Chinese,必须小写加短横线 - 选完会提示“是否重启窗口”,一定要点“是”,否则配置不加载
- 如果命令面板里没这个选项,说明语言包根本没装成功,或没彻底重启过
性能影响:无。这是纯 UI 层配置,不影响编辑器启动速度或内存占用。
settings.json 手动改 locale 最稳但容易踩坑
当命令面板打不开、或选了 zh-cn 但重启后还是英文,说明 VS Code 没读到 locale 配置。这时候直接改 JSON 文件最稳,但路径和编码必须对。
关键细节:
- 按
Ctrl+Shift+P输入Open User Settings (JSON)回车 - 在打开的
settings.json里加一行:"locale": "zh-cn";已有该字段就只改值,别重复写 key - 文件编码必须是
UTF-8 无 BOM,否则中文乱码或配置不解析 - Windows 路径:
%APPDATA%\Code\User\settings.json;macOS:$HOME/Library/Application Support/Code/User/settings.json;Linux:$HOME/.config/Code/User/settings.json - 保存后必须彻底退出 VS Code:Windows 任务管理器里确认
Code.exe进程已结束;macOS/Linux 用户建议用killall -u $USER code
验证时只盯三个地方,别被局部英文骗了
终端、调试控制台、Git 输出、部分插件弹窗天生不走 locale 配置,显示英文 ≠ 汉化失败。
只检查以下三处:
- 顶部菜单栏:
文件、编辑、视图、终端是否为中文文字 - 命令面板:
Ctrl+Shift+P打开后,输入框上方提示是否显示请输入命令或搜索设置 - 设置界面:
Ctrl+,打开后,左侧分类标签(如用户、工作区)及右侧搜索框 placeholder 是否为中文
复杂点在于:不同系统下配置文件路径不一致,且 VS Code 后台进程常驻不退出,导致改完 settings.json 也看不到效果。杀干净进程再重开,是最常被忽略的一步。











