CMake引入Git子模块mylib时无法找到RISCV编译器求助

项目结构如下：

project
├── build
├── CMakeLists.txt
├── extern (git submodule)
│   └── mylib
│       ├── build
│       ├── CMakeLists.txt
│       └── src
└── src
    └── main.c

mylib是带有独立构建系统的Git子模块。希望在顶层项目目录执行cmake --build build时，编译project/src下的文件、构建mylib并将其链接到主项目生成的二进制文件。

尝试用add_subdirectory(extern/mylib)让CMake识别并构建子模块，执行时报错：

CMake Error at extern/mylib/CMakeLists.txt:4 (project):
  The CMAKE_C_COMPILER:

    riscv64-unknown-elf-gcc

  is not a full path and was not found in the PATH.

riscv64-unknown-elf-gcc确实在PATH中：终端可正常运行该命令，which riscv64-unknown-elf-gcc显示路径/opt/riscv/bin/riscv64-unknown-elf-gcc已包含在$PATH变量中，同时CMAKE_CXX_COMPILER也存在相同错误。

请问当前方法是否有误？应如何正确引入这个Git子模块依赖？

核心问题分析 #

CMake处理子模块时，可能因环境变量传递不完整或子模块CMake配置的特殊性，导致无法识别PATH中的编译器。本质是子模块的CMake上下文未正确继承顶层项目的环境或编译器配置。

具体修复步骤 #

1. 顶层CMake显式指定编译器（推荐） #

在顶层项目的CMakeLists.txt开头，直接通过绝对路径指定编译器，让子模块直接继承该配置，避免重复查找：

# 顶层CMakeLists.txt 开头添加
set(CMAKE_C_COMPILER "/opt/riscv/bin/riscv64-unknown-elf-gcc" CACHE PATH "C compiler")
set(CMAKE_CXX_COMPILER "/opt/riscv/bin/riscv64-unknown-elf-g++" CACHE PATH "C++ compiler")

# 声明主项目
project(my_main_project C CXX)

# 添加子模块目录
add_subdirectory(extern/mylib)

# 构建主项目二进制文件
add_executable(main src/main.c)

# 链接子模块生成的库
target_link_libraries(main PRIVATE mylib)

2. 检查并修正子模块CMake配置 #

如果子模块的CMakeLists.txt中硬编码了编译器名称，或存在覆盖CMAKE_C_COMPILER的操作，会导致冲突。可修改子模块配置，改为优先使用顶层传递的编译器：

# 子模块CMakeLists.txt中调整
if(NOT CMAKE_C_COMPILER)
    set(CMAKE_C_COMPILER riscv64-unknown-elf-gcc)
endif()

if(NOT CMAKE_CXX_COMPILER)
    set(CMAKE_CXX_COMPILER riscv64-unknown-elf-g++)
endif()

3. 显式传递环境变量给CMake进程 #

若终端的PATH未被CMake进程正确加载（比如通过IDE或非交互式shell运行时），可在生成构建目录时显式指定PATH：

# 重新生成构建目录
PATH=/opt/riscv/bin:$PATH cmake -S . -B build

# 执行构建
cmake --build build

4. 替代方案：用ExternalProject_Add独立构建子模块 #

如果子模块的构建系统与顶层项目冲突较大，可使用ExternalProject_Add手动控制子模块的编译流程：

include(ExternalProject)

ExternalProject_Add(
    mylib
    SOURCE_DIR ${CMAKE_SOURCE_DIR}/extern/mylib
    BINARY_DIR ${CMAKE_BINARY_DIR}/extern/mylib
    CMAKE_ARGS -DCMAKE_C_COMPILER=${CMAKE_C_COMPILER} -DCMAKE_CXX_COMPILER=${CMAKE_CXX_COMPILER}
    INSTALL_COMMAND "" # 若子模块无需安装，留空
)

# 导入子模块生成的库
ExternalProject_Get_Property(mylib BINARY_DIR)
add_library(mylib_imported STATIC IMPORTED)
set_target_properties(mylib_imported PROPERTIES
    IMPORTED_LOCATION ${BINARY_DIR}/libmylib.a # 根据子模块实际生成的库路径调整
)
add_dependencies(mylib_imported mylib)

# 链接主项目
add_executable(main src/main.c)
target_link_libraries(main PRIVATE mylib_imported)

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