先确认本地VS Code版本号,再通过Marketplace Version History或_api直链下载对应版本中文包.vsix;下载后须用“Install from VSIX”安装并执行Configure Display Language重启生效,若提示不兼容需解压修改package.json中engines.vscode字段后重打包。

怎么拿到指定日期的旧版中文包 .vsix 文件
VSCode 官方语言包不按日期发布,而是按版本号(如 1.87.2)和构建时间戳(如 2024051609)打包。所谓“旧日期”,实际要找的是对应 VS Code 版本号 + 该版本下发布的语言包构建号。
正确路径是:先确认本地 VS Code 版本(code --version 输出第一行,如 1.87.2),再查这个版本号是否在插件的 GitHub Release 页面 或 Marketplace 的 Version History 中出现过。
- 打开 官方简体中文包页面
- 滚动到底部,点 Version History → 等待列表加载完成
- 若列表中没有你要的版本(比如只有
1.90.0,但你需要1.87.2),说明该版本未被 Marketplace 保留,需走 API 直链 - 右键任意一个已有版本的下载链接 → “复制链接地址”,得到类似:
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/MS-CEINTL/vsextensions/vscode-language-pack-zh-hans/1.90.0/vspackage - 把其中的
1.90.0替换为你需要的版本号(如1.87.2),粘贴进浏览器地址栏回车下载
注意:版本号必须完全一致,1.87 ≠ 1.87.2;补丁位缺失会导致 404。
下载后直接双击安装为什么失败
VSCode 自 1.70 起已禁用双击或拖拽安装机制,它只会把 .vsix 复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展、不加载语言资源、也不写入激活状态。
现象是:右下角仍显示 en,命令面板、设置页、调试视图全是英文,且无任何错误提示。
- 唯一有效方式是:按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 → 选中文件 → Install - 别用
code --install-extension命令行——它在某些环境(尤其内网或 PATH 配置异常时)会静默失败,且不反馈具体原因 - 安装完成后,必须手动执行
Configure Display Language并选择zh-cn,再点击 Restart
装了还是提示 “Extension is not compatible” 怎么办
这不是网络问题,也不是文件损坏,而是 .vsix 内部 extension/package.json 中的 "engines": {"vscode": "^1.85.0"} 字段被严格校验,与你本地 code --version 输出不匹配。
解决步骤(必须完整执行):
- 用
unzip(Linux/macOS)或7-Zip(Windows)解压.vsix文件(它本质是 ZIP) - 找到根目录下的
extension/package.json,编辑"vscode"字段:
原值:"^1.85.0"→ 改为:=1.87.2"(精确锁定)或=1.87.0"(放宽小版本) - 保存后,重新用压缩工具打包为 ZIP 格式(**必须保持内部结构不变**)
- 将 ZIP 后缀名改为
.vsix - 再通过
Extensions: Install from VSIX安装
跳过重打包步骤 = 白改 —— VSCode 会校验 .vsix 的 ZIP 结构完整性,直接修改原文件无效。
locale.json 里填 zh-cn 还是 zh-hans
填 zh-cn。这是 VSCode 主程序硬编码识别的简体中文标识,所有 UI 区域(包括设置页、终端、调试面板)都依赖它触发完整语言资源加载。
zh-hans 在部分旧版本中可触发基础翻译,但从 1.95+ 开始,它只加载少量字符串,其余界面仍为英文,且无法通过 Configure Display Language 列表选中。
- 文件路径必须是用户级配置:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容必须严格为:
{"locale":"zh-cn"}(小写、连字符、双引号、UTF-8 无 BOM) - 不要写成
zh_CN、ZH-CN、chinese或带空格的"zh-cn ",VSCode 会直接忽略
最常被忽略的一点:改完 locale.json 后,必须彻底杀掉所有后台进程(Windows 任务管理器清空 Code.exe,macOS/Linux 执行 pkill -f "Code Helper"),再重启 VSCode,否则新配置不生效。


















