交叉编译AArch64时如何让sysroot优先于默认系统头文件目录？

问题描述 #

使用aarch64-linux-gnu-g++进行AArch64交叉编译时，已通过--sysroot=/home/aaron/Sysroot_Debian-Buster指定sysroot，但编译包含<signal.h>的代码时，gcc仍优先从/usr/aarch64-linux-gnu/include/signal.h加载文件，而非sysroot下的/home/aaron/Sysroot_Debian-Buster/usr/include/signal.h。通过-v参数查看头文件搜索顺序，确认系统默认交叉编译目录优先级高于sysroot目录：

... other include path in -I...
 /usr/lib/gcc-cross/aarch64-linux-gnu/9/../../../../aarch64-linux-gnu/include/c++/9
 /usr/lib/gcc-cross/aarch64-linux-gnu/9/../../../../aarch64-linux-gnu/include/c++/9/aarch64-linux-gnu
 /usr/lib/gcc-cross/aarch64-linux-gnu/9/../../../../aarch64-linux-gnu/include/c++/9/backward
 /usr/lib/gcc-cross/aarch64-linux-gnu/9/include
 /usr/lib/gcc-cross/aarch64-linux-gnu/9/../../../../aarch64-linux-gnu/include
 /home/aaron/Sysroot_Debian-Buster/usr/include/aarch64-linux-gnu
 /home/aaron/Sysroot_Debian-Buster/usr/include
End of search list.

已尝试重装gcc交叉工具链、切换至g++8，问题仍存在。

解决方案 #

1. 使用-isystem强制提升sysroot头文件目录优先级 #

-isystem用于标记系统级头文件目录，可手动指定搜索顺序。将sysroot下的核心include目录通过-isystem放在编译参数最前面，让gcc优先搜索该目录：

aarch64-linux-gnu-g++ --sysroot=/home/aaron/Sysroot_Debian-Buster \
  -isystem /home/aaron/Sysroot_Debian-Buster/usr/include \
  -isystem /home/aaron/Sysroot_Debian-Buster/usr/include/aarch64-linux-gnu \
  your_source.cpp -o output

此操作会把sysroot的include目录插入到默认系统交叉编译目录之前，确保<signal.h>这类系统头文件优先从sysroot加载。

2. 修改gcc的specs文件调整搜索顺序 #

gcc的specs文件定义了编译时的默认参数和搜索路径，可导出并编辑它来调整头文件顺序：

1. 导出当前specs文件：

aarch64-linux-gnu-g++ -dumpspecs > custom.specs

2. 编辑custom.specs，找到*cpp_unique_options或*include_dirs部分，将sysroot相关的include路径移到默认交叉编译目录之前。例如，找到包含/usr/aarch64-linux-gnu/include的行，把/home/aaron/Sysroot_Debian-Buster/usr/include和/home/aaron/Sysroot_Debian-Buster/usr/include/aarch64-linux-gnu放在它前面。
3. 使用修改后的specs文件编译：

aarch64-linux-gnu-g++ --sysroot=/home/aaron/Sysroot_Debian-Buster \
  -specs=./custom.specs \
  your_source.cpp -o output

3. 结合-B参数指定工具链前缀 #

-B参数用于指定gcc查找链接器、汇编器等工具的路径，同时会影响头文件的搜索优先级。指定sysroot下的工具路径，让gcc更倾向于从sysroot内搜索资源：

aarch64-linux-gnu-g++ --sysroot=/home/aaron/Sysroot_Debian-Buster \
  -B /home/aaron/Sysroot_Debian-Buster/usr/bin/ \
  your_source.cpp -o output

如果sysroot内有完整的交叉编译工具链（如aarch64-linux-gnu-as、aarch64-linux-gnu-ld），这个方法可以进一步强化sysroot的优先级。

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