CMake使用FetchContent拉取Git依赖后如何避免detached head状态

CMake 3.18版本对FetchContent的Git拉取逻辑做了调整，当GIT_TAG指定为分支名时，默认会直接检出该分支对应的远程提交哈希，而非创建本地跟踪分支，目的是避免上游分支强制推送后本地缓存内容不一致的问题，这就是3.17.2版本无该问题、3.21.1版本出现分离头指针的核心原因。

方案1：使用内置参数调整拉取策略（推荐） #

3.18及以上版本新增了GIT_REMOTE_UPDATE_STRATEGY参数，设置为REBASE即可让拉取完成后自动切换到本地跟踪分支，而非进入分离头状态，修改后的配置如下：

FetchContent_Declare(my_subproject
    GIT_REPOSITORY http://127.0.0.1/my_subproject.git
    GIT_TAG master
    GIT_REMOTE_UPDATE_STRATEGY REBASE
)

FetchContent_GetProperties(my_subproject)
if(NOT my_subproject_POPULATED)
    FetchContent_Populate( my_subproject )
endif()

target_link_libraries ( ${EXE_TARGET} my_subproject )

方案2：手动执行Git命令切换分支（兼容性更强） #

如果需要适配多版本CMake，或者需要更灵活的分支控制，可以在FetchContent_Populate执行完成后，手动调用Git命令切换到本地master分支：

FetchContent_GetProperties(my_subproject)
if(NOT my_subproject_POPULATED)
    FetchContent_Populate(my_subproject)
    # 手动切换到本地master分支
    execute_process(
        COMMAND git checkout master
        WORKING_DIRECTORY ${my_subproject_SOURCE_DIR}
        RESULT_VARIABLE GIT_CHECKOUT_RESULT
    )
    if(NOT GIT_CHECKOUT_RESULT EQUAL 0)
        message(FATAL_ERROR "切换my_subproject到master分支失败")
    endif()
endif()

如果你的项目需要兼容3.18以下的CMake版本，推荐使用方案2，该方案不受FetchContent内置逻辑调整影响，适配性更广。

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