C++编译成WASM后怎么在JavaScript中调用导出的函数

阿晨君_8286

阿晨君_8286

2026-10-06

815人浏览

原创

必须显式指定-s exported_functions='["_func"]'并确保函数带emscripten_keepalive和extern "c",否则链接期被裁剪;js需等待module.onruntimeinitialized或await init()后调用,且字符串/数组须手动管理线性内存。

c++编译成wasm后怎么在javascript中调用导出的函数

导出的 C++ 函数在 JS 中找不到?检查 EXPORTED_FUNCTIONS 和 EXPORTED_RUNTIME_METHODS

WASM 模块默认不暴露任何 C++ 符号,即使你写了 extern "C" void my_func(); 并用 EMSCRIPTEN_KEEPALIVE 标记,JS 仍可能报 Module._my_func is not a function。根本原因是 Emscripten 的链接阶段会 strip 掉未声明导出的符号。

编译时必须显式告诉 Emscripten 哪些函数要导出:

  • 用 -s EXPORTED_FUNCTIONS='["_my_func", "_another_func"]'(注意下划线前缀,C++ 函数名会被 mangling,但 extern "C" + EMSCRIPTEN_KEEPALIVE 后是 C 风格符号,带下划线)
  • 如果要用 ccall/cwrap,还需加 -s EXPORTED_RUNTIME_METHODS='["ccall","cwrap"]'
  • 若启用了 -s STANDALONE_WASM=1,则无法用 ccall,只能靠 WebAssembly JS API 手动调用,此时导出列表仍需 EXPORTED_FUNCTIONS

ccall 调用失败:参数类型和内存布局不匹配

C++ 函数接收 int、float 等基础类型没问题,但一旦涉及指针(比如 char*、数组、结构体),JS 侧必须手动管理 WASM 内存,否则读写越界或返回乱码。

常见错误场景:

  • 传字符串:JS 中不能直接传 "hello",得先用 Module.lengthBytesUTF8 和 Module.stringToUTF8 写入线性内存,再把偏移量传给 C 函数
  • 读返回字符串:C 返回 char* 时,JS 要用 Module.UTF8ToString(ptr) 解码,且确保该指针指向的是 malloc 分配或静态字符串(栈上局部变量地址在函数返回后失效)
  • 传入数组:用 Module._malloc(size) 分配,Module.HEAP32.set(...) 写入,调用完记得 Module._free(ptr)

WASM 加载完成前就调用函数?等 Module.onRuntimeInitialized 或用 Promise

Emscripten 生成的 JS 胶水代码是异步初始化的:下载 .wasm、编译、实例化、运行全局构造函数、设置堆……这些都完成后,导出函数才真正可用。直接在 script 标签里写 Module._my_func() 会报 undefined。

Java Maven Code Review
Java Maven Code Review

审查Java Maven项目(ZIP压缩包或GitLab仓库URL),检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

正确做法有两种:

  • 监听 Module.onRuntimeInitialized = () => { Module._my_func(); }
  • 如果用现代打包方式(如 MODULARIZE=1),可 import 模块并 await 初始化:
    import init, { my_func } from './module.js';
    await init();
    my_func(); // 这里才是安全的

注意:不要依赖 DOMContentLoaded 或 window.onload,它们和 WASM 初始化无关。

为什么 C++ 里 std::string 或 std::vector 不能直接导出?

WASM 没有跨语言的 ABI,std::string 是 C++ 运行时对象,其内存布局、分配器、析构逻辑 JS 完全无法理解。试图导出或传入这类类型,轻则崩溃,重则静默内存损坏。

可行方案只有三种:

  • 彻底避免:导出函数只用 C 风格接口(const char*, int*, float*, size_t)
  • 用 std::string 仅作内部实现,输入输出仍走裸指针 + 长度参数,例如 void process_text(const char* input, size_t len, char* output, size_t out_size)
  • 借助 Emscripten 的 EM_JS 宏,在 C++ 里直接写 JS 逻辑(适合简单 glue 场景,但破坏了纯 WASM 的可移植性)

最易被忽略的是:C++ 全局 std::string 变量在模块卸载时不会自动析构——如果 WASM 实例被反复创建销毁,会导致内存泄漏。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

javascript java c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2208

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

979

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

407

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

307

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

386

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

580

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1389

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1197

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.1万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.6万人学习