Mac平台下Meson使用静态库遇异常，是否为Meson Bug？

1. Homebrew的libiconv.a确实是静态库 #

可以通过file命令验证：

file /usr/local/opt/libiconv/lib/libiconv.a

输出应为类似/usr/local/opt/libiconv/lib/libiconv.a: current ar archive，说明这是标准的静态库归档文件。Meson 0.64.1报错说它不是静态库，大概率是旧版本Meson对Mac平台静态库的识别逻辑存在bug，建议升级到Meson 0.65及以上版本尝试修复。

2. find_library找不到静态库的原因 #

Meson 0.64.1的find_library在指定static: true时，搜索逻辑可能存在兼容性问题，比如没有正确遍历指定目录下的.a文件。直接指定完整路径（不带后缀）能绕过这个搜索逻辑，所以不会报错，但会引出后续的符号问题。

3. 链接时未定义符号的根源 #

Homebrew编译的libiconv为了避免与Mac系统自带的iconv库冲突，主动将标准的iconv_close、iconv_open、iconv等符号重命名为libiconv_close、libiconv_open、libiconv。这就是为什么你在库文件中找不到_iconv_close，却能找到_libiconv_close的原因。

解决办法 #

• 正确引入头文件：确保编译时包含Homebrew libiconv的头文件目录，它会通过宏定义将标准函数名映射为libiconv的符号。在Meson中可以这样配置：

  iconv_inc_dir = include_directories('/usr/local/opt/libiconv/include')
  iconv_lib_dep = c_compiler.find_library('/usr/local/opt/libiconv/lib/libiconv', static: true)
  
  executable(
    'your_app',
    'src/main.c',
    include_directories: iconv_inc_dir,
    dependencies: iconv_lib_dep
  )
  

  头文件iconv.h中会有类似这样的宏定义：

  #define iconv_close libiconv_close
  #define iconv_open libiconv_open
  #define iconv libiconv
  

  这样代码中调用的iconv_close会被预编译为libiconv_close，匹配库中的符号。

• 升级Meson版本：Meson 0.64.1属于较旧版本，后续版本修复了不少平台兼容性问题，升级到最新稳定版后，find_library('iconv', dirs: cross_lib_path, static: true)可能能正常识别静态库。

• 手动指定符号映射（不推荐）：如果无法修改头文件，可以通过链接器选项强制映射符号，在Meson中添加：

  link_args: [
    '-Wl,-U,_iconv_close',
    '-Wl,-U,_iconv_open',
    '-Wl,-U,_iconv',
    '-Wl,-alias,_libiconv_close,_iconv_close',
    '-Wl,-alias,_libiconv_open,_iconv_open',
    '-Wl,-alias,_libiconv,_iconv'
  ]
  

  这种方法需要手动处理所有用到的符号，维护成本高，仅作为临时方案。

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