#define NS_REQUIRES_SUPER   __attribute__((objc_requires_super))
#define NS_DESIGNATED_INITIALIZER __attribute__((objc_designated_initializer))
#define API_AVAILABLE(...)  __attribute__((availability(...)))

// 典型用法：注册默认值 / 交换方法 / 初始化全局状态
__attribute__((constructor))
static void registerAnalyticsDefaults(void) {
    [[NSUserDefaults standardUserDefaults]
        registerDefaults:@{@"tracking_enabled": @YES}];
}

// 甚至可以给 C++ 静态构造函数指定优先级
// （这是 LLVM 特有扩展，GCC 对 C++ 不支持 constructor 优先级）
__attribute__((constructor(101)))
static void beforeAllCXXConstructors(void) {
    // 在 C++ 全局对象构造之前运行
}

// 定义一个 defer block 类型
typedef void (^cleanup_block_t)(void);

static inline void defer_block_cleanup(cleanup_block_t *block) {
    if (*block) (*block)();
}

// 核心宏：用 cleanup 保证 block 在作用域结束时执行
#define defer __strong cleanup_block_t __attribute__((cleanup(defer_block_cleanup))) __cleanup_block = ^

// 使用
- (void)doSomething {
    defer {
        NSLog(@"无论如何都会执行——类似 Go 的 defer");
        [self unlock];
    };

    [self lock];
    // 复杂逻辑...
    if (someError) return; // 也会触发 defer
    // ...
}

__attribute__((objc_subclassing_restricted))
@interface AFHTTPSessionManager : NSObject
@end

// 等同于 Swift 的 final class
// 编译时检查：任何试图继承的代码都会报错
@interface MyManager : AFHTTPSessionManager  // ❌ Cannot subclass a class that was declared with objc_subclassing_restricted
@end

@interface MyView : UIView

- (instancetype)initWithFrame:(CGRect)frame
    __attribute__((objc_designated_initializer));  // 指定初始化器

- (instancetype)initWithFrame:(CGRect)frame style:(NSInteger)style
    __attribute__((objc_designated_initializer));  // 可以有多个

- (instancetype)initWithCoder:(NSCoder *)coder
    __attribute__((objc_designated_initializer));

@end

@implementation MyView

// 便捷初始化器必须调用指定初始化器
- (instancetype)init {
    // 如果不调用 [self initWithFrame:]，编译器警告：
    // ⚠️ Convenience initializer missing a 'self' call to another initializer
    return [self initWithFrame:CGRectZero];
}

@end

@interface BaseViewController : UIViewController

- (void)viewDidLoad __attribute__((objc_requires_super));
- (void)setupNavigationBar __attribute__((objc_requires_super));

@end

@implementation MyViewController

- (void)viewDidLoad {
    // ⚠️ Method possibly missing a [super viewDidLoad] call
    [super viewDidLoad]; // 必须有这一行
}

@end

// 单个方法标记为 direct
- (int)fastFibonacci:(int)n __attribute__((objc_direct));

// 或者标记整个 @implementation 区域
__attribute__((objc_direct_members))
@implementation MyClass {
    int _counter;
}

- (void)increment {
    _counter++;  // 直接访问 ivar，无 objc_msgSend 开销
}

- (int)value {
    return _counter;
}

@end

// 反例：这些对 direct 方法都无效
[obj performSelector:@selector(increment)];           // ❌ 运行时找不到
[self methodForSelector:@selector(increment)];        // ❌ 返回 NULL
[MyClass aspect_hookSelector:@selector(increment)];   // ❌ 无法 Hook

// 告诉编译器这个方法属于哪个方法族（影响 ARC 行为）
- (instancetype)initWithDictionary:(NSDictionary *)dict
    __attribute__((objc_method_family(init)));

// 可用方法族：
// init, alloc, new, copy, mutableCopy

// 例如：让一个非 init 开头的方法被 ARC 识别为 init 族
- (MyObject *)createObject __attribute__((objc_method_family(init)));
// ARC 会对其返回值执行 retain/release 逻辑，类似 init 的行为

