VSCode汉化必须安装Microsoft官方中文语言包、执行Configure Display Language命令选zh-cn、彻底重启三者缺一不可;搜小写chinese才能命中官方插件,locale.json须放用户级目录且内容严格为{"locale":"zh-cn"}。

插件搜索必须用小写 chinese,别输错拼写
VSCode 扩展商店对大小写敏感,搜 chinese 才能命中微软官方插件;搜 Chinese 或 zh-cn 基本没结果。很多用户卡在第一步,反复安装第三方“汉化包”,其实只是拼写错了。
认准发布者是 Microsoft、名称带蓝勾认证标识的 Chinese (Simplified) Language Pack for Visual Studio Code —— 其他同名插件不提供完整 UI 翻译,装了也白装。
装完插件不重启 = 白装
安装完成后右下角弹出的提示框里,Change and Restart 是唯一有效操作。点 Restart Now 才会真正加载语言资源;点 Reload Window 或手动关再开,都不触发 locale 初始化。
- Windows/macOS/Linux 全平台一致:必须彻底关闭所有 VSCode 进程再启动
- 如果用了 Remote-SSH / WSL / Dev Containers,插件得分别在远程环境里重装一次
- 任务管理器里残留
Code.exe进程时,重启可能失效,建议手动结束进程再试
Configure Display Language 命令选的是 zh-cn,不是文字选项
按 Ctrl+Shift+P 输入 Configure Display Language 后,列表里出现的 zh-cn 是唯一正确项。选 Chinese (Simplified) 文字条目或 zh-CN(大写 CN)都无效——VSCode 内部只认小写连字符格式。
若该命令压根不出现,说明插件没装成功或被禁用;若列表为空,大概率是 locale.json 路径写错或文件编码非 UTF-8。
locale.json 放错位置比内容写错更常见
手动改配置时,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"},多一个空格、少一个引号、用中文标点都会导致失败。别把它和 settings.json 混在一起。


















