anyhow
Elastyczna obsługa błędów aplikacji
anyhow to bezpłatna lekcja Learn Rust Coding na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Learn Rust Coding, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Learn Rust Coding zawiera 4 lekcji w sumie.
Elastyczne błędy aplikacji
W kodzie aplikacji często wystarczy przekazywać błędy wyżej wraz z kontekstem, bez definiowania osobnego typowanego enuma dla każdego przypadku. Crate anyhow udostępnia jeden prosty typ błędu dokładnie do tego celu.
Dodawanie anyhow
Należy dodać go jako zależność. Dobrze współpracuje z thiserror: thiserror służy bibliotekom, a anyhow plikom binarnym.
[dependencies]
anyhow = "1.0"Alias anyhow::Result
anyhow::Result<T> jest skrótem dla Result<T, anyhow::Error>. Typ Error może przechowywać dowolny błąd implementujący std::error::Error.
use anyhow::Result;
fn load() -> Result<String> {
let text = std::fs::read_to_string("config.txt")?;
Ok(text)
}Automatyczna konwersja
Operator ? automatycznie konwertuje każdy standardowy błąd na anyhow::Error, dzięki czemu można swobodnie łączyć różne typy błędów.
use anyhow::Result;
fn parse_file(path: &str) -> Result<i32> {
let text = std::fs::read_to_string(path)?; // io error
let n: i32 = text.trim().parse()?; // parse error
Ok(n)
}Dodawanie kontekstu
Metoda .context() dołącza do błędu komunikat zrozumiały dla człowieka, tworząc czytelny łańcuch w przypadku niepowodzenia.
use anyhow::{Context, Result};
fn read_config(path: &str) -> Result<String> {
let text = std::fs::read_to_string(path)
.context("failed to read config file")?;
Ok(text)
}Kontekst tworzony leniwie
Należy użyć with_context, gdy utworzenie komunikatu jest kosztowne lub wymaga danych dostępnych w czasie działania programu; closure zostanie wykonane tylko w przypadku błędu.
use anyhow::{Context, Result};
fn open(path: &str) -> Result<String> {
std::fs::read_to_string(path)
.with_context(|| format!("could not open {path}"))
}Tworzenie błędów ad hoc
Makro anyhow! tworzy błąd na podstawie komunikatu, a bail! natychmiast zwraca taki błąd.
use anyhow::{anyhow, bail, Result};
fn check(age: i32) -> Result<()> {
if age < 0 {
bail!("age cannot be negative");
}
if age > 150 {
return Err(anyhow!("age {age} is implausible"));
}
Ok(())
}Używanie ensure!
ensure! działa podobnie jak assert!, ale zamiast wywoływać panic, zwraca błąd.
use anyhow::{ensure, Result};
fn divide(a: i32, b: i32) -> Result<i32> {
ensure!(b != 0, "division by zero");
Ok(a / b)
}anyhow w main
Należy zwracać anyhow::Result<()> z main, aby w przypadku niepowodzenia otrzymać czytelnie sformatowane łańcuchy błędów.
use anyhow::Result;
fn main() -> Result<()> {
let text = std::fs::read_to_string("data.txt")?;
println!("{text}");
Ok(())
}Sprawdzanie przyczyny
Mimo że anyhow::Error jest nieprzezroczysty, nadal można go analizować. downcast_ref odzyskuje konkretny typ błędu, gdy trzeba rozgałęzić działanie programu na jego podstawie.
use anyhow::Result;
fn report(err: anyhow::Error) {
if let Some(io) = err.downcast_ref::<std::io::Error>() {
println!("io error: {io}");
} else {
println!("other error: {err}");
}
}thiserror a anyhow
Praktyczna zasada:
- thiserror — biblioteki i typowane błędy, które kod wywołujący może dopasowywać
- anyhow — aplikacje, w których wystarczy przekazywać błędy wraz z kontekstem
Błąd z thiserror można płynnie przekonwertować na anyhow za pomocą ?.
Szybkie sprawdzenie
Jaka metoda anyhow dołącza opisowy komunikat do błędu podczas jego przekazywania?
Podsumowanie
Poznał(a) Pan/Pani crate anyhow:
anyhow::Result<T>używa jednego elastycznego typu błędu?automatycznie konwertuje każdy standardowy błąd.context()/with_context()dodają czytelne komunikatyanyhow!,bail!iensure!tworzą błędy- Najlepiej sprawdza się w kodzie aplikacji (plików binarnych)
Często zadawane pytania
Czy lekcja „anyhow” jest bezpłatna?
Tak — pełny tekst „anyhow” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Learn Rust Coding, przejdź na CoddyKit PRO. Kurs Learn Rust Coding zawiera 4 lekcji w sumie.
Co nauczysz się w „anyhow”?
Elastyczna obsługa błędów aplikacji Ćwiczysz Learn Rust Coding z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Learn Rust Coding?
Nie wymagamy żadnego doświadczenia. Learn Rust Coding w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.
Ile czasu zajmuje lekcja „anyhow”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Learn Rust Coding?
Tak. Każda lekcja Learn Rust Coding zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.