克隆rbruenig/qperf仓库编译时报quicly无CMakeLists.txt错误如何解决

错误根因 #

报错的核心原因是qperf依赖的quicly组件是作为Git子模块存在的，克隆仓库时默认不会拉取子模块的代码，导致./qperf/extern/quicly目录为空，缺少编译所需的CMakeLists.txt文件，触发后续的目标配置错误。

修复步骤 #

• 进入本地的qperf仓库根目录，执行以下命令拉取所有关联子模块的完整代码：

  git submodule update --init --recursive
  

• 清理之前生成的CMake缓存文件，避免旧的错误配置影响后续编译：

  rm -rf build CMakeCache.txt CMakeFiles
  

• 按照项目README中的编译步骤，重新执行CMake生成配置、编译操作即可正常完成构建。

异常排查 #

如果执行子模块拉取命令后extern/quicly目录仍然为空，确认当前网络可以正常访问GitHub的前提下重新执行子模块更新命令即可。

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