学习路上的疑惑
为什么在看过一些博客或是文档后，过上一两天，也可能是半天就忘记了呢？
反思后，我意识到有两个方面的问题：一是没有进行实践，多敲代码，是学习的唯一捷径！二是没有总结归纳，形成自己的知识体系！
so,开始我的学习笔记之路。
文笔粗略,请多多宽宥~

这是在学习网络请求时遇到了@frozen，寻求度娘帮助时，顺带记录一下
原文链接：https://docs.swift.org/swift-book/ReferenceManual/Attributes.html

@objc

在接触swift后，这是我遇见频次最高的一个标记。用来告知编译器，被其修饰的类、方法、属性、协议等可以被OC使用。
这是由于Objective-C 中所有类都继承自NSObject，Swift 中的类如果要供 Objective-C 调用，必须也继承自NSObject。
例如：
1.用在方法前： 例如给button添加的点击事件，需要被@objc修饰
2.用在protocol前：标记为 objc 特性的协议不能继承自非 objc 特性的协议
3.用在class前：用 objc 特性标记的类必须继承自一个 OC 中定义的类

此外，@objc还可以用来解决潜在的命名冲突问题。
例如同时应用于OC和swift的一些三方库，由于swift有自己的命名空间，而OC没有，所以一些用swift实现的代码，在OC中使用时，会出现命名冲突问题，此时可以使用
@objc(OC中使用的名字) 来解决

//OC中使用该类时，是通过类名OCClassName
@objc(OCClassName)
open class ClassName: NSObject { }

// 当在OC代码中访问enabled的getter方法时，是通过isEnabled
class ExampleClass: NSObject {
    @objc var enabled: Bool {
        @objc(isEnabled) get {
            // Return the appropriate value
        }
    }
}

注意：
添加@objc修饰符并不意味着这个方法或者属性会采用 Objective-C 的方式变成动态派发，Swift 依然可能会将其优化为静态调用
怎么验证这个问题？——可通过汇编语言

@objcMembers

被@objcMembers修饰的类，将会默认将其属性和方法、子类、扩展等都添加上@objc修饰

@ nonobjc

把这个特性应用到一个方法，属性，下标，或者初始化器的声明中，废除一个隐式 objc 特性

@available

这是另一个比较常用的修饰词了，声明其相对于特定平台和操作系统版本的生命周期。
示例一：

if #available(iOS 11.0, *) {
  scrollView.contentInsetAdjustmentBehavior = .never
} else {
  automaticallyAdjustsScrollViewInsets = false
}

示例二：

@available(iOS 12.0, *)
func adjustDarkMode() {
  /* code */
}

用来标识依赖于特定的平台版本 或 Swift 版本

@discardableResult

带返回的函数如果没有处理返回值会被编译器警告⚠️，此时可以在方法名前用@discardableResult声明一下，来消除警告。

@main

把这个特性应用到结构体、类或枚举声明中，来表明它在程序流程中包含顶层入口。
类型必须提供一个不接收任何实际参数并且返回 Void 的 main 类型函数

@dynamicCallable

为类、结构体、枚举或者协议添加这个特性来将这个类型的实例视为可调用函数。类型要么实现 dynamicallyCall(withArguments:) 方法，要么实现 dynamicallyCall(withKeywordArguments:) ，也可以两者都实现

@dynamicMemberLookup

应用这个特性到类、结构体、枚举或者协议来允许在运行时可通过名字查找成员。类型必须实现一个 subscript(dynamicMemberLookup:) 下标脚本

@inlinable

告知编译器，被@inlinable声明的部分需要内联。
例如@inlinable声明的方法A，编译器在编译的时候，将会自动将调用方法的地方，替换为方法的具体实现，以提升运行效率

@warn_unqualified_access

对不合规的访问进行警告。
例如用在函数调用会产生二义性的地方

@testable

