？新旧API正确写法解析)
【免费下载链接】SwiftUI-Agent-SkillSwiftUI agent skill for Claude Code, Codex, and other AI tools.项目地址https://gitcode.com/GitHub_Trending/swi/SwiftUI-Agent-Skill点击查看免费下载SwiftUI-Agent-Skill是一个面向 Claude Code、Codex 等 AI 编程助手的 SwiftUI 代码审查技能包SwiftUI Pro它内置了针对 LLM 常见错误的检查规则。其中一条最容易被新手忽视的规则是永远不要使用 1 参数版本的onChange()修饰符。为什么一条看似普通的 API 会被明令禁止本文带你一次看懂新旧 API 的正确写法。SwiftUI-Agent-Skill 是什么给 AI 装上审查规则在 AI 写 SwiftUI 代码时它经常会犯一些人类早就不犯的错误使用被弃用的 API、写出看不见的 VoiceOver 按钮、埋下性能隐患。SwiftUI-Agent-Skill 正是为此而生——它把多年的实战经验沉淀成一组 Markdown 规则文件让 AI 助手在写码和审码时自动遵循最佳实践。整个技能的核心入口是 SKILL.md其中定义了一套 9 步审查流程从弃用 API、视图结构、数据流、导航到无障碍、性能逐步对照 references/ 目录下的规则文件逐项检查。 这个技能包支持 iOS 26 / Swift 6.2 环境并兼容 Claude Code、Codex、Gemini、Cursor 等多种 AI 工具。为什么 1 参数 onChange() 被禁止在 api.md 中规则原文写道Never use theonChange()modifier in its 1-parameter variant; either use the variant that accepts two parameters or accepts none.永远不要使用onChange()修饰符的 1 参数变体要么用接受两个参数的版本要么用不接受参数的版本。这条规则背后有两个原因。旧 API1 参数写法在 iOS 17 起被弃用iOS 17 之前onChange(of:)只有一个回调参数这是绝大多数旧教程和在线示例中的标准写法// ⚠️ 旧写法1 参数版自 iOS 17 起被标记为弃用 .onChange(of: searchText) { newValue in performSearch(newValue) }从 iOS 17 开始Apple 引入了两个新变体并将 1 参数版本标记为弃用deprecated——Xcode 会给出弃用警告且未来系统版本中它可能被彻底移除。而 AI 模型的训练数据里充斥着旧教程因此它会非常自信地写出这种过时写法。SwiftUI-Agent-Skill 把它列为硬性禁令就是为了让 AI 停止复述过时的知识。新 API 两种正确写法零参数版与双参数版iOS 17 提供了两种现代写法按需选择即可// ✅ 新写法一零参数版——只需要在值变化时触发副作用 .onChange(of: searchText) { performSearch() } // ✅ 新写法二双参数版——需要对比新旧值时使用 .onChange(of: volume) { oldValue, newValue in print(音量从 \(oldValue) 变为 \(newValue)) }如何选择很简单不关心旧值就用零参数版需要从什么变成什么的对比就用双参数版。两者都比旧写法更清晰也更不容易误用。行为差异陷阱触发时机完全不同⚠️ 除了弃用问题新旧 API 还有一个新手极易踩中的行为差异旧 1 参数版视图首次出现、值还没变过时就会触发一次回调新零参数 / 双参数版默认不会在首次出现时触发只有值真正改变时才回调可通过initial:参数显式改为首次触发。这意味着如果直接把旧代码的回调逻辑搬到新 API 里可能发现少触发了一次导致初始化逻辑不执行。所以替换 API 时不要只改签名还要确认触发时机是否符合预期。规则出处在 SwiftUI Pro 里能找到这条禁令吗能。这条禁令散见于多个规则文件彼此呼应规则文件内容api.md核心禁令禁用 1 参数onChange()data.md建议用State绑定 onChange()触发副作用替代脆弱的Binding(get:set:)SKILL.md官方示例文本框修改用户名后用零参数onChange(of:)自动保存其中 SKILL.md 给出的示例正是零参数新写法TextField(Username, text: $model.username) .onChange(of: model.username) { model.save() }可以看到SwiftUI Pro 不仅禁止旧写法还示范了数据绑定 onChange 副作用这一更干净的现代数据流模式。如何安装 SwiftUI Pro 并检查 onChange 问题安装只需一条npx命令完整说明见 README.md 的 Installing SwiftUI Pro 章节安装时可以选择目标 AI 工具和仅当前项目 / 全部项目两种范围。安装完成后触发方式非常直接Claude Code输入/swiftui-proCodex输入$swiftui-pro自然语言例如用 SwiftUI Pro 技能检查这个项目的弃用 API它还会支持部分审查。比如只想聚焦弃用 API可以说/swiftui-pro Check for deprecated API此时技能只会加载相关的 api.md 规则文件省 token 也更聚焦。审查结果会按文件组织指出具体行号、违反的规则名并给出简短的前后对比代码。新手常见问题FAQQ旧代码里的 1 参数onChange()会立刻报错吗A不会报错但 Xcode 会显示弃用警告且随着系统版本迭代存在被移除的风险。既然要维护不如一次性换成新写法。Q零参数版和双参数版选哪个A回调里用不到oldValue就用零参数版代码更简洁需要判断变化方向或做 diff 对比时才用双参数版。Q这个禁令只针对 AI还是人写代码也要遵守A规则文件的本质是现代 SwiftUI 最佳实践对人类开发者同样适用——它针对的是 iOS 17 起的事实标准。小结SwiftUI-Agent-Skill 禁止 1 参数onChange()是因为该写法自 iOS 17 起已被官方弃用且新旧 API 的触发时机存在微妙差异。记住两条即可只用零参数版或双参数版替换时留意首次出现是否触发。把这类AI 最容易犯的错误交给 SwiftUI Pro 自动审查你只管写更现代的 SwiftUI 代码。赞分享【免费下载链接】SwiftUI-Agent-SkillSwiftUI agent skill for Claude Code, Codex, and other AI tools.项目地址https://gitcode.com/GitHub_Trending/swi/SwiftUI-Agent-Skill点击查看免费下载相关推荐SwiftUI-Agent-Skill vs 传统提示词为什么Agent Skills格式让AI输出更稳定SwiftUI Agent Skill vs 传统提示词为什么Agent Skills格式让AI输出更稳定 SwiftUI Agent Skill 是一个面Error Prone 的 ExtendsAutoValue 检查为什么禁止手写继承 AutoValue 类Error Prone 的 ExtendsAutoValue 检查为什么禁止手写继承 AutoValue 类 AutoValue 类在设计上就是封闭的静态分析代码质量开发工具oh-my-pi 内置规则剖析为什么 TypeScript 中禁止滥用 isRecord 类型守卫以及正确的边界解析姿势oh my pi 内置规则剖析为什么 TypeScript 中禁止滥用 isRecord 类型守卫以及正确的边界解析姿势 本文以 oh my pi一个与人工智能AI Agent代码智能体工具调用CLIMCP Clients创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
