Bu belge ADR-024 ve RFC-0010 §2.1'in uygulama rehberidir. Faz ayrımı için derleyici faz modeli, kısmi AST sözleşmesi için AST/HIR invariant rehberi birlikte okunur.
Senkronizasyon modeli
hatalı cümle ──> SatirSonu
│
└─ varsa yalnız ona ait dengeli Girinti…Cikinti gövdesi
sonraki aynı-girintili kardeş ──> ayrıştırmaya devamParser token tahmini yapmaz ve sonraki yüklemi aramak için birden çok satırı körlemesine taramaz. Kaynakta güvenilir iki sınır zaten vardır: lexer'ın ürettiği satır sonu ve dengeli girinti tokenları. Kurtarma yalnız bu sınırları kullanır.
Bir bloktaki hata yerel tanı havuzuna alınır. Geçerli önceki ebeveyn düğümü ve sonraki kardeşler korunur; fiziksel blok derinliği çıkışta geri alınır. Hatalı başlık bir gövde açtıysa gövde bütünüyle atlanır, çünkü hangi alt cümlenin başlığa ait olduğu ancak dengeli girinti sınırıyla güvenle bilinir.
Kurtarma ile korunan her geçerli cümledeki yaprak ve bileşik ifadeler de ADR-030'un kesin kaynak zarfı kapısından geçer. Recovery spansiz/sentetik hata ifadesi üretmez; bir ifade güvenle kaynaklandırılamıyorsa o düğüm kısmi AST'ye alınmaz.
Özel bloklar
- Yapı alanında bozuk satır S025 olur; sonraki geçerli alan aynı yapıda kalır.
- Eşzamanlı görevde bozuk satır S038/ifade tanısı olur; sonraki görev korunur. Hiç geçerli görev kalmazsa boş
EszamanliAST'si üretilmez. göreiçinde bozuk kol ve ona ait gövde atlanır; sonraki geçerli değer kolu korunur. Hiç değer kolu kalmazsa boş eşleştirme düğümü üretilmez.- Bozuk
değilse/yetişmezsedevamı önceki geçerli ana bloğu düşürmez.
Tanı sırası ve bütçesi
dil denetle, dil denetle --json ve LSP aynı çoklu-tanı hattını kullanır. Parser, birim ve checker tanıları birlikte kaynak konumuna göre sıralanır; eşit konumda kod ve mesaj deterministik bağı çözer. Tek belge değişiminde en çok 20 tanı yayımlanır. Bu sınır, yazım sırasında oluşan tanı selinin editörü ve kullanıcıyı boğmasını önler.
Normal dil çalıştır ve derleme API'si ilk tanıda durur. Kurtarılan kısmi AST yalnız tanı toplamak içindir; checker başarısı ve typed HIR olmadan çalışmaz.
Yeni blok türü ekleme kontrol listesi
- Hatalı satırdan sonra güvenilir yatay ve dikey sınırı belirle.
- Alt gövde açılmışsa
bekleyen_govdeyi_atlaile yalnız o gövdeyi tüket. derinlikartırıldıysa hiçbir hata yolu onu yüksek bırakamaz.- Kısmi düğüm ADR-023 parser invariantlarından geçemiyorsa düğüm üretme; ana tanıyı döndür.
- Korunan ifade düğümlerinin ADR-030 kesin kaynak zarfını yitirmediğini doğrula.
- Hata öncesi ebeveyn, hata sonrası kardeş ve sonraki üst düzey tanım için recovery regresyonu ekle.
- LSP JSON'unda tanı sayısını, kodunu, sırasını ve 0 tabanlı aralığını sınar.
Kanıt
parser_kurtarma_testi.rs: iç kardeş sahipliği, yapı alanı, derinlik sızıntısı, eşzamanlı görev,görekolu ve 20 tanılık bütçe.lsp_testi.rs: bağımsız S025/S004 tanılarının kaynak sırası ve sahte C000 oluşmaması.- Fuzz hedefi hem normal hem kurtarmalı parser yolunu sürekli yürütür.
- Tam test, Clippy, release ve WASM kapıları davranış gerilemesini engeller.
Kaynak: docs/parser-hata-kurtarma.md · Bütün belgeler