// 让自定义 struct 支持 @(...) 语法
typedef struct __attribute__((objc_boxable)) {
    CGFloat width;
    CGFloat height;
} MySize;

MySize size = {100, 200};
NSValue *value = @(size);  // ✅ 合法

// CGFloat、CGPoint、CGRect 等系统类型都标记了 objc_boxable

__attribute__((objc_root_class))
@interface MyRootClass
@end

// 极少使用，通常只有 NSObject / NSProxy 用这个

// 编译期叫 MyClass，运行时叫 _Internal_MyClass
__attribute__((objc_runtime_name("_Internal_MyClass")))
@interface MyClass : NSObject
@end

// Swift 编译器大量使用这个——给 @objc 类生成唯一运行时名称
// 普通开发者基本用不到

// 告诉 ARC：这个对象由外部持有，不要在这个作用域内 release
UIView *view = _cachedView;
__attribute__((objc_externally_retained))
UIView *externalView = view;
// ARC 不会在此后插入 release

// 自定义 Swift 中函数名
- (void)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
    __attribute__((swift_name("application(_:didFinishLaunchingWithOptions:)")));

// 方法重命名（参数标签也重命名）
- (void)handleURL:(NSURL *)url options:(NSDictionary *)options
    __attribute__((swift_name("handle(url:options:)")));

// 类重命名
__attribute__((swift_name("MyNewClassName")))
@interface OldObjCClassName : NSObject
@end

// 全局变量 / 枚举重命名
extern NSString * const kOldConstant
    __attribute__((swift_name("newConstantName")));

// getter/setter 自定义
@property (nonatomic, readonly, getter=isEnabled) BOOL enabled
    __attribute__((swift_name("isFeatureEnabled")));

// NS_REFINED_FOR_SWIFT 的底层
__attribute__((swift_private))
- (void)internalSetup;

// Swift 中不可见，只有 ObjC 能调用
// 配合 NS_REFINED_FOR_SWIFT 做更精细的 API 控制

// 给生成的 Swift 接口添加属性
__attribute__((swift_attr("@available(*, deprecated, message: \"Use newAPI instead\")")))
- (void)oldAPI;

// CF 风格的手动内存管理标注（底层实现）
- (id)newObject __attribute__((ns_returns_retained));
// NS_RETURNS_RETAINED 的底层

- (id)borrowedObject __attribute__((ns_returns_not_retained));
// 告诉 ARC 返回的是非持有引用

// 对应宏：NS_RETURNS_RETAINED、NS_RETURNS_NOT_RETAINED
// 以及 CF_RETURNS_RETAINED、CF_RETURNS_NOT_RETAINED（CF 版本）

// 告诉 ARC：参数被调用方消耗，调用方不需要 release
- (void)takeOwnership:(id)obj __attribute__((ns_consumed));

// self 被消耗（类似 init 的 self = [super init] 中的赋值）
- (instancetype)init __attribute__((ns_consumes_self));

// 防止 ARC 在你需要之前提前释放
- (void)usePointerToWeakObject {
    __weak id weakObj = self.obj;
    __attribute__((objc_precise_lifetime)) id strongObj = self.obj;
    // strongObj 保证在整个作用域存活，不会被提前优化释放

    // 如果不用这个属性，ARC 可能在使用 strongObj 之前就释放了
    // 但 strongObj 的 retain 已经在这里了... 实际场景是配合 cleanup 使用
}

// 更实际的场景：配合 cleanup 使用
__attribute__((objc_precise_lifetime))
__strong NSObject *precise __attribute__((cleanup(myCleanup))) = [NSObject new];
// 保证 cleanup 回调中 precise 仍然有效

{
    __strong NSObject *obj = [NSObject new];
} // 这里自动 release

// Swift 5 开始默认禁止忽略返回值，ObjC 需要手动标记
- (instancetype)init __attribute__((warn_unused_result));
- (BOOL)trySomething __attribute__((warn_unused_result));

