VS Code 界面不汉化最常见原因是装错中文语言包,必须安装 Microsoft 官方扩展 ms-ceintl.vscode-language-pack-zh-hans,并通过 Configure Display Language 或 locale.json 设置 zh-cn 才能生效。

怎么装对中文语言包
装错插件是界面不汉化的最常见原因。VS Code 的中文支持只认 Microsoft 官方发布的 Chinese (Simplified) Language Pack for Visual Studio Code,ID 是 ms-ceintl.vscode-language-pack-zh-hans。搜“中文插件”“汉化包”“VSCode Chinese”大概率点进第三方非官方扩展,装了也没用。
正确操作只有三步:
- 按
Ctrl+Shift+X打开扩展面板 - 在搜索框里**完整输入**:
Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写) - 只点发布者为 Microsoft、图标是蓝白 VS 标志的那个,点击 Install
装完不会立刻变中文——它只是把翻译字典放进来了,还没告诉 VS Code “请用它”。
为什么装完还是英文
因为没激活语言包。VS Code 默认仍用英文,必须显式指定语言。有三种等效方式,任选其一即可:
- 右下角弹出提示时点
Change Language and Restart - 按
Ctrl+Shift+P打开命令面板,输入并执行Configure Display Language,选zh-cn - 手动编辑
locale.json:用Ctrl+Shift+P→Open User Settings (JSON),添加或修改"locale": "zh-cn"(必须小写、短横线,zh_CN或zh都无效)
改完记得保存并点击提示里的 Reload Window。某些 Snap 版或企业定制版 VS Code 会忽略该配置,此时需启动时加参数:code --locale=zh-cn。
locale.json 文件在哪
这个文件不在安装目录,而是在用户数据目录下,路径因系统而异:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
多用户或重装后容易丢配置——插件还在,但 locale.json 被清空或没同步,界面就自动回退英文,且没有任何错误提示。建议把它加入你备份清单,或者直接用命令面板切换,比手动改文件更可靠。
中文生效后要注意什么
菜单、设置、命令面板显示中文,不代表所有地方都翻完了。部分插件(比如 Python、GitLens)自带独立语言逻辑,它们的界面文字是否中文,取决于各自插件的本地化支持程度,和 VS Code 主体语言无关。
另外,按住 Ctrl 悬停英文术语(如 workspace、debugger)时,部分插件会弹出中文释义,但这属于辅助功能,不是核心界面汉化的一部分。
真正容易被忽略的是:VS Code 的语言设置和系统语言完全解耦。哪怕你用英文 Windows,只要装了包 + 配了 zh-cn,界面就是中文;反过来,系统是中文,没配 locale.json,它照样英文——这点和大多数软件不同,得记牢。


















