使用Emscripten与Meson交叉编译失败：setup阶段遇ld.wasm不支持共享库错误

核心原因 #

你的Meson配置中保留了动态库构建逻辑，即使你打算用静态模式，Meson在setup阶段仍会校验所有可能的构建目标可行性，而Emscripten完全不支持动态链接，因此触发链接器错误。

具体解决方案 #

1. 在Meson配置中强制Emscripten环境使用静态库

在meson.build开头添加平台检测逻辑，自动覆盖默认库类型，禁止动态库构建：

# 检测是否为Emscripten交叉编译环境
is_emscripten = host_machine.system() == 'emscripten'

# 针对Emscripten强制静态库构建
if is_emscripten
    default_library = 'static'
    # 若用户误传动态库参数，直接抛出明确错误
    if get_option('default_library') == 'shared'
        error('Emscripten不支持共享库，已强制切换为静态构建模式')
    endif
endif

2. 条件化处理共享库目标

如果你的配置中有单独的共享库构建目标，需要将其限制在原生环境下：

# 仅在非Emscripten环境构建共享库
if not is_emscripten
    shared_lib = shared_library('my_shared_lib', sources,
        # 你的共享库配置
    )
endif

# 始终构建静态库（适配所有环境）
static_lib = static_library('my_static_lib', sources,
    # 你的静态库配置
)

3. 完善Emscripten交叉编译文件

在你的Emscripten交叉配置文件（比如emscripten.txt）中添加默认库设置，从交叉编译层面强制静态模式：

[binaries]
c = 'emcc'
cpp = 'em++'
ar = 'emar'
strip = 'emstrip'

[properties]
default_library = static
c_args = ['-O2']
cpp_args = ['-O2']

4. 执行setup时明确指定静态库参数

运行setup命令时，显式传入静态库选项，确保配置生效：

meson setup build-emscripten --cross-file emscripten.txt -Ddefault_library=static

为什么之前setup到末尾仍报错？ #

Meson在setup阶段会预校验所有定义的构建目标是否可在当前环境下生成，哪怕你选择了静态模式，只要配置中存在共享库目标，它就会尝试验证链接器是否支持动态链接，而Emscripten的ld.wasm直接不支持，因此触发错误中断setup流程。通过上述步骤提前排除动态库构建逻辑，就能让setup顺利完成。

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