Bevy游戏可执行文件运行时缺失DLL，如何正确编译？

问题原因 #

• 默认cargo build生成的是调试(debug)版本，该版本依赖大量带哈希后缀的动态链接库（如bevy_dylib-xxx.dll），且依赖Rust标准库的动态版本（std-xxx.dll），这些文件默认不在可执行文件同目录，直接运行会触发找不到DLL的错误。
• cargo run能正常运行，是因为它会自动将依赖库的目录加入环境变量，让程序可以定位到这些DLL文件。

正确编译可分发版本的方法 #

1. 编译Release版本（推荐） #

执行以下命令编译发布版本：

cargo build --release

Release版本会自动静态链接大部分依赖（包括Rust标准库），生成的可执行文件位于target/release目录下，无需额外DLL即可直接运行。

2. 若需分发Debug版本（不推荐） #

如果必须分发Debug版本，需要手动处理依赖文件：

• 找到target/debug/deps目录下的bevy_dylib-xxx.dll，复制到target/debug目录（与你的可执行文件同位置）。
• 针对std-xxx.dll缺失问题：Debug版本默认依赖动态Rust标准库，可通过修改配置强制静态链接。在项目根目录创建或编辑.cargo/config.toml，添加以下内容：

  [target.x86_64-pc-windows-msvc]
  rustflags = ["-C", "target-feature=+crt-static"]
  
  [target.i686-pc-windows-msvc]
  rustflags = ["-C", "target-feature=+crt-static"]
  

  重新编译Debug版本后，就不再依赖std-xxx.dll。

额外注意事项 #

• Bevy的动态插件加载功能可能仍需依赖bevy_dylib动态库，但普通游戏分发场景下，Release版本的静态链接方案已足够满足需求。
• 若项目使用了其他第三方动态库，需将对应DLL文件一同打包到发布目录中。

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