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

error: unknown attribute 'State'

Pe scurt

Compilatorul nu cunoaște atributul scris cu @. Fie lipsește importul modulului care îl definește (@State și @Binding vin din SwiftUI, @Published din Combine), fie ai scris greșit numele (@escapng). Adaugă importul sau corectează numele.

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

Ce înseamnă

Atributele încep cu @: unele sunt ale limbajului (@escaping, @MainActor, @discardableResult), altele sunt property wrappers sau macro-uri definite în biblioteci (@State, @Binding, @Published, @Observable). Mesajul spune că numele de după @ nu corespunde niciunui atribut cunoscut în fișierul curent.

Cele mai frecvente cauze: lipsește import SwiftUI sau import Combine în fișier (fiecare fișier are importurile lui), numele e scris greșit sau cu literă mică (@state), ori codul e compilat într-un mediu unde modulul nu există. Editorul din browser al cursului are doar biblioteca standard Swift, fără SwiftUI, deci acolo atributele acestea nu pot fi folosite.

Coordonatele arată atributul. Dacă e un property wrapper propriu, verifică să fie declarat cu @propertyWrapper.

De ce apare: cauzele frecvente

1Lipsește importul

Greșit
SWIFT
struct Contor: View {
    @State var valoare = 0
    var body: some View { Text("\(valoare)") }
}
Corect
SWIFT
import SwiftUI

struct Contor: View {
    @State var valoare = 0
    var body: some View { Text("\(valoare)") }
}

@State este definit în SwiftUI; fără import, compilatorul nu îl cunoaște.

2Nume scris greșit

Greșit
SWIFT
func incarca(_ gata: @escapng () -> Void) {}
Corect
SWIFT
func incarca(_ gata: @escaping () -> Void) {}

Pentru atributele limbajului, verifică ortografia: @escaping, @discardableResult, @MainActor.

3Cod de interfață într-un program fără SwiftUI

Greșit
SWIFT
struct Contor {
    @State var valoare = 0
}
var c = Contor()
c.valoare += 1
Corect
SWIFT
struct Contor {
    var valoare = 0
}
var c = Contor()
c.valoare += 1

În afara unui view SwiftUI, @State nu are rost; o proprietate var simplă face același lucru.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos a fost copiat dintr-un view SwiftUI, dar rulează ca program simplu, fără SwiftUI, iar compilarea se oprește cu unknown attribute 'State'. Fă din valoare o proprietate obișnuită, ca programul să afișeze 1.

Codul care dă eroarea
SWIFT
struct Contor {
    @State var valoare = 0
}

var c = Contor()
c.valoare += 1
print(c.valoare)
După reparație, programul afișează
1
Indiciu

În afara SwiftUI, @State nu există; scoate atributul.

Alte forme ale mesajului

  • error: unknown attribute 'Published'
  • error: unknown attribute 'Binding'
  • error: unknown attribute 'escapng'

Cum o eviți pe viitor

  • Verifică importurile din fiecare fișier: import SwiftUI pentru @State, @Binding, @Environment; import Combine pentru @Published; import Observation sau SwiftUI pentru @Observable.
  • Folosește completarea automată când scrii atribute; ortografia greșită e prinsă imediat.
  • Folosește @State și @Binding doar în view-uri SwiftUI.
  • Pentru property wrappers proprii, declară tipul cu @propertyWrapper.

Întrebări frecvente

De ce merge în Xcode și nu în editorul din curs?

Editorul din browser are doar biblioteca standard Swift, fără SwiftUI sau Combine. Codul de interfață îl rulezi în Xcode, iar logica o poți exersa în editor.

Am importat SwiftUI și tot primesc eroarea. Ce verific?

Ortografia și literele mari (@State, nu @state) și dacă fișierul face parte din target-ul aplicației. Pe platforme fără SwiftUI, cum e Linux, importul nu există.

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.