先验证.vsix完整性与版本兼容性：用unzip -t校验是否损坏，再用unzip -p查package.json中"engines": {"vscode": "^1.85.0"}是否≥本地code --version主版本号，并确认架构（如darwin-arm64）匹配；拖拽需vscode已加载工作区、有焦点且拖入主编辑区；命令行安装须code已加入path、路径加引号、用--force可强制覆盖；语言插件离线需整目录迁移含lsp二进制的扩展文件夹。
离线获取 VSCode 插件库（即 .vsix 文件）本身不难，真正卡住人的永远是“下了却装不上”——核心矛盾不在下载路径，而在版本、架构、签名三重校验没过。
怎么确认 .vsix 文件是否真的能用
别急着拖进 VSCode。先用命令行快速验证两个硬性条件：
- 运行
unzip -t your-extension.vsix，报错说明压缩包损坏（常见于浏览器中断下载或杀毒软件拦截重命名） - 运行
unzip -p your-extension.vsix extension/package.json | grep engines，检查输出中"vscode": "^1.85.0"这类字段，和你本地code --version输出的第一段（如1.90.2→ 取1.90）是否满足 ≥ 关系 - 再看 VSCode 关于页里括号内的架构标识（
darwin-arm64/win32-x64），必须和.vsix文件名或其package.json中声明的平台一致；ARM Mac 上装 x64 插件会静默失败
拖拽安装没反应？先盯住这三个状态
VSCode 图形界面拖拽不是“点一下就完事”，它依赖三个隐式前提同时成立：
- VSCode 必须已加载工作区：空白启动页（没打开文件夹/文件）完全不响应拖放；先按
File → Open Folder打开任意目录再试 - 拖放目标必须是编辑器主区域（白底代码区），不是侧边栏、设置页、扩展面板本身，也不是标题栏
- VSCode 窗口必须获得系统焦点：任务栏图标未高亮时，拖入无效；全屏模式或远程桌面（RDP/TeamViewer）常拦截拖放事件，临时退出全屏再试
命令行安装失败时，错误信息其实说了实话
code --install-extension 报错不糊弄人，关键看终端输出：
- 提示
ENOENT：不是路径写错，而是code命令根本没加入PATH—— 重新打开 VSCode，按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用 - 提示
Extension is not compatible：版本或架构不匹配，不是网络问题，解压.vsix查package.json即可定位 - 提示
Extension 'xxx' not found in the marketplace：你输的是插件显示名（如Python），不是 ID（ms-python.python）；用code --list-extensions --show-versions获取准确 ID - 路径含空格或中文？必须加英文双引号：
code --install-extension "C:\my ext\prettier.vsix"
语言类插件（如 Python、Prettier）离线后功能不全怎么办
这类插件安装后首次启用时，会自动下载 LSP 服务器或 CLI 二进制（如 pyright、prettier），离线环境直接卡死或报 spawn ENOENT。
- 不能只拷
.vsix，得在有网机器上完整安装一次，然后把整个插件文件夹（如ms-python.python-2024.6.0）复制过去 - 目标路径必须准确：
– Windows：%USERPROFILE%\.vscode\extensions\
– macOS/Linux：$HOME/.vscode/extensions/ - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
- 验证是否真生效：打开对应文件（如
.py），按Ctrl+Shift+P输入Python: Select Interpreter，能调出即正常；若卡在“Downloading…”或输出面板报Failed to fetch，说明依赖没到位
最易被忽略的一点：VSCode 对不兼容插件的处理是“静默跳过”，既不报错也不提示，列表里显示已安装，但所有功能都不可用。遇到这种情况，第一反应不该是重装，而是立刻解压 .vsix 查 package.json 里的 engines.vscode 和本地版本对齐与否。
