手动下载插件装不上，主因是vscode未识别安装意图，需同时满足焦点、路径、版本、策略四条件：工作区已加载、拖入主编辑区、.vsix文件完整且版本兼容、无组策略禁用；离线时语言插件还需同步lsp服务器等依赖。
手动下载的插件装不上，大概率不是文件问题，而是 VSCode 没“认出你真想装它”——焦点、路径、版本、策略，四者缺一不可。
从 Marketplace 下载 .vsix 文件时，别点错按钮
官网插件页右侧的 “Download Extension” 是唯一可靠入口；点“版本历史”后每个版本旁的下载图标也有效。但注意：Download Extension 按钮有时藏在折叠区域里，需滚动到底部或点开“Resources”才可见。别用浏览器另存为当前页面，也别右键另存链接——那只是 HTML 页面，不是 .vsix 文件。下载完成后，检查文件大小：正常插件一般 1–15 MB，若只有几十 KB，基本是网页快照，直接丢弃。
code --install-extension 命令失败的三个硬性条件
这个命令看似简单，实际依赖三个前提同时满足：
- 终端中运行
code --version必须有输出；若报command not found，先在 VSCode 里按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 路径必须是绝对路径，且含空格或中文时得用英文双引号包裹，例如：
code --install-extension "/home/user/下载/python-2024.6.0.vsix" -
.vsix文件不能被重命名后缀（如把.zip改成.vsix），否则文件头损坏，安装会静默失败；可用unzip -t xxx.vsix校验完整性，输出OK才可信
拖进 VSCode 主窗口没反应？先看这三件事
图形界面拖拽是最直观的方式，但失效非常隐蔽：
- VSCode 必须已打开一个文件或文件夹（即工作区已加载），纯空白启动页不响应拖放
- 拖的目标区域只能是编辑器主内容区（代码显示区），拖到侧边栏、设置页、扩展面板本身都无效
- 右下角状态栏若显示
Extensions disabled by policy，说明系统组策略禁用了扩展——此时 GUI 和 CLI 全部失效，只能手动解压到$HOME/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows），且解压后目录名必须与.vsix内package.json中的name字段完全一致
装上了但插件不工作？语言类插件有隐藏依赖
Python、Rust、TypeScript 等语言插件安装后首次启用，会自动下载对应语言服务器（如 pyright、rust-analyzer）。这些组件默认走外网，离线环境会卡在状态栏“Downloading…”或输出面板报 spawn ENOENT。解决方法不是重装插件，而是在有网机器上用同一版本 VSCode 安装该插件 → 等待其完成首次下载 → 进入 $HOME/.vscode-server/data/Machine（远程）或 $HOME/.vscode/extensions/xxx-*/out/（本地）找到已下载的二进制文件，一并复制过去。
