Expecting a top level declaration
Ai scris o instrucțiune (un apel ca println(...), o atribuire, un for) direct în fișier, în afara oricărei funcții. În Kotlin, la nivelul fișierului sunt permise doar declarații: fun, val, var, class, object. Mută instrucțiunea în main().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O declarație de nivel superior (top level declaration) este ce poate sta direct în fișier: fun, val, var, class, object, interface, import, package. Instrucțiunile care fac ceva (apeluri, bucle, atribuiri) trebuie să stea într-o funcție.
Când compilatorul găsește, de exemplu, println("x") direct în fișier, raportează Expecting a top level declaration de mai multe ori pe aceeași linie (câte o dată pentru fiecare bucată pe care n-o înțelege). Prima apariție e cea care contează.
Cea mai frecventă cauză este o acoladă } în plus care închide main prea devreme: restul codului ajunge „afară”, iar fiecare linie de după dă această eroare. Altă cauză: cod copiat din exemple sau din Kotlin script (.kts), unde instrucțiunile pot sta direct în fișier.
De ce apare: cauzele frecvente
1Apel direct în fișier
println("Start")
fun main() {
println("Program")
}fun main() {
println("Start")
println("Program")
}Codul care se execută trebuie să fie într-o funcție. Programul pornește din main, deci acolo pui apelurile.
2O acoladă în plus închide main prea devreme
fun main() {
if (true) {
println("a")
}}
println("b")
}fun main() {
if (true) {
println("a")
}
println("b")
}A doua } închide main, iar println("b") ajunge în afara funcției. Cu acoladele echilibrate instrucțiunea rămâne în main.
3Atribuire la nivelul fișierului
var contor = 0
contor = 5
fun main() {
println(contor)
}var contor = 5
fun main() {
println(contor)
}Declarația var contor = 0 e permisă în fișier, dar atribuirea contor = 5 e o instrucțiune. Dă valoarea direct la declarare sau fă atribuirea în main.
Repară eroarea, direct în pagină
Programul de mai jos dă eroarea Expecting a top level declaration, pentru că mesajul de bun venit este afișat în afara oricărei funcții. Repară codul ca să afișeze, în ordine: Bun venit la magazin! și apoi Produse in cos: 3.
println("Bun venit la magazin!")
fun main() {
val produse = listOf("paine", "lapte", "oua")
println("Produse in cos: ${produse.size}")
}Bun venit la magazin! Produse in cos: 3
Indiciu
Mută apelul println în interiorul lui main, înaintea celuilalt.
Reparația
fun main() {
println("Bun venit la magazin!")
val produse = listOf("paine", "lapte", "oua")
println("Produse in cos: ${produse.size}")
}De ce merge
Un apel de funcție este o instrucțiune, iar instrucțiunile nu pot sta direct în fișier: acolo Kotlin acceptă doar declarații (fun, val, class...). Mutând println("Bun venit la magazin!") ca primă linie din main, se execută la pornirea programului, înaintea mesajului cu numărul de produse.
Alte forme ale mesajului
error: syntax error: Expecting a top level declaration.
Cum o eviți pe viitor
Ține minte regula: în fișier pui doar declarații, iar tot ce se execută stă în main sau în alte funcții. Folosește formatarea automată ca să vezi imediat dacă o acoladă închide main prea devreme. Când copiezi exemple din documentație (care uneori sunt scripturi .kts), lipește-le în interiorul lui main.
Întrebări frecvente
De ce primesc aceeași eroare de 5-6 ori pe aceeași linie?
Compilatorul încearcă să interpreteze fiecare bucată de pe linie (numele funcției, paranteza, stringul) ca o declarație și raportează pentru fiecare. E o singură greșeală: mută linia în main.
Pot avea variabile globale în Kotlin?
Da: val și var la nivelul fișierului sunt declarații permise, de exemplu val TVA = 0.19. Doar atribuirile și apelurile ulterioare trebuie să fie în funcții.
Erori înrudite
Syntax error: Expecting '}' Un bloc deschis cu { (o funcție, un if, un for, o clasă) nu este închis până la sfârșitul fișierului. Compilatorul a ajuns la final și încă aștepta o acoladă. Găsește blocul neînchis și adaugă } la locul potrivit. Expecting ')' Compilatorul a ajuns la un punct în care aștepta o paranteză rotundă de închidere și n-a găsit-o. Aproape mereu ai uitat ) la un apel ca println(...) sau ai lăsat un string neînchis. Mergi la linia și coloana din mesaj și închide paranteza. Unresolved reference 'totl' Compilatorul nu găsește niciun nume totl: nu există o variabilă, funcție sau clasă cu numele ăsta în locul în care l-ai folosit. De obicei e o greșeală de scriere, o variabilă declarată în alt bloc sau un import lipsă. Corectează numele sau declară-l. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
