交叉编译时Meson无法找到libm的问题排查

问题背景 #

使用arm-none-eabi工具链交叉编译项目，工具链安装在/usr/arm-none-eabi，目录下存在libm.a文件。当前Meson构建流程可正常运行，但存在以下矛盾：

• 手动在可执行文件的link_args中添加-lm，Meson能正常找到并链接libm
• 使用cc.find_library('m')时，Meson报错找不到库

报错信息 #

meson.build:112:21: ERROR: C shared or static library 'm' not found

查看Meson日志确认，程序已在/usr/arm-none-eabi/lib目录下搜索，但仍无法识别到存在的libm.a。

原因分析 #

1. 库类型优先级问题：Meson的find_library默认优先查找共享库（.so），仅当共享库不存在时才会尝试静态库（.a）。arm-none-eabi这类嵌入式工具链通常仅提供静态版本的libm，没有对应共享库，可能导致Meson的默认检测逻辑失效。
2. 测试编译验证失败：find_library会尝试编译一个简单的测试程序来验证库可用性，但嵌入式环境下的测试程序可能因缺少系统依赖（如标准库的完整支持）无法编译通过，导致Meson误判库不存在。
3. 链接器与Meson检测逻辑差异：手动添加-lm时，链接器（arm-none-eabi-ld）会直接在搜索路径中匹配libm.a并使用，无需额外验证步骤，因此可以正常工作。

解决方案 #

1. 强制查找静态库 #

在find_library中添加static: true参数，明确告知Meson只查找静态库：

math_dep = declare_dependency(
    dependencies: cc.find_library(
        'm',
        required: true,
        static: true,
    )
)

2. 跳过测试编译（应急方案） #

如果测试编译环节因嵌入式环境限制失败，可添加参数跳过验证步骤：

math_dep = declare_dependency(
    dependencies: cc.find_library(
        'm',
        required: true,
        static: true,
        has_headers: false,
        compile_args: [],
    )
)

3. 直接添加链接参数（替代方案） #

若上述方法无效，可直接将-lm加入编译器的链接参数：

cc.link_args += '-lm'

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