...
Eroare Swift · Module, @main și mediu

error: 'main' attribute cannot be used in a module that contains top-level code

Pe scurt

Ai pus @main pe un tip, dar în același modul există și cod la nivel de fișier (de obicei în main.swift). Un program are un singur punct de pornire: ori @main, ori main.swift cu cod de sus în jos. Scoate @main și apelează App.main(), sau redenumește fișierul și mută codul de la nivelul fișierului.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un program Swift poate porni în două feluri:

  • prin cod de nivel superior într-un fișier numit main.swift, care rulează de sus în jos;
  • printr-un tip marcat cu @main, care are o metodă static func main(). Așa pornesc aplicațiile SwiftUI (@main struct App: App) și multe unelte de linie de comandă.

Nu pot exista amândouă: compilatorul n-ar ști de unde să înceapă. Mesajul apare când un tip marcat @main stă în main.swift sau când alt fișier al modulului conține cod de nivel superior.

Soluțiile: scoți @main și apelezi metoda manual din main.swift (App.main()), sau redenumești fișierul (de exemplu App.swift) și muți instrucțiunile din afara tipurilor în main(). Editorul din pagină compilează un singur fișier numit main.swift, deci aici varianta potrivită e prima.

De ce apare: cauzele frecvente

1@main în main.swift

Greșit
SWIFT
@main
struct App {
    static func main() { print("Pornit") }
}
Corect
SWIFT
struct App {
    static func main() { print("Pornit") }
}
App.main()

În main.swift, punctul de pornire e codul de sus în jos, deci apelezi tu main().

2Cod de test lăsat în afara tipului

Greșit
SWIFT
@main
struct Unealta {
    static func main() { print("Rulez") }
}
print("test")
Corect
SWIFT
@main
struct Unealta {
    static func main() {
        print("Rulez")
        print("test")
    }
}

Într-un fișier care nu e main.swift, codul trebuie mutat în main() (exemplul din dreapta presupune un fișier Unealta.swift).

Repară tu

Repară eroarea, direct în pagină

Codul unei unelte de linie de comandă a fost lipit într-un singur fișier main.swift. Programul trebuie să afișeze Pornire unealta, apoi Gata, dar compilarea se oprește cu 'main' attribute cannot be used in a module that contains top-level code. Scoate @main și apelează Unealta.main() înainte de ultimul print.

Codul care dă eroarea
SWIFT
@main
struct Unealta {
    static func main() {
        print("Pornire unealta")
    }
}

print("Gata")
După reparație, programul afișează
Pornire unealta
Gata
Indiciu

Fără @main, metoda main() trebuie apelată explicit.

Cum o eviți pe viitor

  • Alege un singur stil de pornire pe proiect: main.swift sau @main.
  • În proiectele SwiftUI și în pachetele noi cu @main, nu crea un fișier main.swift.
  • Nu lăsa instrucțiuni de test în afara funcțiilor în fișierele care nu sunt main.swift; acolo primești alte erori („expressions are not allowed at the top level”).

Întrebări frecvente

De ce @main merge în Xcode și nu aici?

În Xcode, tipul cu @main stă de obicei într-un fișier ca App.swift, iar proiectul nu are main.swift. Editorul de aici compilează un singur fișier main.swift, care e tratat mereu ca script cu cod de nivel superior.

Pot avea și @main și main.swift în același proiect?

Nu în același modul. Dacă ai nevoie de ambele, mută codul în module diferite (de exemplu o bibliotecă și un executabil).

Erori înrudite

← Toate erorile Swift

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ță Swift de la zero, cu exerciții la fiecare lecție

Curs Swift (iOS): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.