必须搜索“Chinese (Simplified) Language Pack for Visual Studio Code”,认准发布者为Microsoft、ID为ms-ceintl.vscode-language-pack-zh-hans;搜“中文插件”或“汉化包”易误装第三方扩展,可能导致乱码或广告。

VS Code 插件市场搜索框输什么才能找到中文语言包
搜 chinese 或 Chinese (Simplified) Language Pack for Visual Studio Code 都可以,但必须认准发布者是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。搜“中文插件”“汉化包”大概率命中第三方扩展,可能乱码、不更新,甚至注入广告。
常见错误现象:搜索后没结果 → VS Code 版本低于 1.13(需升级);搜到多个同名插件 → 只装作者为 Microsoft 的那个;安装后右下角没弹“Restart Now” → 不代表失败,只是 UI 提示被禁用或卡住,仍需手动重启。
Configure Display Language 命令选哪个值才生效
执行 Configure Display Language 后,列表里必须选 zh-cn —— 小写、连字符、无空格、不能写成 zh_CN、zh-hans、Chinese 或 zh,这些全无效。
该命令本质是修改 locale.json 文件,但若命令面板打不开、列表为空或选完不生效,说明 UI 层已异常,此时跳过命令直接改配置更可靠。
- 选错值会导致界面维持英文,且后续再运行该命令也不会刷新选项列表
- 设置生效不依赖插件是否已安装,但没装语言包时选
zh-cn会显示空白或回退到英文 - 切换回英文只需同样操作选
en,无需卸载语言包
locale.json 文件位置和格式要求
文件路径因系统而异,但内容必须严格为:{"locale":"zh-cn"},UTF-8 编码、无 BOM、无多余空格或换行。
Windows 路径:%APPDATA%\Code\User\locale.json
macOS 路径:$HOME/Library/Application Support/Code/User/locale.json
Linux 路径:$HOME/.config/Code/User/locale.json
容易踩的坑:
- 没彻底关闭 VS Code(后台进程残留),改完文件也无效
- 用记事本保存时默认是 ANSI 编码,导致 JSON 解析失败
- 误把内容写进
settings.json或argv.json,不起作用 - 路径中多了一级
User或少了一级,文件实际没被读取
离线安装中文语言包的正确流程
内网/防火墙环境无法访问 Marketplace 时,需手动下载 .vsix 文件再安装,不是解压或拖入目录。
下载地址必须来自微软官方 GitHub 或可信镜像,文件名应为 vscode-language-pack-zh-hans-*.vsix(注意不是 zh-hant 或其他变体)。
安装步骤:
- 按
Ctrl+Shift+P输入Extensions: Install from VSIX - 选择下载好的
.vsix文件(某些企业系统需管理员权限) - 安装完成后,仍需执行
Configure Display Language选zh-cn并重启 - 不要试图双击
.vsix打开 —— VS Code 不支持这种安装方式
语言包只汉化 VS Code 自身界面,第三方插件的菜单、提示是否中文,完全取决于插件开发者是否提供对应语言资源,VS Code 不代理翻译。


















