Ar Rust neveikia? Tiesioginė būsena ir sutrikimų pranešimai

Paslaugos informacija ir trikčių šalinimas

Rust kompiliatorius nepaleidžia projekto

Dažniausia problema – netinkama įrankių grandinės versija. Paleiskite rustup update, kad atnaujintumėte kompiliatorių ir susijusius komponentus. Jei projektas reikalauja konkrečios versijos, patikrinkite rust-toolchain.toml failą – ten nurodyta versija turi sutapti su įdiegta. Kartais pakanka paleisti rustup toolchain install stable iš naujo.

Cargo nepavyksta atsisiųsti priklausomybių

Tai beveik visada tinklo problema arba registro pasiekiamumo klausimas. Pirmiausia patikrinkite, ar crates.io pasiekiamas iš jūsų tinklo. Jei dirbate įmonės aplinkoje su ugniasiene, gali tekti sukonfigūruoti tarpinį serverį per CARGO_HTTP_PROXY aplinkos kintamąjį. Taip pat pabandykite išvalyti lokalią talpyklą: ištrinkite ~/.cargo/registry katalogą ir paleiskite cargo fetch iš naujo.

Lėta kompiliacija dideliuose projektuose

• Įjunkite inkrementinę kompiliaciją: nustatykite CARGO_INCREMENTAL=1
• Naudokite cargo check vietoj cargo build tikrinant kodą – tai žymiai greičiau
• Perjunkite į mold arba lld nuorodų redaktorių, nes standartinis gali būti lėtas
• Sumažinkite priklausomybių skaičių – kiekviena papildoma biblioteka ilgina kompiliavimą

Rust analizatorius neveikia redaktoriuje

Jei rust-analyzer nerodo klaidų ar autoužbaigimo, pirma patikrinkite, ar įdiegta tinkama versija per rustup component add rust-analyzer. Redaktoriaus plėtinys kartais naudoja seną dvejetainį failą – nurodykite kelią rankiniu būdu plėtinio nustatymuose. Jei projektas naudoja workspace struktūrą, atidarykite šakninį katalogą, o ne poaplankį.

Testai staiga pradeda strigt

Tai dažnai susiję su lygiagretumu – standartiškai testai vykdomi keliose gijose. Jei testai naudoja bendrus išteklius ar aplinkos kintamuosius, paleiskite juos su cargo test -- --test-threads=1. Taip pat patikrinkite, ar nėra undefined behavior, naudodami cargo miri.

Binarinis failas veikia lėčiau nei tikėtasi

• Įsitikinkite, kad kompiliuojate su --release žyme
• Patikrinkite opt-level nustatymą Cargo.toml profiliuose
• Naudokite cargo flamegraph arba perf įrankius našumo analizei

Dokumentacijos generavimas nutrūksta

Jei cargo doc meta klaidas, dažniausiai kaltos netinkamai suformatuotos doc komentarų eilutės arba trūkstamos priklausomybės. Paleiskite cargo doc --no-deps, kad apribotumėte generavimą tik savo kodu ir greičiau rastumėte problemos šaltinį.