...
Eroare Go · Erori de sintaxă

syntax error: imports must appear before other declarations

Pe scurt

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

Greșit
GO
package main

import "fmt"

func main() {
	fmt.Println(strings.ToUpper("salut"))
}

import "strings"
Corect
GO
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

Greșit
GO
package main

const TVA = 0.19

import "math"

func main() {}
Corect
GO
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ă tu

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 SAPTAMANII
Codul care dă eroarea
GO
package main

import "fmt"

func titlu(s string) string {
	return strings.ToUpper(s)
}

import "strings"

func main() {
	fmt.Println(titlu("oferta saptamanii"))
}
După reparație, programul afișează
OFERTA SAPTAMANII
Indiciu

Pune strings în același bloc import cu fmt, sus în fișier.

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

← Toate erorile Go

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.