CMake Better

CMake Better 是一个跨平台 VS Code 插件，提供接近 Visual Studio 的 CMake 项目体验：

• 可视化新建 C++/CMake 项目（支持 C++11 及以上标准）
• 一键导入第三方库（支持“库名 + 库目录”自动配置）
• 一键下载安装当前平台工具链（GCC + GDB + CMake + Ninja）
• 构建/运行/调试统一使用插件配置的工具链目录
• 检测系统切换并提示重新链接依赖

开发

npm install
npm run compile

按 F5 启动扩展调试主机。

打包 VSIX

npm run package

第三方库导入（推荐流程）

1. 点击 导入第三方库
2. 选择 按库目录自动配置 (推荐)
3. 输入库名称
4. 选择库根目录
5. 插件自动识别 include/lib/Config.cmake 并写入 CMakeLists.txt

若自动识别失败，可选择 高级手动配置。

工具链安装与使用

1. 点击 安装工具链
2. 选择安装位置
3. 插件自动下载并解压当前平台工具链
4. 安装完成后自动写入 cmakeBetter.toolchainInstallDir
5. 安装成功后自动清理下载缓存（.downloads/.staging）

工具链目录会按平台生成子目录，例如：

• <installDir>/cmake-better-toolchains/win32-x64
• <installDir>/cmake-better-toolchains/linux-x64
• <installDir>/cmake-better-toolchains/darwin-arm64
• <installDir>/cmake-better-toolchains/darwin-x64

后续构建、运行、调试将优先使用该目录，不依赖系统默认编译器。

macOS 上 gdb 可能需要额外 codesign，详见： https://sourceware.org/gdb/wiki/PermissionsDarwin

下载镜像源

工具链下载统一为两种源，配置项：

• cmakeBetter.toolchainMirrorSource = domestic（默认）：使用聚合国内源，编译器、CMake 和 Ninja 按文件独立选择可用下载节点，凑齐整套后安装；单个文件的国内候选全部失败时才回退官方。
• cmakeBetter.toolchainMirrorSource = official：只使用官方源

说明：

• 国内源是一个整体，内部会对完整副本和 GitHub 加速节点进行可用性检查，不再让用户区分清华、中科大或其他单一镜像。
• 每个归档下载后都会检查响应类型、完整性、归档格式和已配置的 SHA-256，不会把 HTML 错误页当成工具链。