error: unknown attribute 'State'
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
struct Contor: View {
@State var valoare = 0
var body: some View { Text("\(valoare)") }
}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
func incarca(_ gata: @escapng () -> Void) {}func incarca(_ gata: @escaping () -> Void) {}Pentru atributele limbajului, verifică ortografia: @escaping, @discardableResult, @MainActor.
3Cod de interfață într-un program fără SwiftUI
struct Contor {
@State var valoare = 0
}
var c = Contor()
c.valoare += 1struct 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ă 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.
struct Contor {
@State var valoare = 0
}
var c = Contor()
c.valoare += 1
print(c.valoare)1
Indiciu
În afara SwiftUI, @State nu există; scoate atributul.
Reparația
struct Contor {
var valoare = 0
}
var c = Contor()
c.valoare += 1
print(c.valoare)De ce merge
@State este un property wrapper definit în SwiftUI și există doar când modulul e importat. Aici programul folosește doar biblioteca standard, deci compilatorul nu cunoaște atributul. Într-un struct obișnuit, o proprietate var poate fi modificată direct pe o variabilă var c, așa că c.valoare += 1 duce valoarea la 1.
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 SwiftUIpentru@State,@Binding,@Environment;import Combinepentru@Published;import Observationsau SwiftUI pentru@Observable. - Folosește completarea automată când scrii atribute; ortografia greșită e prinsă imediat.
- Folosește
@Stateși@Bindingdoar î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
error: no such module 'UIKit' Modulul importat nu există pentru platforma sau proiectul în care compilezi: UIKit doar pe iOS, un pachet (Alamofire, Firebase) neadăugat în proiect sau un nume scris greșit. Adaugă pachetul, alege platforma potrivită sau scoate importul. Editorul nostru are doar biblioteca standard Swift. error: cannot find type 'Produs' in scope Folosești un tip (într-o adnotare : Tip, ca parametru sau ca tip de retur) pe care compilatorul nu îl cunoaște. De obicei numele e scris greșit, tipul nu a fost declarat sau vine dintr-un modul pe care nu îl ai (Foundation, UIKit). error: '@escaping' only applies to function types Ai pus @escaping pe un parametru care nu e o funcție, de exemplu un Int, un String sau un tablou. @escaping marchează doar closure-urile care trăiesc după terminarea funcției. Scoate-l de la parametrii obișnuiți; la closure-urile opționale nu e necesar. Î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.
