正确入口是通过VS Code内置扩展市场安装“Chinese (Simplified) Language Pack for Visual Studio Code”官方扩展,安装后需修改locale.json中"locale"为"zh-cn"并重启,不可手动复制文件或仅重载窗口。
在 VS Code 中安装中文语言包的正确入口
vs code 官方不提供“中文语言包”独立安装包,所有语言支持都通过扩展(extension)实现,且必须从内置扩展市场安装——不能手动下载 .vsix 或复制语言文件到 resources/app/locales/ 目录,后者在新版中已失效或触发签名验证失败。
打开 VS Code 后,点击左侧活动栏的扩展图标(或按 Ctrl+Shift+X),在搜索框输入:Chinese (Simplified) Language Pack for Visual Studio Code。这是微软官方维护的唯一推荐扩展,发布者为 Microsoft,注意识别图标和验证徽章,避免安装第三方仿冒包。
安装后必须重启才能生效
安装完成后,VS Code 不会自动切换界面语言。需要手动触发语言切换并重启——否则菜单、设置页、命令面板仍显示英文。
按下 Ctrl+Shift+P 打开命令面板,输入并选择:Configure Display Language。此时会打开一个 locale.json 文件,将其中 "locale" 的值改为:"zh-cn"(注意是双引号包裹,且无空格)。保存文件后,VS Code 会提示“需要重启以应用更改”,必须点击 Restart 按钮,而非仅关闭再打开窗口。
常见错误:改完 locale.json 后只重载窗口(Developer: Reload Window),语言不会变;或误写成 zh_CN、zh、chinese 等非标准值,导致回退到英文。
多用户或便携版 VS Code 的语言配置位置
VS Code 读取语言配置的优先级是:工作区设置 环境变量。多数人只需改用户级 locale.json,路径如下:
- Windows:
%APPDATA%\Code\User\locale.json -
macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
若使用便携版(Portable Mode),则配置文件位于安装目录下的 data/user-data/User/locale.json;多人共用一台机器时,确保修改的是当前登录用户的配置,而非系统级全局配置(VS Code 本身不提供系统级语言设置)。
汉化不完全?这些地方不受语言包控制
语言包仅翻译 VS Code 自身 UI 和内置功能(如设置面板、调试视图、源代码管理页)。以下内容**不会被汉化**,属于正常现象:
- 第三方扩展的界面文字(如
Prettier、GitLens),需各自扩展单独支持中文 - 终端(Terminal)内运行的命令输出(如
npm install、git status),取决于系统 locale 和对应工具的语言设置 - 编辑器内文件内容、注释、变量名等,语言包完全不干预
- 某些新引入的实验性功能(如 Copilot 聊天界面、Notebook 工具栏按钮),可能滞后于主干汉化进度
如果发现设置页某项仍是英文,先确认是否为刚发布的 VS Code 版本(如 1.90+),官方汉化通常有 1–2 周延迟;可检查扩展页面该语言包的“Last updated”时间,比对 VS Code 版本发布日期。










