必须从VS Code官方市场下载带ms-vscode前缀的cpptools.vsix，GitHub Releases文件名无publisher会导致安装失败；安装后还需手动部署对应平台的语言服务二进制包至dist目录，否则出现“未找到定义”等错误。
cpptools.vsix 下载必须核对 publisher 和 platform 后缀
直接从 GitHub Releases 页面下载 cpptools-linux.vsix 或 cpptools-win32-x64.vsix 很容易出错——因为 Release 页的文件名不带 publisher，而 VSCode 安装时会校验 package.json 中的 publisher 字段是否匹配。官方市场下载的文件名是 ms-vscode.cpptools-1.19.10.vsix，其中 ms-vscode 是强制要求的 publisher ID。
错误示例：用 cpptools-linux.vsix 执行 code --install-extension 会静默失败或报 INVALID_EXTENSION，但无明确提示。
- 正确做法：在有网机器访问 https://www.php.cn/link/b18c1cc30ee2dc3e94d02de588420392，点右侧 Download Extension —— 生成的 URL 带签名且含完整 ID
- 备用方案：用官方 API 拼地址：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-vscode/vsextensions/cpptools/1.19.10/vspackage（把版本号替换成你查到的最新稳定版） - 别信 GitHub Release 页的“Latest”标签：它可能滞后 1–2 周，且未同步语言服务组件更新
安装后“未找到定义”不是插件没装好，而是 language server 没离线部署
很多人以为 code --install-extension ms-vscode.cpptools-1.19.10.vsix 跑完就万事大atis，结果打开 C++ 文件还是满屏红色波浪线。这是因为 cpptools 插件启动时会尝试下载独立的 C/C++ language components 包（比如 cpptools-srv-win32-x64.exe），而这个包根本不在 .vsix 里。
现象特征：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 输出面板（
Ctrl+Shift+U）→ 切换到C/C++日志 → 出现Downloading package 'C/C++ language components (Windows)' Failed - 鼠标悬停无提示、
F12跳转失效、Go to Definition灰掉
解决方法：必须手动下载对应平台的语言服务二进制包，并放入插件目录的 dist 子目录：
- Windows：从 marketplace 下载的 .vsix 解压后，在
extension/dist/下放cpptools-srv-win32-x64.exe - Linux：放
cpptools-srv-linux-x64（注意无扩展名，且需chmod +x） - 这些二进制包同样要从 marketplace 页面获取 —— 进入插件详情页 → 点 “Resources” → 找 “Language Server” 链接（不是 GitHub）
code --install-extension 在内网失败的三个真实原因
命令行安装看似最干净，但在离线环境里最容易卡住或无声失败。报错往往只有一行，但根因集中在以下三点：
-
code命令不可用：不是 PATH 没配，而是 VSCode 从未执行过Shell Command: Install 'code' command in PATH（通过Ctrl+Shift+P调出命令面板运行） - 证书验证失败：内网机器缺少微软根证书链，导致安装时校验签名失败，必须加
--allow-unverified参数：code --install-extension cpptools.vsix --allow-unverified - 插件已存在但版本冲突：如果之前试装过旧版，VSCode 不会覆盖，也不会提示。先执行
code --uninstall-extension ms-vscode.cpptools再重装
WSL 或远程开发场景下，插件要装在服务端而非本地 VSCode
如果你用 VSCode 连 WSL、SSH 或容器，code --install-extension 默认装在本机，对远程环境完全无效。这时候必须把 .vsix 和 language server 二进制都放到远程目标系统的扩展目录里。
关键路径差异：
- 本地 Windows：
%USERPROFILE%\.vscode\extensions\ - WSL Ubuntu：
~/.vscode-server/extensions/（注意不是~/.vscode/extensions） - SSH 目标机：
~/.vscode-server/extensions/，且目录名必须是ms-vscode.cpptools-1.19.10（publisher + name + version 全匹配）
最容易忽略的一点：解压 .vsix 后，里面有个 extension/ 子目录，所有文件都在这下面；必须把 extension/* 的内容整体移到扩展目录根路径，不能保留 extension/ 这层嵌套，否则插件加载失败且无日志。
