如何让Rust Cargo生成保留局部变量名的WebAssembly文件？

Rust默认编译配置不会把局部变量名写入WASM的name自定义段，哪怕是debug模式也只保留函数名。要解决这个问题，你需要调整编译的调试信息等级：

临时编译命令调整 #

直接在编译时通过RUSTFLAGS指定调试信息等级：

RUSTFLAGS="-C debuginfo=2" cargo build --target wasm32-unknown-unknown

debuginfo=2会生成完整的调试元数据，其中就包含局部变量名，这些数据会被打包到WASM的name段中供wasmparser解析。

永久配置（修改Cargo.toml） #

如果不想每次编译都手动加参数，可以在项目的Cargo.toml中添加profile配置：

[profile.dev]
# debug模式默认使用dev profile，设置完整调试信息
rustflags = ["-C", "debuginfo=2"]

[profile.release]
# 如果需要在release模式下也保留局部变量名（注意release优化可能仍会移除部分变量）
rustflags = ["-C", "debuginfo=2"]
# 可选：如果要避免release优化移除变量，降低优化等级
# opt-level = 0

注意事项 #

• 不要使用debuginfo=1（Rust debug模式默认值），这个等级仅保留函数名，不会包含局部变量的符号信息。
• 如果是release模式，即使开启了debuginfo=2，编译器的优化（比如变量消除、内联）仍可能导致部分局部变量名丢失，此时可以降低opt-level来减少优化影响。

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