Gradle与CMake协作机制及Android Studio C/C++源码导航失效求助

核心原理：并非直接解析CMakeLists.txt #

Android Studio（搭配AGP 7.x）不会直接读取解析你的CMakeLists.txt，而是依赖CMake配置阶段生成的compile_commands.json文件来获取C/C++源文件信息。流程如下：

1. Gradle触发CMake执行configure阶段，生成包含所有编译单元信息的compile_commands.json
2. AS内置的Clangd索引引擎读取该文件，提取源文件路径、编译参数等，以此构建索引实现源码导航、语法提示功能

该文件默认生成路径：<模块目录>/build/cmake/<构建变体>/compile_commands.json（例如app/build/cmake/debug/compile_commands.json）

针对导航失效的排查步骤 #

1. 检查compile_commands.json的有效性 #

• 打开对应变体的compile_commands.json，查看其中的"file"字段，确认更新后的C/C++源文件是否被包含在内
• 如果文件缺失、路径错误或未包含目标文件，说明CMake配置阶段未正确生成编译命令，需先排查CMakeLists.txt的配置问题：
  • 确认add_library中声明的源文件路径是否正确（建议使用相对于当前CMakeLists.txt的相对路径，避免绝对路径适配问题）
  • 若使用file(GLOB)收集源文件，CMake仅在configure阶段扫描文件，新增文件不会自动被识别，需手动触发重新配置

2. 查看CMake配置日志 #

在Android Studio的Build窗口切换到CMake标签，检查configure阶段的输出：

• 留意是否存在源文件找不到、路径解析失败的警告/错误（即使构建能成功，CMake可能在配置阶段跳过了部分文件，导致索引缺失）

3. 强制重新生成CMake配置与IDE索引 #

• 执行Gradle命令彻底清理并重新配置CMake：

  ./gradlew clean cmakeCleanDebug cmakeConfigureDebug
  

  （debug替换为你的目标构建变体，如release）
• 在AS内操作：
  1. 点击File → Sync Project with Gradle Files
  2. 点击Tools → CMake → Reset CMake Cache and Reload Project
  3. 手动删除<模块目录>/build/cmake目录后重新构建

4. 重置IDE索引缓存 #

• 点击File → Invalidate Caches...，选择Invalidate and Restart，彻底清空AS的索引缓存，重启后等待索引完成

5. 排查CMakeLists.txt的特殊配置 #

• 检查是否存在条件编译逻辑（如if(...)包裹的add_library），确认目标源文件所在的分支在当前构建变体下是否被触发
• 确认未通过exclude或其他CMake指令意外排除了目标源文件

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