@testable是用于测试模块访问主target的一个关键词。
因为测试模块和主工程是两个不同的target，在swift中，每个target代表着不同的module，不同module之间访问代码需要public和open级别的关键词支撑。但是主工程并不是对外模块，为了测试修改访问权限是不应该的，所以有了@testable关键词。使用如下：

import XCTest
@testable import Project
 
class ProjectTests: XCTestCase {
  /* code */
}

@frozen

冻结，是为Swift5的ABI稳定准备的一个字段，意味向编译器保证之后不会做出改变

给结构体或者枚举声明添加此特性来限制你可对此类型能做的变更种类。这个特性仅在库演进模式编译中允许使用。未来版本的库不能通过添加、删除、改变枚举情况或者是改变结构体存储实例属性的顺序来改变声明。这些改变在不冻结的类型中允许，但它们会打乱冻结类型的 ABI 兼容性。

@unknown default

常用于switch某枚举，这是由于该枚举的值在未来可能会发生变化，因此在列出所有case的时候还需要加上对@unknown default的判断

@GKInspectable

用这个特性可以把一个自定义的 GameplayKit 组件属性显示到 SpriteKit 编辑器界面中。使用这个特性也就隐式地使用了 objc 特性

@NSApplicationMain

将这个特性应用于一个类中，来指明它是应用的委托。用这个特性等同于调用 NSApplicationMain(::) 函数。

如果你使用这个特性，需要提供一个 main.swift 文件，在其代码的最上层调用如下 NSApplicationMain(::) 函数：

import AppKit
NSApplicationMain(CommandLine.argc, CommandLine.unsafeArgv)

@UIApplicationMain

给一个类用这个特性，以指出它是应用的委托。用这个特性等同于用调用 UIApplicationMain 函数并把这个类名作为委托类的名字传进函数中。

如果你不用这个特性，需要提供一个 main.swift 文件，在其代码的最上层调用 UIApplicationMain(:::) 函数。例如，如果你的app用了一个 UIApplication 的自定义子类作为它的主要类，调用 UIApplicationMain(:::) 函数，而不是使用这个特性。

@NSCopying

这个特性用于一个类的可变存储属性中。这个特性让属性值（由 copyWithZone(_:) 方法返回，而不是属性本身的值）的拷贝合成属性的setter。属性的类型必须遵循 NSCopying 协议。

从某种程度上来说， NSCopying 特性的行为类似 Objective-C 中的 copy 属性特性。

@NSManaged

把这个特性应用于一个继承自 NSManagedObject 的类的实例方法或可变存储属性中，以指明 Core Data 会在运行时根据相关的实体描述动态提供它的实现。对于标记为 NSManaged 特性的属性，Core Data 还会在运行时提供存储。用这个特性还隐含 objc 特性。

@propertyWrapper

把这个特性应用给类、结构体或者枚举的声明来把对应的类型作为属性包装器使用。当你给类型使用这个特性时，你就创建了一个与这个类型同名的自定义特性。把这个新的特性应用给类型、结构体或者枚举的属性来使用包装器的实例包装属性的访问；把特性应用给本地存储变量声明以相同方式包装这个变量的访问。计算变量、全局变量和常量不能使用属性包装器。

包装器必须定义一个 wrappedValue 实例属性。包装属性的值就是这个属性暴露的 getter 和 setter。大多数情况下， wrappedValue 是一个计算值，但也可以是存储值。包装器定义和管理任何被包装值需要的存储。编译器会通过在包装的属性名称前添加下划线（ _ ）来合成对应实例所需要的存储——比如说， someProperty 的包装器会以 _someProperty 的形式存储。包装器合成存储的访问控制权限为 private 级。

有属性包装器的属性可包含 willSet 和 didSet 代码块，但它不能重写编译器合成的 get 和 set 代码块。

@resultBuilder

把这个特性应用给类、结构体、枚举来把对应类型作为结果建造器使用。结果建造器是一个逐步建造内嵌数据结构的类型。你可使用结果建造器来实现一个自然声明式的领域特定语言（DSL）以创建内嵌数据结构

