如何在使用低于3.19版本CMake的--preset时返回有效错误提示？

以下是几个实用技巧，帮你给用户抛出清晰的版本错误提示：

1. 用包装脚本前置检查CMake版本 #

写一个简单的脚本（bash或Windows批处理）作为CMake的入口，先验证版本再执行命令：

Bash脚本示例（cmake-preset.sh） #

#!/bin/bash

# 提取CMake主版本和次版本
CMAKE_VERSION=$(cmake --version | grep -oP 'cmake version \K\d+\.\d+' | cut -d. -f1,2)
REQUIRED_VERSION="3.19"

# 版本比较
if [[ $(printf "%s\n%s" "$CMAKE_VERSION" "$REQUIRED_VERSION" | sort -V | head -n1) != "$REQUIRED_VERSION" ]]; then
    echo "错误：本项目需要CMake 3.19或更高版本，当前版本为$CMAKE_VERSION"
    echo "请升级CMake后再使用--preset参数"
    exit 1
fi

# 版本符合，转发原命令参数
exec cmake "$@"

让用户运行./cmake-preset.sh --preset ValidPreset替代直接调用cmake，脚本会先拦截版本检查，避免旧版本把预设名当成源目录。

2. 利用占位目录触发正确的版本检查 #

旧版本CMake会把--preset后的参数当成源目录路径，你可以：

• 为项目中所有预设名创建对应的空目录（比如ValidPreset/）
• 在每个占位目录里放一个极简的CMakeLists.txt：

cmake_minimum_required(VERSION 3.19 FATAL_ERROR)
message(FATAL_ERROR "本项目需要CMake 3.19+才能使用预设功能，当前CMake版本过低")

当用户用旧版本运行cmake --preset ValidPreset时，CMake会读取该目录下的配置文件，触发版本检查并抛出清晰提示，替代误导性的"源目录不存在"错误。

这个方法无需额外脚本，缺点是如果预设较多，需要维护多个占位目录。

3. 项目文档醒目标注要求 #

在README或项目文档开头，明确说明"使用预设功能需要CMake 3.19及以上版本"，同时附上升级指引。虽然不能主动拦截错误，但能提前帮用户避开坑。

内容的提问来源于stack exchange，提问作者Luca