Android NDK项目中clangd（Emacs/Eglot）配置问题求助

方法1：通过Gradle生成compile_commands.json（推荐） #

Gradle本身可以输出clangd需要的编译数据库，无需依赖bear，步骤如下：

1. 打开模块的build.gradle文件（通常是app/build.gradle），根据你的构建系统（CMake/ndk-build）添加配置：
   • 如果你用CMake：

     android {
         // ...保留原有配置
         externalNativeBuild {
             cmake {
                 path "CMakeLists.txt"
                 // 开启编译数据库生成
                 arguments "-DCMAKE_EXPORT_COMPILE_COMMANDS=ON"
             }
         }
         // 添加任务将生成的文件复制到项目根目录
         task copyCompileCommands(type: Copy) {
             from file("${buildDir}/intermediates/cmake/debug/compile_commands.json")
             into project.rootDir
             rename { "compile_commands.json" }
         }
         assembleDebug.dependsOn copyCompileCommands
     }
     

   • 如果你用ndk-build：

     android {
         // ...保留原有配置
         externalNativeBuild {
             ndkBuild {
                 path "Android.mk"
             }
         }
         // 添加任务复制编译数据库
         task copyCompileCommands(type: Copy) {
             // 路径根据目标架构调整，比如arm64-v8a替换armeabi-v7a
             from file("${buildDir}/intermediates/ndkBuild/debug/obj/local/armeabi-v7a/compile_commands.json")
             into project.rootDir
             rename { "compile_commands.json" }
         }
         assembleDebug.dependsOn copyCompileCommands
     }
     

2. 执行./gradlew assembleDebug，项目根目录会生成compile_commands.json，clangd会自动读取这个文件，完全匹配Gradle的实际编译参数，解决头文件缺失问题。

方法2：修正.clangd配置文件 #

手动配置.clangd时，关键是要指定NDK的sysroot路径，否则clangd无法找到系统级头文件（如asm/types.h）。示例配置如下：

CompileFlags:
  Add:
    # 替换为你的目标架构和API等级，比如arm64用aarch64-linux-android21
    - --target=armv7a-linux-androideabi21
    # 替换为你的NDK实际sysroot路径，NDK 23+路径一般在toolchains/llvm/prebuilt下
    - --sysroot=/home/your-user/Android/Sdk/ndk/25.2.9519653/toolchains/llvm/prebuilt/linux-x86_64/sysroot
    - -D__ANDROID__
    # 添加SDL的头文件路径
    - -I/path/to/your-project/SDL/include
    # 可选：添加clang自身的头文件路径，避免部分编译警告
    - -I/home/your-user/Android/Sdk/ndk/25.2.9519653/toolchains/llvm/prebuilt/linux-x86_64/lib64/clang/14.0.6/include
  Remove:
    # 移除可能冲突的参数
    - -stdlib=libc++

注意替换所有路径为你本地的实际路径，目标架构和API等级要与项目的minSdkVersion、ndk.abiFilters一致。

方法3：通过Emacs/Eglot直接配置编译参数 #

如果不想用.clangd文件，可以通过Emacs的配置传递编译参数，甚至针对单个项目配置：

1. 全局配置（适用于所有NDK项目）：

   (setq eglot-workspace-configuration
         '((:clangd (:compileFlags ["--target=armv7a-linux-androideabi21"
                                    "--sysroot=/path/to/ndk/sysroot"
                                    "-D__ANDROID__"
                                    "-I/path/to/SDL/include"]))))
   

2. 单个项目配置（在项目根目录创建.dir-locals.el）：

   ((c-mode . ((eglot-workspace-configuration . ((:clangd (:compileFlags ["--target=armv7a-linux-androideabi21"
                                                                            "--sysroot=/path/to/ndk/sysroot"
                                                                            "-D__ANDROID__"
                                                                            "-I/path/to/SDL/include"])))))))
   

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