---
description: Never use Box::leak - it intentionally leaks memory
condition: "Box::leak"
scope: "tool:edit(*.rs), tool:write(*.rs)"
interruptMode: never
---

Never use `Box::leak` to satisfy a lifetime. It intentionally leaks the allocation for the rest of the process.

## Why

- The allocation is never freed.
- It hides ownership bugs.
- It turns lifetime errors into process lifetime growth.
- It makes tests pass while production memory grows.

## Use instead

|Need|Use|
|---|---|
|Shared async/thread data|`Arc<T>` or owned values|
|Global lazy state|`LazyLock<T>` or `OnceLock<T>`|
|Text escaping a scope|`String` / `Arc<str>`|
|`'static` callback|`move` closure with owned captures|
|FFI pointer|Explicit owner that frees on drop|

## Examples

```rust
// Bad — leaking to manufacture 'static.
fn label(id: u64) -> &'static str {
    Box::leak(Box::new(format!("item_{id}")))
}

// Good — return owned data.
fn label(id: u64) -> String {
    format!("item_{id}")
}

// Bad — leaking before spawn.
let state = Box::leak(Box::new(state));
tokio::spawn(async move { use_state(state) });

// Good — share owned state.
let state = Arc::new(state);
tokio::spawn(async move { use_state(&state) });
```

If `Box::leak` looks necessary, fix ownership instead.