@requires_stored_property_inits

给类声明应用这个特性来要求所有的存储属性都必须在声明时提供默认值。这个属性会从所有继承 NSManagedObject 的类中推断出来。

@usableFromInline

给函数、方法、计算属性、下标脚本、初始化器或者反初始化器声明添加这个属性来允许符号用于定义在同一个模块作为声明的行内代码里。

通过 Interface Builder 使用声明特性

Interface Builder 特性是用于 Interface Builder 和 Xcode 同步的声明特性。Swift 提供了下列 Interface Builde r特性： IBAction ， IBOutlet ， IBDesignable ,和 IBInspectable 。这些特性概念上和 Objective-C 中的相同。

你可以把 IBOutlet 和 IBInspectable 特性应用于一个类的属性声明中。把 IBAction 特性用于一个类的方法声明，把 IBDesignable 特性用于类的声明。

IBAction 和 IBOutlet 特性都隐含 objc 特性。

类型特性

@autoclosure

这个特性用于，通过自动包装没有实际参数的表达式来延迟对表达式的求值。这个特性用于一个方法或函数声明的形式参数类型中，该形式参数是一个函数类型，这个函数类型不接受实际参数并且返回一个表达式的类型的值

@convention

把这个特性应用于一个函数的类型以指明它的调用约定。
convention 特性总是和下列特性实际参数中的一个同时出现：

swift 实际参数用于指明一个 Swift 函数引用。在 Swift 中，这是函数值的标准调用约定。
block 实际参数用于指明一个 Objective-C 兼容的闭包引用。函数值表示为对闭包对象的一个引用，它是一个兼容 id 的、在其中嵌入它的调用函数的 Objective-C 对象。调用函数用 C 调用约定。
c 实际参数用于指明一个 C 函数引用。函数值不携带上下文并且使用 C 调用确定
除了少数例外，当需要任何其他调用约定的函数时，可以使用任何调用约定的函数。非泛型全局函数，和局部函数或不捕获任何局部变量的闭包，可以转换为 C 调用约定。其他 Swift 函数不能转换为 C 调用约定。一个带有 Objective-C 闭包调用约束的函数不能转换为 C 调用约定

@escaping

将这个特性应用到一个方法或函数声明的形式参数类型中，以指明可以存储该形式参数值用于稍后执行。这意味着允许那个值超过调用它的范围而存在。 escaping 类型特性的函数类型形式参数需要为属性或方法显式使用 self.

以下摘自https://juejin.cn/post/6844903924084768776

@State

被 @State 装饰过的属性发生了变化，SwiftUI 会根据新的属性值重新创建视图

@Binding

被@Binding 的修饰的值类型属性，具有引用类型传递值的特性

@ObservedObject

从名字看来它是来修饰一个对象的，这个对象可以给多个独立的 View 使用。如果你用 @ObservedObject 来修饰一个对象，那么那个对象必须要实现 ObservableObject 协议，然后用 @Published 修饰对象里属性，表示这个属性是需要被 SwiftUI 监听的

@EnvironmentObject

通过它，我们可以避免在初始 View 时创建 ObservableObject, 而是从环境中获取 ObservableObject

@Environment

通过 @Environment 修饰的属性，我们开一个监听系统级别信息的变换

参考文章：
1.https://blog.csdn.net/zfqh111/article/details/107082018
2.https://juejin.cn/post/6844903825061445640
3.https://mp.weixin.qq.com/s?__biz=MzkwMDIxNDA3NA==&mid=2247483745&idx=1&sn=8f1db6e0a109754ed73bd3438f64285e&chksm=c0463d34f731b4222e8c238448d19e71f801b25d459b57be673305bcee2ae9cd5aa09a120f01&token=912344454&lang=zh_CN#rd
4.https://juejin.cn/post/6844903924084768776