Фичи (features)

Фичи (features) — это именованные флаги, которые включают или отключают части кода и зависимости. Главная цель — не компилировать то, что не используется.

Пример: библиотека tokio умеет делать очень много — TCP-сокеты, файловый ввод/вывод, таймеры, многопоточность. Если вам нужны только таймеры — зачем тянуть весь стек? Вы включаете только нужные фичи:

# Только то, что нужно:
tokio = { version = "1", features = ["time", "rt"] }

# Или всё сразу (удобно для экспериментов, хуже для размера бинарника):
tokio = { version = "1", features = ["full"] }

[dependencies]
# serde: фича derive генерирует код через макрос #[derive(Serialize, Deserialize)]
serde = { version = "1", features = ["derive"] }

# reqwest: фича json добавляет .json() методы; blocking — синхронный API
reqwest = { version = "0.11", features = ["json", "blocking"] }

# tokio: rt = runtime, macros = #[tokio::main], fs = файловый ввод/вывод
tokio = { version = "1", features = ["rt", "macros", "fs"] }

# sqlx: выбираем только нужную СУБД и runtime
sqlx = { version = "0.7", features = ["postgres", "runtime-tokio-rustls"] }

Через cargo add:

cargo add serde --features derive
cargo add tokio --features rt,macros,fs
cargo add reqwest --features json,blocking

Секция [features] в Cargo.toml определяет какие фичи есть у вашей библиотеки. Каждая фича — это список других фичей или зависимостей, которые она включает:

[features]
# Фичи включённые по умолчанию
default = ["json"]

# Фича "json" включает зависимость serde_json
json = ["dep:serde_json"]

# Фича "async" включает tokio
async = ["dep:tokio"]

# Фича "full" включает всё
full = ["json", "async"]

[dependencies]
serde = { version = "1", features = ["derive"] }
# Опциональные зависимости — подключаются только если включена фича
serde_json = { version = "1", optional = true }
tokio = { version = "1", features = ["full"], optional = true }

Сборка с конкретными фичами:

cargo build --features "json,async"    # включить конкретные фичи
cargo build --features "full"          # включить фичу full
cargo build --no-default-features      # отключить default фичи
cargo build --no-default-features --features "async"  # только async