ARM裸机环境下arm-none-eabi-gcc链接math库出现sqrt未定义问题

核心原因 #

你手动指定的/opt/gcc-arm-none-eabi-10-2020-q4-major/arm-none-eabi/lib/是通用软浮点架构的库路径，和你当前使用的硬浮点、Cortex-M7内核编译参数ABI不匹配，链接器无法找到对应版本的sqrt符号定义。

解决步骤 #

• 移除手动指定的错误库路径参数-Wl,-L/opt/gcc-arm-none-eabi-10-2020-q4-major/arm-none-eabi/lib/，gcc会根据你传入的架构、浮点参数自动匹配对应版本的库路径，手动指定会覆盖自动搜索逻辑，反而导致找错库。
• 在编译和链接阶段都补充-mcpu=cortex-m7参数，STM32H7属于Cortex-M7内核，加入该参数后gcc才能定位到对应内核+硬浮点版本的libm.a文件。
• 你当前使用的-Wl,--start-group -lc -lm -Wl,--end-group参数顺序正确，无需调整，start group会循环查找组内库的依赖关系。
• 若修改后仍报错，可在链接命令末尾添加-v参数，查看gcc实际搜索的库路径，确认是否定位到了对应thumb/v7e-m+dp/hard目录下的libm.a（该目录对应你使用的mfpu=fpv5-d16、-mfloat-abi=hard参数）。

注意：编译和链接阶段需要传入完全一致的-mcpu、-mfpu、-mfloat-abi参数，否则会出现ABI不匹配的问题。

修正后的链接命令示例 #

arm-none-eabi-gcc -T"xxx.ld" -mcpu=cortex-m7 -mfpu=fpv5-d16 -mfloat-abi=hard -mthumb -ffreestanding -nostdlib -nostartfiles --specs=nosys.specs -Wl,--start-group -lc -lm -Wl,--end-group -Wl,-Map=xxx.map -o xxx.elf <list of .o>

可选优化 #

如果你调用的是单精度版本的sqrtf，可以在编译参数中添加-ffast-math，gcc会直接生成FPU硬件sqrt指令，无需链接libm的软件实现，性能更高。

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