async/await

Вызов async fn НЕ запускает выполнение её тела вообще — он возвращает Future, которая ничего не делает, пока что-то активно не начнёт её продвигать, многократно вызывая .poll() (который возвращает Poll::Ready(value) при завершении или Poll::Pending иначе). Критично: стандартная библиотека Rust содержит трейт Future и синтаксис async/await, но сознательно НЕ содержит async runtime/executor вообще — довести Future до завершения требует отдельного крейта-исполнителя (tokio, async-std, smol и т.д.), осознанное дизайн-решение, отличающее Rust почти от любого другого mainstream-языка с async/await (JS, C#, Python поставляют runtime вместе с языком/стандартной библиотекой).Calling an async fn does NOT start running its body at all — it returns a Future that does nothing until something actively drives it forward by repeatedly calling .poll() (returning Poll::Ready(value) when done or Poll::Pending otherwise). Critically, Rust's standard library ships the Future trait and the async/await syntax but deliberately ships NO async runtime/executor at all — running a Future to completion requires a separate executor crate (tokio, async-std, smol, etc.), a deliberate design choice distinguishing Rust from essentially every other mainstream language with async/await (JS, C#, Python all bundle a runtime with the language/standard library).

Заметка про edition: сам синтаксис async/.await появился в языке только с выходом Rust 2018 — до этого писать асинхронный код можно было только через ручную реализацию Future (комбинаторный стиль поверх крейта futures 0.1), без какого-либо специального синтаксиса вообще. Это одна из главных причин, по которой edition 2018 стал крупным вехой в истории языка — не столько сам механизм Future (он появился раньше), сколько удобный поверхностный синтаксис для его использования.Edition note: the async/.await syntax itself only landed in the language with the Rust 2018 release — before that, writing asynchronous code meant manually implementing Future (a combinator style layered on the futures 0.1 crate), with no dedicated syntax at all. This is one of the main reasons edition 2018 was a major milestone in the language's history — not so much the Future mechanism itself (which predates it), but the convenient surface syntax for using it.

Объявление async fn fetch_data() -> String { ... } ничего не выполняет само по себе: let future = fetch_data(); лишь создаёт значение-Future. Продвигает её к завершению .await внутри другой async fn — примерно "опрашивай эту Future снова и снова (отдавая управление обратно executor'у между опросами), пока она не станет Ready". .await можно использовать только внутри async-контекста.Declaring async fn fetch_data() -> String { ... } executes nothing by itself: let future = fetch_data(); only creates a Future value. What drives it to completion is .await inside another async fn — roughly "poll this Future repeatedly (yielding control back to the executor between polls) until it's Ready". .await can only be used inside an async context.

async fn fetch_data() -> String {
    // ... сетевой запрос и т.п.// ... a network request or similar
    String::from("data")
}

async fn process() {
    let future = fetch_data();   // ничего не выполнилось, это просто значение Future// nothing has run yet, this is just a Future value
    let data = future.await;      // теперь она опрашивается до готовности// now it's polled until ready
    println!("{}", data);
}

Реальная программа мостит синхронную точку входа main в асинхронный мир через макрос конкретного runtime, например tokio:A real program bridges its synchronous entry point into the async world via a specific runtime's macro, e.g. tokio:

// глубоко в API tokio здесь не погружаемся — это тема ecosystem/// not diving deep into tokio's own API here — that's an ecosystem/ topic
#[tokio::main]
async fn main() {
    process().await;
}

• Asynchronous Programming in Rust — the async book
• std::future::Future — documentation