PAYATHON 2026

Clang 交叉编译 arm-none-eabi 时如何配置链接器和头文件？

数据小许

结论

从日志看，Clang 已按 arm-none-eabi 目标生成 ARM 对象文件，也从 --sysroot 找到了部分目标头文件和库路径。错误出现在链接阶段：Clang 尝试运行 ld.lld，但系统找不到该程序。--sysroot 用来指定目标系统的头文件和库搜索根目录，本身不会安装或指定链接器，也不保证 Clang 能识别该目录下 GNU C++ 标准库的布局。

日志中的 Target: arm-none-unknown-eabi 是 Clang 对目标三元组的规范化显示，单看这一行无法判断目标配置是否有误。include/c++/v1 是 libc++ 常见的头文件布局，而工具链提供的 include/c++/15.2.1 属于另一种布局。Clang 没有自动将这两种布局对应起来。

处理链接器缺失

可以安装与当前 Clang 配套的 LLD，让系统能够找到 ld.lld；也可以使用 ARM GNU Toolchain 自带的 GNU 工具链驱动来编译和链接，例如：

TOOLCHAIN="$HOME/Desktop/arm-gnu-toolchain-15.2.rel1-x86_64-arm-none-eabi"

"$TOOLCHAIN/bin/arm-none-eabi-g++" main.cpp -o executable

GNU 驱动会根据自身的工具链布局选择链接器、目标库和运行时。请确认解压目录中的驱动文件名和路径与示例一致。

如果要让 Clang 负责链接，可以明确选择 GNU BFD 链接器，并将工具链的 bin 目录加入链接器搜索路径：

TOOLCHAIN="$HOME/Desktop/arm-gnu-toolchain-15.2.rel1-x86_64-arm-none-eabi"
SYSROOT="$TOOLCHAIN/arm-none-eabi"

clang++ --target=arm-none-eabi \
  --sysroot="$SYSROOT" \
  -B"$TOOLCHAIN/bin/" \
  -fuse-ld=bfd \
  -o executable main.cpp

工具链目录中需要有 Clang 能通过 -fuse-ld=bfd 找到的兼容链接器。不同发行包的文件名和目录布局可能不同，可以先检查 bin 下是否有 ld.bfd 或带目标前缀的链接器。如果 Clang 仍然找不到，可以改用该 GNU 工具链的 arm-none-eabi-g++ 驱动完成链接，或者为 Clang 安装 LLD。

如果只想确认源文件能否编译成目标对象文件，可以先跳过链接：

clang++ --target=arm-none-eabi \
  --sysroot="$SYSROOT" \
  -c main.cpp -o main.o

处理 C++ 头文件路径

日志显示 include/c++/v1 不存在，说明 Clang 正在查找 libc++ 的目录；工具链实际提供的是 include/c++/15.2.1。--sysroot 不会把这个版本目录自动转换成 Clang 期望的 v1 路径。当前的 main.cpp 不包含标准库头文件，因此缺少这个目录不会妨碍对象文件编译。项目如果包含 <vector> 等 C++ 标准库头文件，就需要明确选择标准库，并配置相应的头文件和库路径。

如果要使用 ARM GNU Toolchain 随附的 libstdc++，先检查它的实际目录布局，再配置 Clang 使用对应的头文件和库。可以这样检查：

find "$SYSROOT/include/c++/15.2.1" -maxdepth 2 -type d

确认目录后，可以通过 -isystem 指定标准库头文件目录，并根据实际布局补充目标专用头文件目录。路径应以工具链中的实际文件为准，不要将 include/c++/15.2.1 替换成不存在的 include/c++/v1。如果要完整使用 GNU 标准库，让 arm-none-eabi-g++ 负责链接通常更省事，因为它也会选择相应的 C++ 运行时和库。

--gcc-toolchain 为什么未生效

--gcc-toolchain 用于特定 Clang 工具链配置下的 GCC 安装发现，不能让所有目标自动扫描任意目录。当前日志提示该参数未使用，说明这次目标配置没有读取它。对于 arm-none-eabi 裸机目标，不能只凭这个参数就认定 Clang 会自动识别 ARM GNU Toolchain 中的 C++ 头文件和链接器。

如果之后要为 clangd 配置同一项目，请确保编译数据库或配置文件包含项目实际使用的目标、标准库和头文件参数。Clang 命令行没有正确的搜索路径时，clangd 也无法仅凭 --sysroot 推断出工具链中的所有目录。

备注：内容仅供参考。