| name | CMake Configure |
| description | 需要在 ds-editor-lite 中运行 CMake configure、刷新 CMake preset 或验证 Qt/vcpkg 配置时使用。默认使用项目提供的 VS DevShell + CMake preset 脚本;不要使用 CLion MCP run configuration。 |
CMake Configure
用于在 Windows + Visual Studio 环境下配置 C++/CMake 项目。
使用原则
- CMake configure(
cmake --preset debug)比较轻量,用于验证 Qt/vcpkg 等依赖是否安装正确、检测新增/移除的源文件。
- 如果只需要快速验证依赖,跑 configure 就够了。
- 不要使用 CLion MCP run configuration 做 configure。run configuration 会启动
DsEditorLite,GUI 程序不退出时会持续阻塞 Agent。
- 不要手写 Visual Studio 安装路径,也不要使用带
* 的 VS DevShell 示例路径。
- 如需完整构建(包含 configure),使用
cmake-build skill。
推荐命令
powershell -NoProfile -ExecutionPolicy Bypass -File .agents/skills/scripts/run-cmake-preset.ps1 -Mode Configure -Preset debug
脚本行为
- 通过
vswhere.exe 优先查找 Visual Studio 2026 / 18.x 的 C++ 工具链。
- 如果
vswhere 找不到 VS 18.x,会先回退到安装了 C++ 工具链的最新 VS,再枚举 C:\Program Files\Microsoft Visual Studio\18|17\*\VC\Auxiliary\Build\vcvarsall.bat。
- 使用
vcvarsall.bat x64 初始化编译环境。
- 若
QT_DIR 未设置,会尝试自动选择 C:\Qt\*\msvc2022_64 中版本号最高的目录。
- 在同一个
cmd.exe 命令链里执行环境初始化和 CMake,避免 VS DevShell 环境丢失。
失败处理
- 找不到 VS、Qt 或 preset 失败时,直接报告脚本输出中的具体错误。
- 不要改用 CLion run configuration 兜底。
- 不要改用硬编码的个人路径兜底。