Clang交叉编译Android程序的核心是正确设置NDK工具链路径、目标三元组和sysroot：NDK r17+已移除GCC支持，必须使用$NDK/toolchains/llvm/prebuilt/{host-os}/bin/下的Clang，且CC/CXX变量须含API后缀（如aarch64-linux-android29-clang++），--cross-prefix和--host需严格匹配，CMake应通过android.toolchain.cmake而非手动指定编译器，sysroot由Clang自动注入$TOOLCHAIN/sysroot，API等级必须与目标设备一致。
Clang交叉编译Android程序的核心是正确设置NDK工具链路径、目标三元组（target triplet）和sysroot，而不是沿用GCC时代的配置方式。NDK r17+已彻底移除GCC支持，所有C/C++编译必须走clang路径，否则会直接报command not found或链接失败。
NDK toolchain 路径和环境变量怎么设
NDK 25+的Clang工具链固定在toolchains/llvm/prebuilt/{host-os}/bin/下，不是旧版的toolchains/aarch64-linux-android-4.9那种GCC风格路径。必须用完整可执行文件名，不能只配CC=clang。
-
export NDK=/path/to/android-ndk-r25c（路径按实际调整） -
export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/linux-x86_64（Linux host；macOS用darwin-x86_64） -
export TARGET=aarch64-linux-android（ARM64设备）或armv7a-linux-androideabi（ARM32） -
export API=29（最低运行API，影响__ANDROID_API__宏和可用符号） export CC=$TOOLCHAIN/bin/${TARGET}${API}-clangexport CXX=$TOOLCHAIN/bin/${TARGET}${API}-clang++-
export AR=$TOOLCHAIN/bin/llvm-ar、RANLIB=$TOOLCHAIN/bin/llvm-ranlib、STRIP=$TOOLCHAIN/bin/llvm-strip
漏掉${API}后缀会导致CC找不到头文件，报sys/types.h: No such file or directory——这是最常踩的坑。
configure脚本里--cross-prefix和--host怎么填
FFmpeg、libgpiod等开源项目依赖configure脚本，它不认NDK路径，只认--cross-prefix和--host。填错会导致它仍调用宿主机gcc，编译出x86_64二进制。
-
--host=aarch64-linux-android（必须和TARGET一致） -
--cross-prefix=$TOOLCHAIN/bin/aarch64-linux-android29-（注意末尾的29-，不是-） - 不要设
--cc=clang，要让configure自动从--cross-prefix推导出aarch64-linux-android29-clang - 如果configure报
checking for aarch64-linux-android29-gcc... no，说明--cross-prefix拼写错误或文件不存在
CMakeLists.txt里怎么指定Clang工具链
Android Studio默认用CMake，但ExternalNativeBuild不会自动注入NDK Clang路径。必须显式指定android.toolchain.cmake或手动覆盖CMAKE_C_COMPILER。
- 推荐方式：在
build.gradle中配置arguments "-DANDROID_TOOLCHAIN=clang"，并确保cmakeVersion≥ 3.22 - 手动方式：在CMake命令行加
-DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake - 绝对不要写
-DCMAKE_C_COMPILER=$TOOLCHAIN/bin/aarch64-linux-android29-clang——这会绕过NDK的sysroot和flag自动注入，导致log.h等系统头找不到 - 验证是否生效：编译时看日志是否含
Using Android toolchain: clang，而不是Using Android toolchain: gcc
常见链接错误和sysroot缺失问题
即使编译通过，ld: error: undefined reference to 'android_get_application' 这类错误几乎全是sysroot没对齐导致的。NDK的Clang把标准库、头文件、链接脚本全打包在sysroot里，不能靠-I/-L硬凑。
-
sysroot路径是$TOOLCHAIN/sysroot，不是$NDK/platforms/android-${API}/arch-arm64（那是旧GCC路径） - Clang命令行会自动加
--sysroot=$TOOLCHAIN/sysroot，但如果你用ld.lld直接链接，必须手动加 - 遇到
undefined reference to '__cxa_atexit'，说明C++ runtime没链接：-lc++_shared必须出现在链接命令末尾，且libc++_shared.so要随APK打包 - 模拟器调试时若报
cannot locate symbol 'clock_gettime'，是API太低（clock_gettime在API 28+才稳定），把API提到28以上
最关键的细节：所有路径里的29、30、34必须和你最终部署的目标设备API等级严格一致，差一个数字就可能缺符号或头文件。这不是版本兼容问题，是NDK设计上就按API切分ABI边界。
