Как отключить предупреждения о мертвом коде на уровне крейта в Rust?

Глобальное отключение предупреждений через атрибут крейта

Самый простой способ отключить предупреждения dead_code для всего крейта — добавить атрибут #![allow(dead_code)] в корневой файл вашего крейта (обычно это src/lib.rs или src/main.rs). Обратите внимание на восклицательный знак ! — он означает, что атрибут применяется ко всему крейту, а не только к текущему модулю.

Пример для библиотечного крейта (src/lib.rs):

// src/lib.rs
#![allow(dead_code)]

pub fn helper_func(x: i32) -> i32 {
    x * 2
}

fn internal_helper(x: i32) -> i32 {
    x + 1
}

pub struct Config {
    pub timeout: u32,
    pub retries: u32,
}

mod my_module; // В этом модуле тоже не будет предупреждений

Теперь все предупреждения dead_code во всех файлах, которые входят в этот крейт, будут подавлены. Это работает, потому что атрибут #![...] (с восклицательным знаком) задает свойства для всего контейнера (crate), а не для конкретного блока кода.

Более тонкая настройка: отключение только для публичных элементов

Если вы хотите отключать предупреждения только для публичных (pub) функций и структур, которые пока не используются извне, но при этом получать предупреждения для внутренних неиспользуемых функций — это сложнее. Rust не предоставляет встроенного способа разделить dead_code на "публичный" и "приватный". Однако вы можете использовать следующий трюк:

// src/lib.rs
#![allow(dead_code)] // временно отключаем всё

// Когда функция понадобится — убираем этот атрибут
// и добавляем #[allow(dead_code)] только к тем элементам,
// которые действительно должны быть неиспользуемыми

Либо, если вы разрабатываете библиотеку, можно экспортировать неиспользуемые функции как pub и пометить их атрибутом #[doc(hidden)], чтобы они не появлялись в документации:

/// Внутренняя функция, пока не используется
#[doc(hidden)]
pub fn future_helper(x: i32) -> i32 {
    x * 2
}

Отключение через Cargo.toml (не рекомендуется)

Можно попробовать добавить флаги компилятора в Cargo.toml:

[package]
name = "my_crate"
version = "0.1.0"

[lib]
# Это не сработает для dead_code, так как dead_code — это предупреждение,
# а не ошибка. Флаг -A dead_code работает, но его лучше задавать
# через RUSTFLAGS, а не в Cargo.toml

Но это нестандартный подход. Лучше использовать атрибут крейта.

Правильный подход: используйте атрибут временно

Как опытный разработчик, я рекомендую:

• Добавить #![allow(dead_code)] в корневой файл на время активной разработки.
• Перед коммитом или релизом убрать этот атрибут и посмотреть, какие предупреждения остались. Если какие-то функции действительно мертвы — удалите их.
• Если вы уверены, что функция понадобится в будущем, но пока не используется — просто оставьте её с #[allow(dead_code)] над ней, а не глобально.

Это поможет держать код чистым и не пропустить случайно забытые неиспользуемые функции.

// src/utils.rs
#![allow(dead_code)]

pub fn util_a() {}
pub fn util_b() {}
fn util_c() {}

pub struct Config {
    pub _timeout: u32, // Поле с подчеркиванием не вызовет предупреждения
    pub retries: u32,  // А это поле вызовет, если не используется
}

[features]
experimental = []

// В коде:
#[cfg(feature = "experimental")]
pub fn experimental_function() {}