必须通过命令面板执行“Extensions: Install from VSIX”安装中文语言包,双击.vsix无效;安装后须运行“Configure Display Language”并手动选zh-cn(非zh-hans)并重启,远程开发需在目标机单独安装配置。

必须用 Extensions: Install from VSIX,双击.vsix文件无效
VSCode 自 1.70 版起已禁用双击或拖拽 .vsix 文件的安装机制。这类操作只会把文件复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不加载语言资源、也不触发激活流程。现象是:右下角仍显示 en,设置页、命令面板、调试视图全英文,且无任何错误提示。
唯一可靠路径是:Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中下载好的 MS-CEINTL.vscode-language-pack-zh-hans-*.vsix → 点 Install。
- 发布者必须为
MS-CEINTL,其他名称如 “Chinese Language Pack” 或发布者非此 ID 的插件基本不生效 - 文件名应形如
MS-CEINTL.vscode-language-pack-zh-hans-1.109.2026072801.vsix,版本号需与本地 VSCode 匹配(code --version输出的第一段,如1.109.2→ 取1.109) - 若命令面板搜不到该命令,说明语言包未成功注册,需先卸载再重试
Configure Display Language 必须手动选 zh-cn,不是 zh-hans
装完 .vsix 不等于界面变中文。必须再执行一次 Ctrl+Shift+P → Configure Display Language → 明确选 zh-cn(小写、短横线、无空格、无下划线),然后点 Restart(不是 Reload Window)。
zh-hans 在 1.95+ 版本中仅加载部分基础 UI 字符串,设置页、终端面板、调试视图等关键区域仍为英文;zh_CN、ZH-CN、chinese 全部不识别。
- 该值用于匹配官方语言包 ID
ms-ceintl.vscode-language-pack-zh-hans的后缀协商逻辑 - 若选完没弹提示,检查后台进程是否残留:Windows 杀光所有
Code.exe,macOS/Linux 执行pkill -f "Code Helper"和pkill -f "Electron" - 不要手动改
settings.json加"locale": "zh-cn"—— 这个字段在那里不被识别
远程开发需在目标机器单独部署
本地装了中文包,对 SSH/WSL 远程窗口完全无效。远程环境是独立运行的 VSCode Server 实例,语言包必须在目标机器上重复安装和配置。
操作路径:点击右下角状态栏的 SSH: xxx → Install 'Chinese (Simplified) Language Pack' in SSH: xxx → 安装完成后,同样运行 Configure Display Language 并选 zh-cn → 重启远程窗口。
- 若远程无图形界面,需手动写入
locale.json:路径为$HOME/.config/Code/User/locale.json(Linux)或对应平台用户级路径,内容严格为{"locale":"zh-cn"}(UTF-8 无 BOM) - 注意:远程机器上的 VSCode 版本和语言包版本也需匹配,否则静默失败
验证是否真正生效的三个位置
别只看右下角提示或扩展面板状态。真正生效必须同时满足以下三处全中文:
- 顶部菜单栏(File、Edit、View…)
- 命令面板提示(
Ctrl+Shift+P后输入关键词,选项文字为中文) - 设置导航栏(Settings → 左侧分类如“用户”“工作区”“扩展”,右侧各模块标题)
任一位置仍为英文,说明语言包未激活或 locale 配置未命中。此时优先检查后台进程是否彻底退出、locale.json 是否放在用户级路径、以及 VSCode 是否从「开始菜单」或「应用坞」重新启动(而非旧快捷方式)。


















