vscode插件装不上主因是网络连通性、路径配置或状态未同步；应优先界面安装，及时切代理、重启窗口、拖.vsix文件，并验证id、版本及强制启用。
VSCode 插件装不上，八成不是插件问题，而是网络、路径或状态没对齐——直接在界面点 Install 最稳，但得知道什么时候该切代理、什么时候必须重启窗口、什么时候得拖 .vsix 文件。
Ctrl+Shift+X 搜不到插件？先看是不是市场连不上
搜索框空着、列表一直“Loading…”、或者只显示“已安装”里的几个旧插件，大概率是 VS Code 根本没连上官方市场 https://marketplace.visualstudio.com。国内直连超时很常见，界面不报错，只默默失败。
- 打开设置（
Ctrl+,），搜extensions.autoCheckUpdates和extensions.autoUpdate，确保两个都为true - 检查是否误点了 Extensions 视图右上角的标签页——如果当前是 “已禁用” 或 “已安装”，新插件不会出现，点回第一个 “Search Extensions in Marketplace” 标签
- 需要代理时，在
settings.json里加这两行（端口按你本地代理调）："http.proxy": "http://127.0.0.1:7890",<br>"http.proxyStrictSSL": false
点 Install 没反应？可能是权限、版本或禁用状态卡住了
按钮变灰、点击无反馈、装完图标还是灰色——不是 UI 卡了，而是插件根本没激活。尤其是语言类插件（如 ms-python.python）或服务器型插件（如 ms-vscode.vscode-typescript-next），不重启窗口等于没装。
- 装完务必执行
Developer: Reload Window（Ctrl+Shift+P输入后回车），不能只靠右下角提示点“重启” - 检查插件是否被工作区禁用：左下角齿轮图标 →
Extensions→ 找到插件 → 右上角若显示Disable (Workspace)，说明它在当前项目里被关掉了 - 点进插件详情页（右上角
…→Extension Details），滚动到底部看engines.vscode字段，比如"^1.85.0"表示最低要 VS Code 1.85，旧版本装了也起不来
用 code --install-extension 命令装不生效？三个条件缺一不可
这个命令不是“输完就装好”，它依赖 CLI 路径、进程状态和插件存在性三者同步。批量脚本里失败，基本栽在这三处。
- 运行
where code（Windows）或which code（macOS/Linux），输出路径必须指向你正在用的 VS Code 安装目录；如果没输出或指向旧版，先在 VS Code 里执行Shell Command: Install 'code' command in PATH - 已打开的窗口不会自动加载新插件，命令执行完必须手动
Developer: Reload Window或完全退出重开 - 如果插件已存在但被禁用，
code --install-extension默认不启用它，加--force参数强制覆盖，例如：code --install-extension esbenp.prettier-vscode --force
离线装多个插件？别一个个拖，用命令行批处理
内网机器、教学环境、CI 构建机这些没外网的地方，手动拖 .vsix 效率低还容易漏。VS Code 原生支持多文件命令行安装，失败会明确报错，比 GUI 更可控。
- 把所有
.vsix文件放到同一目录下，比如./extensions/ - 终端进入该目录，执行：
code --install-extension ./prettier-vscode-9.10.0.vsix \<br> --install-extension ./eslint-8.56.0.vsix \<br> --install-extension ./volar-1.12.0.vsix
- 注意路径必须带
./或绝对路径，不能只写文件名；每条命令最多支持 10 个--install-extension，超了就分批 - 如果提示
not compatible with VS Code '1.79.2'，说明插件要求更高版本，得先升级 VS Code
最常被忽略的是：插件 ID 不等于名字，python 搜索结果第一未必是 ms-python.python；装完不看右下角提示、不 reload window，等于白装；卸载插件后配置还在，下次重装会沿用旧设置，行为就不可预期。
