syntax error: imports must appear before other declarations
Ai pus un import după o funcție, o variabilă, o constantă sau un tip. În Go ordinea fișierului e fixă: package, apoi toate importurile, apoi restul. Mută blocul import imediat sub linia package.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un fișier Go are trei părți, mereu în aceeași ordine: clauza package, declarațiile import și abia apoi declarațiile obișnuite (func, var, const, type). Compilatorul citește fișierul de sus în jos și, când găsește un import după ce a văzut deja o funcție sau o variabilă, se oprește cu syntax error: imports must appear before other declarations.
Poziția din mesaj (de exemplu main.go:9:1) arată linia importului rătăcit, nu declarația de dinainte. Apare de obicei când lipești o bucată de cod dintr-un exemplu care are propriul import în mijlocul fișierului, când adaugi de mână un pachet nou la final sau când unești două fișiere într-unul.
Nu contează câte importuri ai: pot fi mai multe blocuri import (...) sau linii import "fmt", dar toate trebuie să stea înainte de prima declarație.
De ce apare: cauzele frecvente
1Import adăugat la finalul fișierului
package main
import "fmt"
func main() {
fmt.Println(strings.ToUpper("salut"))
}
import "strings"package main
import (
"fmt"
"strings"
)
func main() {
fmt.Println(strings.ToUpper("salut"))
}Toate pachetele stau în blocul import de sus. Un singur bloc cu paranteze e forma pe care o produce și gofmt.
2Cod lipit cu importul lui în mijlocul fișierului
package main
const TVA = 0.19
import "math"
func main() {}package main
import "math"
const TVA = 0.19
func main() {}Constanta este o declarație, deci importul trebuie să fie înaintea ei, chiar dacă e un singur pachet.
Repară eroarea, direct în pagină
Programul afișează un titlu cu litere mari, dar nu compilează: syntax error: imports must appear before other declarations, pentru că importul pachetului strings a ajuns sub funcție. Mută-l unde trebuie ca programul să afișeze:
OFERTA SAPTAMANIIpackage main
import "fmt"
func titlu(s string) string {
return strings.ToUpper(s)
}
import "strings"
func main() {
fmt.Println(titlu("oferta saptamanii"))
}OFERTA SAPTAMANII
Indiciu
Pune strings în același bloc import cu fmt, sus în fișier.
Reparația
package main
import (
"fmt"
"strings"
)
func titlu(s string) string {
return strings.ToUpper(s)
}
func main() {
fmt.Println(titlu("oferta saptamanii"))
}De ce merge
Compilatorul acceptă importuri doar între clauza package și prima declarație. După ce a văzut funcția titlu, orice import devine o eroare de sintaxă. În blocul de sus, strings este disponibil în tot fișierul, deci și în titlu, care a fost declarată înainte de main.
Cum o eviți pe viitor
Lasă editorul să gestioneze importurile: goimports (sau extensia Go din VS Code / GoLand) adaugă automat pachetele folosite în blocul de sus și le șterge pe cele nefolosite la salvare. Când lipești cod din alt fișier, mută-i importurile în blocul existent în loc să le copiezi ca atare.
Întrebări frecvente
Pot avea mai multe blocuri import?
Da, import "fmt" urmat de import "os" este valid, dar ambele trebuie să fie înaintea oricărei funcții, variabile, constante sau tip. Convenția este un singur bloc import (...).
Pot importa un pachet doar într-o funcție?
Nu. Importurile sunt la nivel de fișier, nu de funcție: un pachet importat este vizibil în tot fișierul în care l-ai importat.
Erori înrudite
syntax error: non-declaration statement outside function body Ai scris o instrucțiune (de exemplu x := 5 sau un apel de funcție) direct în fișier, în afara oricărei funcții. În afara funcțiilor Go acceptă doar declarații: var, const, type, func, import. Mută instrucțiunea în main() sau folosește var x = 5. expected 'package', found 'import' Fișierul .go nu începe cu declarația package. Orice fișier Go trebuie să înceapă (după comentarii) cu package main sau package <nume>. Adaugă linia package main deasupra importurilor. "os" imported and not used Ai importat un pachet pe care nu îl folosești în fișier. În Go asta e eroare de compilare. Șterge importul sau folosește pachetul; editoarele cu goimports adaugă și șterg automat importurile. Învață Go de la zero, cu exerciții la fiecare lecție
Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
