VSCode 切中文界面需装官方中文语言包并设 locale 为 zh-cn:先安装 Microsoft 的 Chinese (Simplified) Language Pack 扩展,再通过 Configure Display Language 命令选择 zh-cn 并重启;若无效,手动创建 UTF-8 无 BOM 的 locale.json 文件,内容为 {"locale":"zh-cn"},路径按系统平台严格配置。

VSCode 要切中文界面,核心就两件事:装对包、设对 locale 值。其他所有“不生效”问题,90% 都卡在这两个环节上。
安装 Chinese (Simplified) Language Pack 扩展必须认准 Microsoft 官方
这个扩展不是可有可无的“美化插件”,而是 VSCode 中文界面的底层翻译资源。没它,locale.json 里写 "zh-cn" 也白搭——界面会 fallback 回英文,只在部分菜单或提示里显示零星中文。
- 打开扩展面板(
Ctrl+Shift+X或点击侧边栏方块图标) - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code,确认发布者是Microsoft,下载量超千万 - 别点错成“Chinese Language Pack”“VSCode Chinese”等第三方仿名包,那些通常只改几个菜单项,且长期不更新
- 安装后无需手动启用,但必须配合后续语言设置步骤才生效
Configure Display Language 命令选 zh-cn,不是 zh_CN 或 zh-CN
VSCode 对 locale 字符串大小写和连字符极其敏感。输错一个字符,配置就静默失败,界面仍为英文,且无任何报错提示。
- 用
Ctrl+Shift+P打开命令面板,输入Configure Display Language并执行 - 从下拉列表中**直接选择**
zh-cn(小写,短横线),不要手敲 - 如果列表里压根没
zh-cn,说明语言包没装成功或未完成下载,先检查扩展面板里该包状态是否为“已安装”并显示“重新加载”按钮 - 选完后务必点
Restart,仅重载窗口(Reload Window)不够,部分 UI 组件需完整进程重启
locale.json 文件路径和内容必须严格匹配系统平台
当命令面板打不开、或切换后反复回退英文时,这是最稳的兜底方案。但路径写错或文件编码不对,会导致 VSCode 启动失败或忽略配置。
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径:
$HOME/.config/Code/User/locale.json - 文件内容只能是纯 JSON:
{"locale":"zh-cn"},不能有多余空格、逗号或注释 - 保存时必须用 UTF-8 无 BOM 编码(用 VSCode 自己打开编辑并保存即可,默认满足)
- 修改前确保所有 VSCode 进程已退出,包括后台的
Code Helper(Windows 任务管理器、macOS 活动监视器里都得清干净)
真正容易被忽略的是:部分内置功能(如 GitLens 的右键菜单)、几乎所有第三方扩展的 UI,都不会被语言包翻译。这不是配置失败,而是它们本身就没提供 zh-cn 的 locale 文件。别花时间折腾这些,专注把主编辑器、调试面板、资源管理器这些核心区域调通就行。



















