必须用命令面板安装中文语言包,双击或拖拽.vsix无效;需执行“extensions: install from vsix”选中官方zh-hans包,再运行“configure display language”选zh-cn并彻底重启。

必须用命令面板安装 .vsix,双击或拖拽无效
VSCode 自 1.70 版起已禁用双击或拖拽 .vsix 文件的安装方式,静默失败且无任何提示。文件会被复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不触发语言资源加载流程——结果就是右下角仍显示 en,设置页、命令面板、调试面板全英文。
唯一可靠路径是:Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 回车 → 在弹窗中选中你提前下载好的 vscode-language-pack-zh-hans-*.vsix(发布者必须为 MS-CEINTL)→ 点击 Install。
- 验证是否成功:打开扩展面板(
Ctrl+Shift+X),搜索ms-ceintl.vscode-language-pack-zh-hans,确认状态为“已启用” - 若搜不到该扩展,说明未真正注册,需先卸载再重走命令面板流程
- 不要从百度网盘、第三方镜像站下载压缩包或封装器,过期率高,还可能带静默行为
Configure Display Language 命令必须手动执行且选 zh-cn
装完 .vsix 不等于界面变中文。语言包只是把翻译字典放进去,VSCode 默认仍按英文启动。真正切换语言靠的是内置命令 Configure Display Language,它会生成或修正 locale.json,但只写配置、不刷新 UI。
操作步骤:Ctrl+Shift+P → 输入完整命令名 Configure Display Language(注意大小写和空格)→ 回车 → 从下拉列表中**明确选 zh-cn**(小写、短横线;zh_CN、zh-hans、Chinese 全部不识别)→ 弹出提示后必须点 Restart(不是 Reload Window)。
- 若命令面板搜不到
Configure Display Language,基本是插件未注册成功,重试上一步安装 -
zh-hans在 1.95+ 版本中仅加载基础 UI 字符串,设置页、终端面板、调试视图仍为英文 - 不要手动编辑
settings.json加"locale": "zh-cn"—— 这个字段在那里不被识别
重启必须彻底杀掉后台进程
点 Restart 后如果界面仍是英文,大概率是 Electron 或 Code.exe 进程残留,新配置未加载。VSCode 的语言协商在主进程启动时完成,残留旧进程会跳过重新读取逻辑。
- Windows:打开任务管理器,杀光所有
Code.exe进程 - macOS:打开活动监视器,搜索并强制退出所有
Electron进程 - Linux:运行
pkill -f 'code'或killall code - 之后再从开始菜单 / 应用坞 / 终端重新启动 VSCode,不要双击旧快捷方式(可能指向旧版路径)
验证是否真生效,看三处关键位置
别只盯着右下角状态栏。很多用户以为弹了 Restart Now 就算成功,其实只是安装完成提示,不是语言切换确认。必须人工验证以下三处是否全部中文:
- 顶部菜单栏(File、Edit、View… 变成 文件、编辑、查看…)
- 命令面板(
Ctrl+Shift+P)里的提示文字,比如 “Preferences: Open Settings (JSON)” 变成 “首选项:打开设置 (JSON)” - 设置导航栏(Settings 页面左侧树状结构,如 “文本编辑器”、“工作台”、“终端”)
三处全中文才算真正生效。任一区域仍为英文,说明语言包 ID 与 locale 值未匹配,或进程未干净重启——这时候回溯检查 Configure Display Language 是否真选了 zh-cn,以及后台是否还有残留进程。











