必须通过命令面板执行“Extensions: Install from VSIX”安装.vsix文件，双击或拖拽在VSCode 1.70+中已禁用且静默失败；安装后需手动启用或重启，并确保locale配置为"zh-cn"后彻底重启。
用命令面板安装.vsix必须手动触发，双击/拖拽无效
VSCode 1.70+ 版本已禁用双击或拖拽 .vsix 文件的自动安装行为——它会静默失败，不报错也不提示。唯一可靠路径是通过命令面板调用内置安装器。这不仅是离线环境的标准做法，也是避免因权限、焦点或路径问题导致安装“看似成功实则未注册”的关键步骤。
操作流程很直接：Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）→ 输入 Extensions: Install from VSIX → 回车 → 在弹出的文件选择框中定位并选中你的 .vsix 文件 → 点击 Install。
- 安装后插件默认处于禁用状态，需手动点击右上角
Enable，或重启 VSCode 才能生效 - 如果选中文件后无反应，请检查 VSCode 是否处于全屏、远程桌面连接中，或窗口未获得系统焦点
- 该命令不校验签名，但会严格检查
package.json中的engines.vscode字段；版本不匹配时会直接拒绝安装，且不给出详细错误
安装后功能不出现？先查这三个地方
装完看不到插件图标、命令或设置项，大概率不是安装失败，而是环境没对齐。重点排查以下三处：
- 打开命令面板，输入
Developer: Show Running Extensions—— 这比看扩展面板更准，能确认插件是否真正加载运行 - 在扩展面板搜索插件名，看右上角是否显示
Disable (Workspace)或Disable (Remote)；当前工作区或远程连接可能单独禁用了它 - 按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 切到 Console 标签页，筛选error或warn，常见报错如Extension 'xxx' depends on extension 'yyy' which is not installed
中文语言包要特别注意 locale 配置值
离线安装 vscode-language-pack-zh-hans-*.vsix 后，必须额外执行 Configure Display Language 并明确选择 zh-cn（小写，带连字符），再重启。填 zh-hans 或 zh_CN 都可能失效——VSCode 主程序只认 zh-cn 作为简体中文的显示语言标识，这是内部语言协商机制决定的，不是拼写偏好问题。
- 配置位置：命令面板 →
Configure Display Language→ 下拉选zh-cn→Restart - 验证方式：重启后看右下角状态栏是否显示中文，以及设置页、调试面板、命令面板是否全部转为中文
- 若仍为英文，检查是否残留后台进程：彻底退出 VSCode（包括右下角托盘图标），再重新打开
命令行 code --install-extension 不等于图形界面安装
虽然都叫“安装”，但命令行方式和命令面板方式的行为有实质差异：前者只把文件解压进 extensions/ 目录，不触发激活逻辑；后者会走完整注册流程，包括依赖解析、权限提示、首次启用钩子等。所以即使你用 code --install-extension 成功返回，也仍需手动启用或重启。
- 必须用绝对路径：例如
code --install-extension /home/user/ext/prettier-3.2.5.vsix；相对路径在非 VSCode 启动的终端里极易失败 - Windows 下路径含空格或中文时，务必用双引号包裹：
code --install-extension "C:\my ext\python-2024.6.0.vsix" - 遇到
INVALID_SIGNATURE错误（内网常见），加--allow-unverified参数绕过签名校验：code --install-extension --allow-unverified /path/to/ext.vsix
真正卡住人的，往往不是“怎么装”，而是“装完为什么没反应”。很多插件依赖其他扩展、特定 workspace 配置、甚至操作系统级 locale 设置，这些都不会在安装阶段报错，却让功能彻底静默。动手前花三十秒解压 .vsix 查看 package.json 里的 extensionDependencies 和 engines.vscode，比反复重启高效得多。
