如何阻止Emscripten自动调用C程序的main函数

我使用Emscripten将C程序编译为WebAssembly，当前使用的emcc编译参数如下：

FLAGS = -O0 \
        -s ALLOW_MEMORY_GROWTH=1 \
        -s TOTAL_MEMORY=134217728 \
        -s NO_EXIT_RUNTIME=1 \
        -s FORCE_FILESYSTEM=1 \
        --memory-init-file 0 \
        -s MODULARIZE=1 \
        -s WASM=1 \
        -s EXPORT_ES6=1 \
        -s EXPORTED_FUNCTIONS="['_main']" \
        -s EXPORTED_RUNTIME_METHODS=intArrayFromString,allocate,ALLOC_NORMAL \
        -DNODEPS=1

编译可正常生成.wasm和.js文件，但加载代码时，main函数总会无参自动执行。我需要保留main函数并将其列入EXPORTED_FUNCTIONS，但希望后续手动传入参数调用，不需要初始自动执行。

我已尝试添加--no-entry、INVOKE_MAIN=0、NO_INITIAL_RUN=1等编译参数，也尝试在JavaScript代码中调用Module().then(...)前设置Module.noInitialRun = true，但均无效，部分参数无文档说明或已被移除。

当前emcc版本信息：

clang version 17.0.0 (https://github.com/llvm/llvm-project.git 6865cff8ea8b07d9f2385fd92cecb422404f0f35)
Target: wasm32-unknown-emscripten
Thread model: posix
InstalledDir: /opt/homebrew/Cellar/emscripten/3.1.35/libexec/llvm/bin

针对Emscripten 3.1.35版本，正确的配置方式如下：

1. 修改编译参数 #

添加**-s INVOKE_MAIN=0**到FLAGS中，这是当前版本控制是否自动调用main的有效参数，同时不要使用--no-entry（它会跳过Emscripten的标准初始化流程，导致后续手动调用main时环境异常）。

修改后的完整FLAGS：

FLAGS = -O0 \
        -s ALLOW_MEMORY_GROWTH=1 \
        -s TOTAL_MEMORY=134217728 \
        -s NO_EXIT_RUNTIME=1 \
        -s FORCE_FILESYSTEM=1 \
        --memory-init-file 0 \
        -s MODULARIZE=1 \
        -s WASM=1 \
        -s EXPORT_ES6=1 \
        -s EXPORTED_FUNCTIONS="['_main']" \
        -s EXPORTED_RUNTIME_METHODS=intArrayFromString,allocate,ALLOC_NORMAL \
        -s INVOKE_MAIN=0 \
        -DNODEPS=1

2. JavaScript端手动调用main函数 #

由于使用了MODULARIZE=1和EXPORT_ES6=1，需要通过异步方式初始化Module，然后手动传入参数调用_main（注意C函数导出后会带下划线前缀）。示例代码如下：

import createModule from './your-compiled-module.js';

async function invokeMainWithArgs() {
  // 初始化Module
  const Module = await createModule();

  // 准备要传入的参数（格式为[程序名, 参数1, 参数2,...]）
  const args = ["my-program", "arg1", "arg2"];

  // 将字符串参数转换为C风格的内存指针数组
  const argvPtrs = args.map(arg => Module.intArrayFromString(arg));
  // 分配内存存储argv数组
  const argv = Module.allocate(argvPtrs, 'i32', Module.ALLOC_NORMAL);

  // 调用main函数，传入argc和argv
  const exitCode = Module._main(args.length, argv);
  console.log('main函数返回值:', exitCode);

  // 可选：释放内存（避免内存泄漏）
  argvPtrs.forEach(ptr => Module._free(ptr));
  Module._free(argv);
}

// 触发调用
invokeMainWithArgs();

为什么之前的尝试无效？ #

• NO_INITIAL_RUN是旧版Emscripten的参数，当前3.x版本已被移除，替代参数为INVOKE_MAIN=0
• --no-entry的作用是跳过Emscripten的标准初始化逻辑（如文件系统、内存配置），并非控制main的自动调用，使用它会导致后续调用main时环境未就绪
• 在createModule()前设置noInitialRun无效，因为MODULARIZE模式下，配置需要通过编译参数或传入createModule的配置对象传递（不过INVOKE_MAIN=0在编译时设置更可靠）

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