Emscripten启用pthreads加载图片编译报错，如何解决？

问题重现 #

同时使用-sUSE_PTHREADS和-sSDL2_IMAGE_FORMATS编译参数时，触发错误：

--shared-memory is disallowed by IMG_png.c.o because it was not compiled with 'atomics' or 'bulk-memory' features

移除-sSDL2_IMAGE_FORMATS后编译通过，但IMG_Init(IMG_INIT_PNG)执行失败。

解决方案 #

1. 添加共享内存必需的编译参数 #

启用PTHREADS时，Emscripten依赖WebAssembly的共享内存特性，必须显式开启原子操作和大块内存支持：

• -sATOMICS=1：启用WebAssembly原子操作
• -sBULK_MEMORY=1：启用WebAssembly大块内存特性

2. 正确指定SDL2_IMAGE_FORMATS #

明确指定需要支持的图片格式（比如PNG），确保SDL_image编译时包含对应模块：
-sSDL2_IMAGE_FORMATS=['png']

3. 完整编译命令示例 #

emcc your_code.cpp -o output.html -sUSE_PTHREADS=1 -sATOMICS=1 -sBULK_MEMORY=1 -sSDL2_IMAGE_FORMATS=['png'] -lSDL2 -lSDL2_image

额外建议 #

在代码中检查IMG_Init的返回值，便于定位问题：

int imgFlags = IMG_INIT_PNG;
if (!(IMG_Init(imgFlags) & imgFlags)) {
    printf("SDL_image初始化失败: %s\n", IMG_GetError());
    SDL_Quit();
    return 1;
}

原因说明 #

• 启用-sUSE_PTHREADS会强制开启WebAssembly共享内存，而SDL_image的PNG模块需要编译时支持原子和大块内存特性，否则会触发兼容性错误。
• 移除-sSDL2_IMAGE_FORMATS时，Emscripten默认可能不编译SDL_image的PNG模块，导致IMG_Init(IMG_INIT_PNG)无法初始化对应格式支持，最终失败。

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