.vsix插件可直接拖入VS Code安装，常见失败原因包括文件重命名、VS Code版本过低、依赖未满足；命令行code --install-extension支持批量部署，需用绝对路径；安装后需手动启用并检查配置。
插件文件是 .vsix，直接拖进 VS Code 窗口就能装
VS Code 不走市场下载时（比如公司内网、离线环境），你拿到的插件是单个 .vsix 文件。它本质是个 ZIP 包，但不用解压——VS Code 原生支持拖拽安装。
常见错误现象：Extension is not a valid vsix 或安装后不生效，多半因为：
- 文件被重命名过（比如加了中文、空格、
.zip后缀），必须保持原始.vsix后缀 - VS Code 正在运行旧版本，而插件要求新 API（比如用了
vscode@1.85+的 API，但你本地是 1.79） - 插件依赖其他扩展（如某些主题依赖
vscode-icons），但没一并安装
命令行安装 .vsix：用 code --install-extension
适合批量部署或脚本化场景，比拖拽更可控，还能看到报错细节。
使用场景：CI 流水线预装插件、多台机器统一配置、自动化运维。
实操建议：
- 路径必须写绝对路径，相对路径容易失败，比如：
code --install-extension /home/user/download/eslint.vsix - Windows 下注意反斜杠转义或用正斜杠：
code --install-extension C:/download/prettier.vsix - 如果提示
command 'code' not found，先在 VS Code 里按Ctrl+Shift+P，输入Shell Command: Install 'code' command in PATH回车启用 - 安装后不会自动启用，需重启窗口或手动启用插件
插件装完没反应？检查 extensions 目录和启用状态
VS Code 插件默认装在用户数据目录下，不是项目目录里。装完不生效，常因路径错乱或禁用。
关键路径（不同系统）：
- macOS：
~/Library/Application Support/Code/extensions/ - Windows：
%USERPROFILE%\AppData\Roaming\Code\extensions\ - Linux：
~/.vscode/extensions/
实操建议：
- 进对应目录确认插件文件夹是否存在（名字通常是
author.name-1.2.3） - 打开 VS Code，按
Ctrl+Shift+X打开扩展面板，搜索插件名，看右上角是否显示「已启用」；灰色图标 = 已禁用 - 部分插件需要特定文件类型才激活（比如
Prettier只在.js或.ts文件中生效），别在纯文本里测试
离线环境装插件，注意依赖链和 VS Code 版本兼容性
一个插件可能依赖另一个插件，或者只支持某段 VS Code 版本范围。离线时没法自动提示，得自己核对。
怎么做：
- 去插件官网（如 marketplace.visualstudio.com）查「Dependencies」和「Compatibility」字段
- 下载插件页面的「Download Extension」链接，得到的是
.vsix，不是网页 HTML —— 别误存成网页文件 - 用
unzip -l xxx.vsix | grep package.json解包看package.json，里面engines.vscode字段标明最低支持版本 - 如果 VS Code 太老，升级比硬凑兼容更省事；强行降级插件版本反而容易出错
最常被忽略的一点：插件启用依赖工作区设置或用户设置里的开关，比如 "editor.formatOnSave": true 不开，Prettier 就不会自动格式化。装完只是第一步，配置才是活的。
