必须从官方Marketplace下载MS-CEINTL.vscode-language-pack-zh-hans-*.vsix文件,校验package.json中vscode版本兼容性,解压确认含nls.js及localizations字段,通过Extensions: Install from VSIX安装,并彻底重启进程。

怎么下载真正能用的中文语言包文件
必须从官方 Marketplace 页面下载 MS-CEINTL.vscode-language-pack-zh-hans-*.vsix,其他名字、发布者不是 MS-CEINTL 的包基本无效。百度搜出的网盘链接、exe 封装器、第三方镜像站打包的“汉化包”,90% 已过期或带静默行为。
正确路径是打开插件市场页面 → 拉到最底部 → 点击 Download Extension。下载后文件名形如 MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix,这是唯一可信来源。
- 别信“Chinese Language Pack”这种模糊命名,只认 ID:
ms-ceintl.vscode-language-pack-zh-hans - 右键解压 .vsix(它本质是 zip),打开里面的
package.json,检查"engines": {"vscode": "^1.104.0"}是否与你本地code --version输出的主版本号匹配(如1.104.2→ 取1.104) - 不匹配时不要硬装,否则会静默失败或报
Extension is not compatible
如何验证 vsix 文件是否完整且签名有效
VS Code 自 1.85+ 对扩展签名校验更严格,离线环境下若跳过签名验证,可能加载失败但无提示。重点看两个地方:
- 解压后的
extension/package.json中必须包含"contributes": {"localizations": [...]}字段,缺失说明不是官方语言包 - 检查根目录是否有
vs/nls.js或out/nls.js—— 这是 VS Code 1.76+ 启动时注入翻译逻辑的关键模块,旧版包(≤1.75)没有这个,离线安装后界面仍为英文 - Windows 下别用资源管理器双击解压再重打包,会破坏 ZIP 结构;推荐用
7-Zip或 PowerShell 的Expand-Archive+Compress-Archive
要不要提前准备 locale.json 或 settings.json
不用提前写配置文件。离线安装阶段只管把 .vsix 文件准备好,locale.json 是安装后手动设置环节才需要的,且必须在安装完成、重启前创建——提前放好反而容易因格式错误(比如大写 ZH-CN、下划线 zh_CN、BOM 头)被 VS Code 忽略。
真正要提前确认的是路径:
- 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)。多一个空格、换行或引号都会导致失效。
能不能直接拷贝别人电脑上的 extensions 文件夹
不能。把 ms-ceintl.vscode-language-pack-zh-hans-1.104.2 整个文件夹复制到自己机器的 .vscode/extensions/ 目录下,VS Code 启动时不会识别它——缺少 .metadata 注册记录,也不会出现在扩展列表里,状态栏右下角依然显示 en。
这不是文件存在与否的问题,而是 VS Code 的激活机制依赖安装器写入的元数据。离线环境唯一可靠动作,就是把下载好的 .vsix 文件传过去,然后通过命令面板执行 Extensions: Install from VSIX。
最容易被忽略的一点:安装完必须彻底退出所有 VS Code 进程(包括后台的 Code Helper),再重新启动,否则语言资源根本不会加载。


















