如何用CMake检查Bash Shell可用性及脚本执行方式？

要在跨平台项目中可靠运行Bash脚本，CMake提供了find_program命令来定位Bash解释器，再根据检测结果确定脚本的执行方式，具体步骤如下：

1. 检测系统中的Bash解释器 #

使用find_program命令搜索系统中的Bash可执行文件，覆盖常见平台的命名规则：

# 搜索Bash可执行文件，支持Unix/Linux的bash和Windows下的bash.exe
find_program(BASH_EXECUTABLE
    NAMES bash bash.exe
    DOC "Path to Bash interpreter"
)

2. 验证检测结果并处理异常 #

如果未找到Bash，直接抛出错误提示用户安装（比如Windows下推荐Git Bash、WSL或Cygwin）：

if(NOT BASH_EXECUTABLE)
    message(FATAL_ERROR "Bash interpreter not found. Please install Bash (e.g., Git Bash, WSL, or Cygwin on Windows) to run the required scripts.")
endif()

3. 确定脚本的执行方式 #

无论平台如何，只要找到Bash，统一用Bash解释器直接调用脚本的方式运行，避免依赖系统默认的脚本执行逻辑（Windows下无法直接识别.sh文件）：

• 对于代码生成类脚本，可以通过add_custom_command或add_custom_target集成到构建流程：

# 示例：运行代码生成脚本
add_custom_command(
    OUTPUT generated_code.h generated_code.cpp
    COMMAND ${BASH_EXECUTABLE} ${CMAKE_SOURCE_DIR}/scripts/generate_code.sh
    DEPENDS ${CMAKE_SOURCE_DIR}/scripts/generate_code.sh
    COMMENT "Generating code with Bash script..."
)

# 将生成的文件关联到目标
add_executable(my_target main.cpp generated_code.h generated_code.cpp)

4. 额外优化：确保脚本的可执行权限（仅Unix类系统） #

在Unix/Linux下，脚本需要具备可执行权限才能被解释器正确处理，可以用CMake的file命令自动设置：

if(UNIX)
    file(CHMOD ${CMAKE_SOURCE_DIR}/scripts/generate_code.sh PERMISSIONS OWNER_EXECUTE OWNER_READ OWNER_WRITE)
endif()

特殊情况处理 #

• Windows下如果使用WSL的Bash，find_program会自动定位到WSL的bash.exe（需确保WSL已加入系统PATH）；
• 若项目允许降级处理（比如无Bash时跳过脚本执行），可将FATAL_ERROR改为WARNING，并添加条件逻辑跳过相关构建步骤。

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