用途:在阅读、编写或审查 Swift 并发代码时,检查并发正确性、现代 API 用法以及 async/await 常见陷阱。目标为 Swift 6.2 或更高版本并启用严格并发检查。
主要能力:扫描已知危险模式;核对 Swift 6.2 并发行为;校验 actor 的重入与隔离;确认优先使用结构化并发而非非结构化并发;检查非结构化任务、取消处理、异步流与 continuation;检查同步与异步桥接代码;审查遗留并发迁移;对照常见故障模式;在启用严格并发时报错,将诊断映射到修复方案;审查测试时检查异步测试模式。
审查规则:若代码跨多个 target 或 package,先比较其并发构建设置再判断行为是否应一致。优先使用结构化并发(任务组)而非非结构化(Task {})。新代码优先 Swift 并发而非 GCD;GCD 在底层代码、框架互操作或性能关键的同步工作中仍可接受,不应标记为错误。API 同时提供 async/await 与闭包版本时优先 async/await。未经询问不引入第三方并发框架。不要用 @unchecked Sendable 修复编译错误,该做法掩盖竞态,应改用 actor、值类型或 sending 参数;仅对确有内部锁且可证明线程安全的类型才合法。
使用方式:部分审查时只加载相关参考文件,涉及 patterns、Swift 6.2 新特性、actor、结构化与非结构化并发、取消、异步流、桥接、互操作、缺陷模式、诊断与测试等。输出按文件组织,每条问题给出文件与行号、违反的规则、简短的前后代码修复;无问题的文件跳过,最后给出按优先级排列的最有影响修改摘要。
限制:仅报告真实问题,不编造或过度挑剔;资料未提供具体安装命令、收费与平台信息。