精确优先于召回:只报告在所提供的评审范围与相关仓库上下文中可确证的缺陷。不要仅凭名称推断循环引用、可空性、线程使用或版本可用性,也不要复述编译器或静态分析器的诊断,除非被评审代码会造成具体的运行时后果。
ARC 与对象所有权
6 项- 一条强所有权边闭合出一个循环,使对象图在其预期生命周期结束后仍然存活;应验证该循环的两个方向,而不是标记每一处强引用内置
来源与改动说明
- 对象类型的
assign或unsafe_unretained引用在所指对象可能已释放后被解引用,形成悬垂指针;除非目标平台和构建模式支持置零弱引用,否则不建议改用weak内置来源与改动说明
- 某个必须存活以完成必要工作的对象仅由一个
weak引用持有,导致该工作可能在执行前悄然消失内置来源与改动说明
- 在已证实使用手动引用计数的文件中:通过
alloc、new、copy、mutableCopy或retain取得所有权的对象未在所有路径上释放、自动释放对象未经 retain/copy 就被存储,或持有的对象被过度释放。不要将 MRC 规则套用于 ARC 管理的文件内置来源与改动说明
- 自定义访问器或实例变量赋值违反了声明的
strong、weak、copy或 MRCretain所有权契约;属性特性无法在手写 setter 内部强制其语义内置来源与改动说明
dealloc在对象消亡后仍留下其持有的非 Objective-C 资源、观察注册、定时器或回调处于活动状态。在 ARC 下,不要要求[super dealloc]或手动释放 Objective-C 对象内置来源与改动说明
块、回调与定时器
8 项- 被对象存储的逃逸块直接或经由另一个被捕获的持有者强引用捕获了该对象本身,闭合出循环引用内置
来源与改动说明
- 把
__block当作在 ARC 下不持有 Objective-C 对象来使用;除非显式声明为 weak,ARC 会持有对象类型的__block捕获内置来源与改动说明
- 在逃逸块外部将弱引用转换为强引用,导致该块仍然捕获并持有本不打算持有的对象内置
来源与改动说明
- 操作有效要求对弱捕获的多次读取指向同一个存活对象,但该块未先将捕获提升为强引用局部变量,并让所有依赖读取都使用该局部变量内置
来源与改动说明
- 在 MRC 下以裸赋值方式存储逃逸块,或使用未遵守
copy契约的自定义 setter,使栈上的块得以超出其作用域存活内置来源与改动说明
NSTimer、CADisplayLink、基于块的观察者、操作或订阅持有其 target/块,而其持有者又持有该注册对象,且在每条生命周期退出路径上都没有失效处理或断开所有权内置来源与改动说明
- 异步完成回调在该操作已被取消、替换或因生命周期销毁而失效后,仍应用过期状态或更新其持有者内置
来源与改动说明
- 当被捕获对象并不持有该块,或其他上下文证明不存在循环时,不要报告强捕获内置
来源与改动说明
属性与封装
7 项- 当周围的所有权关系已证明对方持有自身时,delegate、数据源、子指向父的链接或回调持有者仍被声明为 strong内置
来源与改动说明
- 调用方可以传入可变子类、且后续修改会破坏属性快照契约时,
NSString、NSArray或NSDictionary等不可变值属性使用 retain 而非 copy内置来源与改动说明
- 自定义 setter 在安全 retain/copy 互为别名的新值之前就释放了旧的 MRC 值,或在属性处于部分更新状态时调用回调/KVO内置
来源与改动说明
- 代码将
atomic属性当作复合不变式、可变被指对象或读-改-写序列的保护;原子访问器并不能使所属对象线程安全内置来源与改动说明
- 直接修改实例变量绕过了自定义 setter,而该 setter 的校验、缓存失效、观察或所有权副作用是正确性所必需的内置
来源与改动说明
- 只读 API 直接返回其内部可变集合,使调用方能够修改该类自认为由自己控制的状态内置
来源与改动说明
- 不要仅因
nonatomic本身就报告问题;须有证据表明该属性在没有其他同步手段的情况下被并发访问内置来源与改动说明
初始化与对象构造
7 项- 初始化方法在
[super init...]之后继续使用原始 receiver,而非先赋值并检查父类初始化方法返回的对象内置来源与改动说明
- 指定初始化方法跳过了父类的指定初始化方法,或便利初始化方法绕过了本类的指定初始化方法,导致必需的继承或本地状态未初始化内置
来源与改动说明
- 某条构造路径(包括初始化方法、
initWithCoder:或工厂方法)返回的对象未建立其他构造路径所建立的不变式内置来源与改动说明
- 初始化方法在实例完全初始化之前调用了可被子类重写的方法,而已存在或被允许的子类重写可能观察到部分初始化状态或据此行动内置
来源与改动说明
- 初始化失败时返回部分可用的对象而非
nil,或工厂方法悄然用违反其文档化失败契约的兜底对象替代内置来源与改动说明
- 子类继承了无法建立其必需状态的初始化方法,却未重写该方法或将其标记为不可用内置
来源与改动说明
- 当父类初始化方法已建立所有不变式且子类没有新增构造要求时,不要要求重写
init内置来源与改动说明
Nil、NSNull 与对象语义
7 项- 在某条将该返回值解读为成功或有效的路径上,向
nil发送消息会静默返回nil、零或NO,掩盖了必需对象的缺失内置来源与改动说明
- 将
NSNumber *当作布尔指针来判断,导致@NO被视为真;当分支取决于其封装值时应使用boolValue内置来源与改动说明
- 将来自 JSON、集合或 KVO 的
NSNull当作nil处理或向其发送领域对象选择器,导致错误分支或 unrecognized-selector 异常内置来源与改动说明
- 在需要字符串、数字、日期或集合语义相等性的场合使用
==或!=;不要标记有意为之的同一性比较内置来源与改动说明
NSNotFound在被检查之前就经历了窄化转换、参与算术运算或被传入范围/索引操作内置来源与改动说明
- 可空结果流入要求非空参数并会抛出异常的 Foundation 初始化方法、集合、属性字符串或其他 API内置
来源与改动说明
- 当零值/nil 结果明确就是期望的可选行为时,不要报告有意向 nil 发送消息的情况内置
来源与改动说明
Foundation 集合、字符串与范围
9 项- 可能为 nil 的对象或键被插入数组、集合、字典或集合字面量,导致
NSInvalidArgumentException内置来源与改动说明
- 快速枚举期间可变集合被修改,包括通过别名或循环调用的回调进行的修改内置
来源与改动说明
- 代码将不可变集合强制转换为可变类型并直接修改,而不是获取可变副本内置
来源与改动说明
- 经过过滤、异步修改、查找失败或未经校验的外部输入后,索引或
NSRange可能超出当前集合/字符串边界内置来源与改动说明
- 在字形边界敏感的用户可见文本中,
NSString.length或原始NSRange偏移将代理对或组合字符序列拆开内置来源与改动说明
UTF8String返回的 C 字符串在临时转换缓冲区生命周期结束之后(包括外层自动释放池排空之后)仍被使用;仅持有NSString并不足够,应在指针离开该上下文之前复制字节内置来源与改动说明
bytes或其他借用缓冲区访问器返回的指针,在其所属对象可能已释放或其可变后备存储可能已改变之后,仍被存储或异步使用内置来源与改动说明
- 运行时派生或用户控制的字符串被直接用作
NSLog、stringWithFormat:或其他可变参数格式化器的格式参数,而非作为值参数传给%@等字面量格式内置来源与改动说明
- 非字面量格式字符串与其参数的类型或宽度不兼容,例如对
NSInteger、NSUInteger或size_t使用固定宽度整数说明符,导致未定义的可变参数读取内置来源与改动说明
协议、委托与选择器
8 项- 未先验证
respondsToSelector:就向非nil对象发送@optional协议方法,使未实现的选择器变得可达内置来源与改动说明
- 对弱引用或可被并发替换的 delegate 先读取一次用于
respondsToSelector:、再读取一次用于调用,可能让另一个对象接收到未经检查的选择器;应在检查与调用期间持有同一个强引用局部变量内置来源与改动说明
- 类声称遵循某协议,但必需方法只是桩实现、返回占位值,或违反协议或其调用方可见的必需行为内置
来源与改动说明
- target-action、通知、定时器、回调或
performSelector:的使用传入了参数个数错误或参数/返回 ABI 不兼容的选择器内置来源与改动说明
- 同一选择器的方法声明与实现使用了不兼容的参数或返回类型,导致运行时分发可能错误地传递或解释值内置
来源与改动说明
- 在已验证的最低部署目标之后引入的框架类、选择器、常量或枚举项,在没有可用性守护或受支持的兜底的情况下即可达;报告时应给出确切的平台版本内置
来源与改动说明
- 在调用可选方法前用
conformsToProtocol:代替respondsToSelector:;遵循协议并不保证可选方法已实现内置来源与改动说明
- 对于由仓库中已验证的包装或转发实现所守护的可选协议方法,不要报告内置
来源与改动说明
分类与运行时修改
9 项- 本仓库内定义的类上的分类实现了原类、父类或同类上另一分类也实现的选择器,因此运行哪个实现是未定义的;报告前先用
code_search确认冲突内置来源与改动说明
- 框架类上的分类实现了框架自身已定义的选择器,Apple 文档将其记载为未定义行为;
code_search看不到 SDK,因此应把该重写本身视为可报告的信号,绝不把空搜索结果当作不存在冲突的证明内置来源与改动说明
- 分类声明了属性却既未提供访问器也未提供关联存储,使该属性能通过编译但在被发送消息时失败内置
来源与改动说明
- 关联对象存储使用的键已被用于另一个值,或其关联策略与该值所需的所有权或线程行为冲突内置
来源与改动说明
- 方法交换(swizzling)可能执行多次,重复交换会反复切换或破坏已安装的行为;必须显式保证一次性安装内置
来源与改动说明
- 对继承方法做 swizzling 交换的是父类上的实现,而不是把变更隔离在目标子类内置
来源与改动说明
+load钩子等待直到镜像加载完成才能运行的工作、获取初始化可重入的锁,或依赖分类/类的加载顺序内置来源与改动说明
IMP或objc_msgSend的强制转换与方法调用约定、参数类型和返回类型不完全匹配内置来源与改动说明
- 不要仅因使用了分类或 swizzling 就报告;须指明具体的选择器冲突、全局副作用或 ABI/生命周期故障内置
来源与改动说明
Core Foundation 与 C 互操作
9 项- 按 Create Rule 返回的 Core Foundation 结果(例如由名称含
Create或Copy的函数返回)在某条退出路径上既未释放也未转移所有权内置来源与改动说明
- 按 Get Rule 返回的非持有 Core Foundation 结果被当作持有者释放或转移所有权,或在其生命周期保证者可能消失之后仍被使用内置
来源与改动说明
__bridge_retained/CFBridgingRetain没有对应的 release 来平衡,或__bridge_transfer/CFBridgingRelease之后又对同一所有权再次 release内置来源与改动说明
- 普通
__bridge指针在未转移所有权的情况下逃逸超出 Objective-C 对象的生命周期内置来源与改动说明
- C 回调的函数指针类型签名或调用约定不兼容,导致调用方与回调对参数或返回值的表示方式理解不一致内置
来源与改动说明
- 回调上下文或其他存储的
void *使用了错误的桥接/持有约定,留下悬垂的 Objective-C 对象或泄漏已持有的上下文内置来源与改动说明
- C API 接收栈地址、临时缓冲区或借用的 Foundation 字节,而它们在异步使用期间可能超出后备存储的存活期内置
来源与改动说明
- 跨 C 边界传递的缓冲区长度、元素个数或结构体布局以错误单位计算或经历窄化转换,可能导致越界访问内置
来源与改动说明
- 未先遵循被调用 API 文档化的 Create Rule 或 Get Rule 及其回调上下文契约之前,不要要求更改所有权内置
来源与改动说明
错误处理与异常
8 项- 调用方未先检查方法的主
BOOL、对象或哨兵返回值就读取NSError *,导致过期或未指定的错误控制了行为内置来源与改动说明
- 实现在未检查调用方是否传入
NULL的情况下就通过NSError **写入内置来源与改动说明
- 失败返回被忽略,代码带着 nil、部分或过期的输出继续执行,如同操作成功一般内置
来源与改动说明
- 方法报告成功的同时设置了错误、报告失败却未给出契约要求的错误,或以相互矛盾的结果/错误值调用完成回调内置
来源与改动说明
@catch块吞掉异常并带着可能已损坏的状态继续执行,或把程序员的异常当作普通可恢复错误来捕获内置来源与改动说明
- 可恢复的 I/O、校验或服务故障被转换成异常,而该 API 其余部分使用
NSError或显式结果值内置来源与改动说明
- 包装错误时丢弃了现有调用方用于选择恢复行为的 domain/code 或底层错误内置
来源与改动说明
- 当主失败已被完整处理且没有调用方需要额外区分时,不要报告未使用的可选
NSError细节内置来源与改动说明
并发、队列与主线程 UI 访问
10 项- 可并发到达的队列对可变状态或可变 Foundation 集合进行读写,而没有一种经过验证的统一同步策略内置
来源与改动说明
- 在框架要求主线程访问的场合从后台队列读取或修改 UIKit 或 AppKit 状态内置
来源与改动说明
dispatch_sync的目标是当前串行队列,包括从主线程同步派发到主队列,造成确定性死锁内置来源与改动说明
- 主线程等待一个信号量、操作或条件,而其完成被调度到了主队列上内置
来源与改动说明
@synchronized(lock)可能收到nil,此时临界区完全没有被同步;或锁对象可能被替换,导致调用方用不同的锁保护同一状态内置来源与改动说明
- 持有锁的同时发送外部实现的 Objective-C 消息或回调,而后者可能同步重入并获取同一把非递归锁内置
来源与改动说明
dispatch_group_enter在返回、错误或取消路径上缺少对应的dispatch_group_leave,导致组完成事件永不触发内置来源与改动说明
- Core Data 托管对象或上下文越过其限定队列,而不是使用上下文自身的队列和对象 ID内置
来源与改动说明
- 长时间运行的后台循环在无局部
@autoreleasepool的情况下创建大量自动释放对象,导致内存持续增长直至线程或外层池排空内置来源与改动说明
- 不要凭形似异步的方法名推断并发;应验证队列创建、调用点或框架回调保证内置
来源与改动说明
KVC、KVO 与通知
11 项- 字符串键/键路径未指向符合 KVC 的属性(包括重命名或重构遗留的过期字面量),导致运行时查找抛出异常或静默指向错误成员内置
来源与改动说明
setValue:nil forKey:在没有有效setNilValueForKey:策略的情况下可能作用于非对象属性内置来源与改动说明
- 直接修改实例变量绕过了自动 KVO 通知,而已验证该属性的观察者依赖这一变更通知内置
来源与改动说明
- setter 或 KVC 修改触发自动 KVO 的同时,同一变更又被手动
willChange.../didChange...调用包裹,造成重复观察;或这些手动调用在某条退出路径上不平衡内置来源与改动说明
- 派生的可观察属性随其输入之一变化,但其依赖键未注册,导致现有观察者持有的信息过期内置
来源与改动说明
- 观察者的注册与移除使用了不匹配的对象、键路径、上下文或生命周期,导致回调发给已消亡的观察者或移除了另一条注册内置
来源与改动说明
observeValueForKeyPath:...消费了未知上下文而不是转发给super,破坏了父类安装的观察内置来源与改动说明
- 假定 KVO 变更字典中就是领域对象,尽管旧值/新值为 nil 时实际由
NSNull表示内置来源与改动说明
- 基于块的通知观察者 token 被丢弃,或被其块捕获的持有者所持有,导致无法正确移除或闭合出循环引用内置
来源与改动说明
- 通知回调在未考虑通知投递发生所在发送线程的情况下执行线程限定的工作内置
来源与改动说明
- 当已验证的 API 和部署运行时提供基于 token 范围或自动的清理时,不要强求手动移除观察者内置
来源与改动说明
归档与外部动态输入
6 项- 来自不可信或可替换源的数据用不受限制的
NSKeyedUnarchiverAPI 解码,而不是使用带显式允许类集合的安全编码内置来源与改动说明
- 类声称支持
NSSecureCoding,却用无类型的decodeObjectForKey:解码内嵌对象,而非decodeObjectOfClass:forKey:或decodeObjectOfClasses:forKey:,导致在对象构造之前未约束期望的类内置来源与改动说明
initWithCoder:接受违反普通初始化方法所强制不变式的解码类型、范围、枚举值或对象图内置来源与改动说明
- 从外部输入派生的选择器或类名未经白名单过滤就传给
NSSelectorFromString、NSClassFromString、performSelector:或运行时调用,暴露了非预期的代码路径内置来源与改动说明
- 反序列化失败被替换成部分填充的对象,调用方无法将其与有效的持久化状态区分开内置
来源与改动说明
- 对于完整性与来源均在同一信任边界内得到确证的数据,不要报告不受限制的解码内置
来源与改动说明
Objective-C 测试正确性
4 项- 使用
XCTAssertEqual/XCTAssertNotEqual测试 Objective-C 对象的值相等性,导致测试比较的是同一性,而非使用XCTAssertEqualObjects/XCTAssertNotEqualObjects内置来源与改动说明
- 异步测试可能在完成断言运行之前结束,或在被测行为完成之前就满足了其期望内置
来源与改动说明
- 循环引用或释放测试意外保留了额外的强引用局部变量,使其生命周期断言无法检测到该回归内置
来源与改动说明
- 测试期望某 API 抛出 Objective-C 异常,而该 API 实际通过
NSError、布尔值、nil 或哨兵报告普通失败,因此测试并未覆盖真实的失败契约内置来源与改动说明