Emscripten项目中如何保留Wasm函数名称用于性能分析

在Emscripten项目中开发复杂的C++应用时，开发者经常需要分析Wasm模块的性能表现。一个常见的问题是，默认情况下编译后的Wasm代码会将函数名简化为"funcXXX"的形式，这给性能分析和调试带来了很大困难。

问题背景

当使用Emscripten构建包含多级依赖的复杂项目时，函数名称的保留变得尤为重要。例如在构建xeus-cpp-lite这样的交互式C++解释器时，项目会依赖多个库如symengine、boost-cpp和nlohmann_json等，同时还会在运行时动态加载额外的Wasm模块。

解决方案

Emscripten提供了--profiling-funcs编译选项来保留函数名称。这个选项会在生成的Wasm文件中添加"name"段，包含原始的函数名称信息。需要注意的是：

1. 这是一个链接时选项，不需要重新编译所有源代码
2. 对于主模块和所有动态加载的SIDE_MODULE都需要应用此选项
3. 不需要同时使用-g选项，后者会包含额外的DWARF调试信息

实际应用中的注意事项

在多级依赖的项目中，必须确保所有层级的链接都正确应用了--profiling-funcs选项：

1. 基础库(如LLVM)的构建
2. 中间层库(如CppInterOp)的链接
3. 最终应用(如xeus-cpp-lite)的构建
4. 运行时动态生成的Wasm模块

可以使用wasm-objdump -h命令检查生成的Wasm文件是否包含"name"段，这是函数名称保留的标志。

高级技巧

对于运行时动态生成的Wasm模块，需要特别注意链接参数的配置。默认情况下，wasm-ld会保留名称段，除非显式指定了--strip-debug选项。在动态模块生成时，可以通过调整链接器参数来确保函数名称的保留。

总结

保留Wasm函数名称是性能分析和调试的重要基础。通过正确使用--profiling-funcs选项，并确保项目所有层级的构建都应用了这一选项，开发者可以获得更清晰的性能分析结果，大大提升复杂项目的开发和调试效率。