VSCode没有独立“离线文档包”，中文界面与内置帮助内容均由官方语言包（vscode-language-pack-zh-hans）提供，其包含的翻译覆盖命令面板提示、快捷键说明及设置项描述等，随主程序下发，无需额外下载。
VSCode离线文档包不是独立插件，而是语言包的一部分
VSCode 本身没有叫“离线文档”的官方扩展。你真正想装的，是中文界面 + 内置帮助文档的组合效果——这依赖两个东西：一是 vscode-language-pack-zh-hans（中文语言包），二是 VSCode 主程序自带的离线帮助系统（即 Help → Show All Commands / Command Palette 里的所有提示、快捷键说明、设置项描述等）。这些内容随 VSCode 安装包一起下发，无需额外下载。
怎么拿到能用的中文语言包 .vsix
必须从官方市场直链下载，其他来源基本不可靠：
- 打开 https://marketplace.visualstudio.com/items?itemName=ms-ceintl.vscode-language-pack-zh-hans
- 滚动到页面最底部，点 Download Extension 按钮（不是 GitHub Release 或镜像站链接）
- 下载文件名形如
MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix，注意 publisher 必须是ms-ceintl - 右键解压该 .vsix，打开
package.json，核对"engines": {"vscode": "^1.104.0"}是否匹配你本地code --version输出的主版本号（如 1.104.2 → 匹配 ^1.104.0）
装上后为什么还是英文？关键检查点
离线环境里语言包“装上了但不生效”是高频问题，原因往往不在安装步骤，而在环境干预：
- Windows 上若系统区域设为 English (United States) 并勾了 Beta: Use Unicode UTF-8 for worldwide language support，VS Code 会跳过加载中文资源
- macOS/Linux 下运行
echo $LANG，若输出en_US.UTF-8，需临时执行export LANG=zh_CN.UTF-8再启动 VS Code -
settings.json里残留过时的"locale": "zh-CN"字段会导致冲突，必须手动删掉 - 双击或拖拽 .vsix 文件在 VS Code 1.70+ 已失效，必须用命令面板执行
Extensions: Install from VSIX
离线部署前最后一步：禁用自动更新
装完语言包后，立刻关掉自动更新，否则下次启动可能触发联网校验或覆盖：
- 打开 Settings（Ctrl+,），搜索
update mode，设为none - 打开 Extensions 面板，点击右上角 … →
Disable Auto Updating Extensions - 如果是在企业内网，还要确认没被组策略禁用：
Extensions disabled by policy出现在右下角就说明已锁死
真正难的不是下载或安装，而是把语言包、系统 locale、VSCode 版本、组策略这四者对齐。漏掉任意一环，就会出现“文件明明在 extensions 目录里，但状态栏和菜单死活不换中文”的情况。
