Debug模式下Rust代码因过多include_bytes!导致栈溢出

问题根源 #

Windows平台下，Rust Debug模式默认栈空间仅为1MB左右，而Release模式会启用栈优化或自动将大变量移至堆/静态存储区。你的代码中let tmp = *include_bytes!("test.wav")会把include_bytes!返回的静态字节数组完整拷贝到栈上，多个大文件的字节数组累加后直接超过栈容量，触发STATUS_STACK_OVERFLOW错误。

即使改用static，如果仍然通过解引用将数据拷贝到栈上，问题依然存在——只有直接使用静态引用而非拷贝时，才会避开栈空间限制。

解决方案 #

方案1：直接使用静态引用，避免栈拷贝 #

跳过局部变量的栈拷贝步骤，直接将include_bytes!返回的静态引用包装成Box<[u8]>传给Chunk::from_raw_buffer：

use sdl2::mixer::Chunk;
fn main() {
    let chunk1 = Chunk::from_raw_buffer(Box::from(include_bytes!("test.wav")));
    let chunk2 = Chunk::from_raw_buffer(Box::from(include_bytes!("test.wav")));
    let chunk3 = Chunk::from_raw_buffer(Box::from(include_bytes!("test.wav")));
}

Box::from(&'static [u8])会直接创建指向静态存储区数据的Box，不会在栈上产生任何拷贝，彻底避开栈容量限制。

方案2：用静态变量存储引用，复用数据 #

如果需要多次复用同一份音频数据，可以将其定义为静态引用，避免重复处理：

use sdl2::mixer::Chunk;

// 静态存储区保存音频数据的引用，不占用栈空间
static TEST_WAV: &[u8] = include_bytes!("test.wav");

fn main() {
    let chunk1 = Chunk::from_raw_buffer(Box::from(TEST_WAV));
    let chunk2 = Chunk::from_raw_buffer(Box::from(TEST_WAV));
    let chunk3 = Chunk::from_raw_buffer(Box::from(TEST_WAV));
}

方案3：调整Debug模式栈大小（Windows专属） #

如果必须在栈上处理大变量，可以通过链接器参数扩大栈空间。在项目的Cargo.toml中添加：

[profile.dev]
# 将栈大小设置为8MB（根据实际需求调整数值）
rustflags = ["-C", "link-args=/STACK:8388608"]

注意：此方案仅适用于Windows MSVC工具链，属于平台依赖的临时手段，优先推荐前两种方案。

验证效果 #

修改代码后重新执行cargo run，Debug模式下将不再出现栈溢出错误，同时保持Release模式的原有运行状态。

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