离线安装vscode插件失败的主因是隐性条件不满足：拖拽需vscode有焦点、非全屏、拖原生.vsix文件；cli需注册code命令；手动复制须解压并按扩展id命名目录；功能不显则查版本兼容、工作区禁用、lsp依赖及权限弹窗。
离线环境装不上插件，大概率不是操作错了，而是版本、路径或校验环节卡在某个隐性条件上。直接拖进主窗口最稳，但必须满足三个前提：VSCode 有焦点、没全屏、拖的是原生 .vsix 文件。
拖拽安装为什么有时没反应
这是离线场景下最高频的“假失败”。VSCode 对拖放事件非常敏感，不报错也不提示，只静默忽略。
- VSCode 窗口未获得系统焦点：点击编辑器任意空白处再试，看任务栏图标是否高亮
- 处于全屏模式或远程桌面（如 RDP / TeamViewer）：这类环境常拦截拖放，退出全屏或改用命令面板
- 拖的是解压后的文件夹、
.zip或被杀毒软件重命名的文件（如prettier.vsix.zip）：用unzip -l prettier.vsix确认顶层目录是extension/ - 企业策略禁用了扩展安装：右下角状态栏若显示
Extensions disabled by policy，只能联系管理员或换用 CLI 安装
code --install-extension 命令总提示 command not found
这不是网络问题，是 VSCode CLI 工具没注册到系统路径。图形界面里点几次都没用，必须手动触发注册流程。
- 先确保 VSCode 已完全关闭（Windows 查任务管理器是否有
code.exe进程，macOS/Linux 运行code --status） - 重新打开 VSCode，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Shell Command: Install 'code' command in PATH并执行 - 重启终端，再运行
code --version验证是否返回正常版本号 - 路径含空格或中文时，必须用英文双引号包裹：
code --install-extension "/path/to/my ext.vsix"
手动复制 .vsix 到 extensions 目录为何不生效
VSCode 不会自动解压 .vsix 文件——直接复制进去等于白放。它只识别已解压、且目录名严格匹配扩展 ID 的子文件夹。
- 先解压：
unzip your-extension.vsix -d unpacked，然后用ls unpacked/看顶层目录名（如ms-python.python-2024.6.0） - 确认用户 extensions 路径：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\
macOS：$HOME/Library/Application Support/Code/Extensions/
Linux：$HOME/.vscode/extensions/ - 把整个
ms-python.python-2024.6.0/目录复制进去，不能只复制里面的内容，也不能保留.vsix文件本身 - 复制完必须彻底退出 VSCode（包括托盘进程），否则缓存不刷新，插件不会加载
插件装上了但功能不出现，该查什么
离线环境最麻烦的不是装不上，而是“装了却像没装”。这种问题往往没有错误提示，只表现为快捷键无效、语言服务不启动、设置项不出现。
- 检查
package.json中的"engines": {"vscode": "^1.80.0"}：用code --version得到1.85.2是 OK 的，但1.79.2就会被静默跳过 - 确认是否被工作区禁用：左下角齿轮 →
Extensions→ 找到插件 → 右上角是否显示Disable (Workspace) - 语言类插件（如 Python、Rust）依赖 LSP 服务器，离线时需一并下载对应
.vsix（例如ms-python.vscode-pylance），并按依赖顺序安装 - 某些插件（如 ESLint）首次启用会弹权限确认框，如果 VSCode 在后台运行，这个弹窗可能被挡住，导致你以为它没反应
离线插件管理真正的复杂点不在安装动作本身，而在版本对齐和依赖链还原。一个 .vsix 文件看似独立，其实可能暗含对另一个插件、特定 Node.js 版本甚至原生二进制模块的强依赖。别信“下载即用”，先 unzip -p xxx.vsix extension/package.json | grep engines，再动手。
