anyhow
Errori flessibili nelle applicazioni
anyhow è una lezione Learn Rust Coding gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Learn Rust Coding, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Learn Rust Coding include 4 lezioni in totale.
Errori flessibili nelle applicazioni
Nel codice delle applicazioni spesso si desidera semplicemente propagare gli errori con il relativo contesto, senza definire un enum tipizzato per ciascuno di essi. Il crate anyhow fornisce un unico tipo di errore semplice, pensato proprio per questo.
Aggiungere anyhow
Lo aggiunga come dipendenza. Si abbina bene a thiserror: thiserror per le librerie, anyhow per i binari.
[dependencies]
anyhow = "1.0"L'alias anyhow::Result
anyhow::Result<T> è una forma abbreviata di Result<T, anyhow::Error>. Il tipo Error può contenere qualsiasi errore che implementi std::error::Error.
use anyhow::Result;
fn load() -> Result<String> {
let text = std::fs::read_to_string("config.txt")?;
Ok(text)
}Conversione automatica
L'operatore ? converte automaticamente qualsiasi errore standard in anyhow::Error, permettendo così di combinare liberamente tipi di errore diversi.
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)
}Aggiungere contesto
Il metodo .context() associa a un errore un messaggio comprensibile, creando una catena leggibile quando qualcosa non va.
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)
}Contesto valutato pigramente
Usi with_context quando costruire il messaggio è costoso o richiede dati di runtime; la closure viene eseguita solo in caso di errore.
use anyhow::{Context, Result};
fn open(path: &str) -> Result<String> {
std::fs::read_to_string(path)
.with_context(|| format!("could not open {path}"))
}Creare errori ad hoc
La macro anyhow! costruisce un errore a partire da un messaggio, mentre bail! interrompe l'esecuzione restituendone uno.
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(())
}Usare ensure!
ensure! è simile a assert!, ma restituisce un errore invece di causare un panic.
use anyhow::{ensure, Result};
fn divide(a: i32, b: i32) -> Result<i32> {
ensure!(b != 0, "division by zero");
Ok(a / b)
}anyhow in main
Restituisca anyhow::Result<()> da main per ottenere catene di errori formattate in modo chiaro quando si verifica un errore.
use anyhow::Result;
fn main() -> Result<()> {
let text = std::fs::read_to_string("data.txt")?;
println!("{text}");
Ok(())
}Esaminare la causa
Anche se anyhow::Error è opaco, è comunque possibile esaminarlo. downcast_ref recupera un tipo di errore concreto quando occorre eseguire un ramo diverso in base ad esso.
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 o anyhow
Regola generale:
- thiserror — librerie, errori tipizzati su cui chi chiama il codice può usare match
- anyhow — applicazioni, per propagare gli errori con il relativo contesto
È possibile convertire senza difficoltà un errore thiserror in anyhow con ?.
Verifica rapida
Quale metodo di anyhow associa a un errore un messaggio descrittivo durante la propagazione?
Riepilogo
Ha imparato a usare il crate anyhow:
anyhow::Result<T>usa un unico tipo di errore flessibile?converte automaticamente qualsiasi errore standard.context()/with_context()aggiungono messaggi leggibilianyhow!,bail!edensure!creano errori- È ideale per il codice delle applicazioni (binari)
Domande Frequenti
La lezione «anyhow» è gratuita?
Sì — il testo completo di «anyhow» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Learn Rust Coding, passa a CoddyKit PRO. Il corso Learn Rust Coding include 4 lezioni in totale.
Cosa imparerò in «anyhow»?
Errori flessibili nelle applicazioni Eserciti Learn Rust Coding con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Learn Rust Coding?
Non è richiesta alcuna esperienza precedente. Learn Rust Coding su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «anyhow»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Learn Rust Coding?
Sì. Ogni lezione Learn Rust Coding include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.