// Swift 中：
//    func trySomething() -> Bool   这种写法本身就要求使用返回值
// 但加了这个属性的 ObjC 方法导入 Swift 后会变成：
//    @discardableResult func trySomething() -> Bool  的反面
//    即强制使用返回值

// 老 API 标记不可用，给出迁移提示
- (void)oldMethod __attribute__((unavailable("请使用 newMethod 替代")));

// NS_UNAVAILABLE 的底层
+ (instancetype)new __attribute__((unavailable));

// 条件不可用（新版 availability 宏的底层）
- (void)iOSOnlyMethod
    __attribute__((availability(ios, introduced=14.0, deprecated=15.0)));

- (void)legacyAPI
    __attribute__((deprecated("在 v3.0 废弃，使用 modernAPI 替代")));

// 调试时用，保留栈帧
__attribute__((disable_tail_calls))
- (void)recursiveMethod {
    // ...
    [self recursiveMethod];  // 不会被优化成跳转，保证栈回溯完整
}

// ⚠️ 注意区分 __attribute__((weak_import)) 和 __weak
// 完全不同的东西！

// weak_import：符号可以不存在（运行时检查）
extern int SomeFunction(void) __attribute__((weak_import));

if (SomeFunction != NULL) {
    SomeFunction();  // 如果符号不存在就不调用
}

// 经典场景：使用新版本 iOS API，同时兼容旧版本
if (@available(iOS 15.0, *)) {
    // 符号保证存在
} else {
    // 编译时不报错，但运行时这个符号就是 NULL
}

// 告诉编译器这个枚举可能有未来的值（switch 会警告）
typedef NS_ENUM(NSInteger, ConnectionState) {
    ConnectionStateDisconnected,
    ConnectionStateConnecting,
    ConnectionStateConnected,
} __attribute__((enum_extensibility(open)));

// 效果：switch 覆盖了所有 case 仍会警告建议加 default
// Swift 中对应 @frozen vs non-frozen enum

// NSObject.h 的实际片段
__attribute__((objc_root_class))
@interface NSObject <NSObject> {
    Class isa  OBJC_ISA_AVAILABILITY;
}

// NSProxy.h
__attribute__((objc_root_class))
@interface NSProxy <NSObject> {
    Class isa;
}

// AFHTTPSessionManager.h
__attribute__((objc_subclassing_restricted))
@interface AFHTTPSessionManager : NSObject

// AFURLSessionManager.m
__attribute__((objc_direct_members))
@implementation AFURLSessionManager
// 内部所有方法都是 direct dispatch，性能优化
@end

__attribute__((objc_subclassing_restricted))
@interface SDWebImageManager : NSObject

// 内部大量使用 objc_direct 减少运行时开销

// 很多 SDK 用 constructor 注册自己
__attribute__((constructor))
static void initializeAnalyticsSDK(void) {
    dispatch_async(dispatch_get_main_queue(), ^{
        [AnalyticsSDK startWithConfig:defaultConfig];
    });
}

// cleanup 是 ObjC/C++ 异常安全的
// 即使抛出异常，作用域内的 cleanup 变量也会被调用

- (void)riskyOperation {
    __strong NSObject *obj __attribute__((cleanup(cleanupFunc))) = [NSObject new];

    @try {
        // ...
        @throw [NSException exceptionWithName:@"Error" reason:nil userInfo:nil];
    } @catch (NSException *e) {
        // cleanupFunc 已经被调用了！
    }
}

// ❌ 错误：用于公开 API
- (void)publicMethod __attribute__((objc_direct));
// Category 无法覆盖，KVO 不可用

// ✅ 正确：内部私有方法
- (void)_internalCalculation __attribute__((objc_direct));

// Swift 中直接 final class —— 无需 attribute
final class MyManager { }

// ObjC 中如果需要 Swift 也能约束：
__attribute__((objc_subclassing_restricted))
@interface MyManager : NSObject
@end