插件在Marketplace搜索不到但知道ID时，应优先用“Extensions: Install Extension”命令直接输入ID安装；若失败，可切换为vscode-cn镜像源（vscode.cdn.azure.cn）或从GitHub Release下载对应系统.vsix离线安装。
插件在 Marketplace 搜索不到，但你知道它的 ID
这通常不是插件下架了，而是 VSCode 当前市场源没加载出它——比如你用的是 open-vsx.org 镜像（1.85+ 默认 fallback 行为），但某些微软官方插件（如 ms-vscode.cpptools）未同步过去；或者网络策略拦截了 marketplace.visualstudio.com，导致搜索结果为空。
直接用 ID 安装是最稳的绕过方式，前提是 VSCode 能连上至少一个可用源，或你已准备好离线包。
- 确保
extensions.autoUpdate和extensions.autoCheckUpdates在设置里是true，否则 VSCode 根本不发请求 - 打开命令面板（
Ctrl+Shift+P），输入并执行Extensions: Install Extension（注意不是 “Install from VSIX”） - 在弹出的输入框中直接粘贴插件 ID，例如
ms-python.python或esbenp.prettier-vscode - 回车后，VSCode 会尝试从当前配置的市场源拉取元数据并安装——哪怕搜索页空白，这个命令仍可能成功
如果提示 “Extension not found”，说明当前市场源确实没收录该 ID。这时就得切源或离线。
手动指定 marketplace 源后仍搜不到？试试 vscode-cn 镜像
微软没提供官方国内镜像，但社区维护的 vscode.cdn.azure.cn 是目前最稳定的替代方案，它缓存了绝大多数主流插件（包括 ms-vscode.cpptools），且协议完全兼容。
操作前先关掉 VSCode：
- 编辑用户设置文件：
%APPDATA%\Code\User\settings.json（Windows）或~/Library/Application Support/Code/User/settings.json（macOS）或~/.config/Code/User/settings.json（Linux） - 替换原有 market URL（如果存在），添加这两行（注意逗号分隔）：
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery", "extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery/publishers"
- 重启 VSCode，再试
Extensions: Install Extension+ 插件 ID
⚠️ 注意：vscode.cdn.azure.cn 不是代理中转，而是完整镜像。首次加载可能稍慢，但成功率远高于直连。
命令行 code --install-extension 失败的常见原因
这个命令看着简单，实操中失败率很高，多数不是网络问题，而是环境没对齐：
-
code命令没注册进 PATH：运行where code（Windows）或which code（macOS/Linux），若无输出，需在 VSCode 中执行Shell Command: Install 'code' command in PATH - 插件已安装但被禁用：
code --install-extension默认不启用，得加--force参数强制覆盖，例如：code --install-extension ms-vscode.cpptools --force - VSCode 正在运行且窗口未重载：新装插件不会自动激活，必须手动执行
Developer: Reload Window，或完全退出再启动 - 插件 ID 写错或版本不兼容：比如你用 VSCode 1.85，而插件
package.json里写"engines": {"vscode": "^1.90.0"}，就会静默拒绝安装
离线场景下，用 ID 找不到 .vsix 文件？去 GitHub Release 页面
很多插件（尤其是微软官方的）不再把 .vsix 放在 Marketplace 页面上，但一定在 GitHub Release 里：
- 对于 C/C++ 插件，访问
<a href="https://www.php.cn/link/760a5ceedca28c03525c58cbdb59b5d5">https://www.php.cn/link/760a5ceedca28c03525c58cbdb59b5d5</a> - 找到对应版本（如
v1.23.5），展开Assets，下载cpptools-win32.vsix（Windows）、cpptools-darwin.vsix（macOS）或cpptools-linux.vsix（Linux） - 下载后双击安装，或用命令：
code --install-extension cpptools-win32.vsix
⚠️ 关键检查点：打开 .vsix 文件（用 7-Zip 或系统归档工具），确认里面有 extension/package.json，且其中 engines.vscode 字段值 ≤ 你本地 VSCode 版本号。否则安装会失败且无明确提示。
