拖.vsix进VSCode主窗口安装CMake Tools需满足三条件：VSCode已启动且窗口有焦点、未全屏、未连接Remote-SSH/RDP；拖入编辑器中央空白区（非侧边栏等）；路径不含中文或空格。
怎么拖.vsix进VSCode主窗口装CMake Tools
拖拽安装是离线环境下最稳的方式，但必须满足三个硬性条件，否则静默失败、毫无提示。
确保 VSCode 已启动、当前窗口有系统焦点（任务栏图标高亮）、未全屏、未连接 Remote-SSH 或 RDP；把下载好的 ms-vscode.cmake-tools-*.vsix 文件（未解压！）直接拖进编辑器中央空白区——不是侧边栏，不是设置页，不是资源管理器面板。松手后会弹出确认框，点“安装”即可。
- 如果没反应，先按
Ctrl+Shift+P输入Developer: Toggle Developer Tools看控制台有没有报错；常见原因是窗口失焦或处于远程会话 - 装完插件默认是禁用状态，必须手动点击扩展面板里的「启用」按钮，或完全退出 VSCode 再重启
- Windows 下若路径含中文或空格（如
C:\我的插件\cmake-tools.vsix），拖拽大概率失败，建议先移到C:/vsix/这类纯英文路径
用 code --install-extension 命令行安装的坑
命令行适合批量部署，但对路径、签名、进程状态极其敏感，报错即意味着明确可查的问题。
先确认 code 命令可用：在 VSCode 里按 Ctrl+Shift+P 输入 Shell Command: Install 'code' command in PATH 并执行。之后运行：
code --install-extension "C:/vsix/ms-vscode.cmake-tools-1.15.20.vsix" --allow-unverified
--allow-unverified 是关键参数，离线环境无法校验微软签名链，不加这个会卡在 INVALID_SIGNATURE 错误。
- 路径必须是绝对路径，Windows 推荐用正斜杠
/，且含空格或中文时务必加英文双引号 - Linux/macOS 路径不能写成
~/vsix/...，必须展开为/home/user/vsix/... - 执行后若
code --list-extensions不显示，大概率后台还有 Code.exe 进程残留，Windows 可用任务管理器彻底结束所有实例
手动解压到 extensions 目录的应急方案
当组策略禁用 GUI/CLI 安装，或需部署带 native 二进制（如 cmake-server）的版本时，只能直装解压后的目录。
用 unzip -l cmake-tools-1.15.20.vsix 查顶层目录名，例如 ms-vscode.cmake-tools-1.15.20/ —— 这个名字不能改，必须原样保留。解压后，把整个该文件夹复制进：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\
Linux/macOS：$HOME/.vscode/extensions/
- 不能只复制里面的内容，也不能把 .vsix 文件一起放进去
- 复制完必须彻底退出 VSCode（包括右下角托盘图标），否则扩展不会加载
- 装完打开一个 CMakeLists.txt 文件，看底部状态栏是否出现
CMake: Ready，而不是只看扩展面板里有没有勾选
为什么装了 CMake Tools 却不识别 CMake？
CMake Tools 插件本身不带 CMake 可执行文件，它只是个“调度器”。离线环境下，你必须单独准备好 cmake.exe（Windows）或 cmake（Linux/macOS），并确保它在 PATH 中。
- 下载地址：https://cmake.org/download/，选对应平台的二进制发行版（非源码），解压后把
bin/目录加进系统环境变量 - 在 VSCode 终端中运行
cmake --version，能输出版本号才算真正就位 - 插件配置里
"cmake.cmakePath"可显式指定路径，但更推荐走 PATH，避免项目级配置污染 - 注意：CMake Tools 依赖 C/C++ 扩展提供 IntelliSense，如果只装了前者，
Ctrl+Click跳转头文件可能失效
最容易被忽略的是：CMake Tools 的功能激活依赖于工作区根目录存在 CMakeLists.txt，且插件检测到 CMake 可执行文件可用——它不会主动报错，只会安静地不显示任何 UI 元素。验证前先确认这两件事是否都成立。
