Copilot for Xcode 自定义指令实战2 类文件 5 个变量一次写清 AI 编码规范【免费下载链接】CopilotForXcodeAI coding assistant for Xcode项目地址: https://gitcode.com/GitHub_Trending/cop/CopilotForXcodeGitHub Copilot for Xcode 是嵌入 Xcode 的 AI 编程助手它的自定义指令Custom Instructions功能让你把编码规范写进 Markdown 文件之后每次发起对话 AI 都会自动遵守不用再在每条提示词里重复交代背景。下面从个人使用讲到团队落地把这个功能一次讲透。别再每条对话都交代一遍规矩了 有没有这种经历刚让 AI 生成完一段代码你顺手提醒用 guard 做提前返回下一轮对话它又忘了于是你又开始重复。每次对话都手动携带上下文就像每天上班都要给新员工重念一遍《员工手册》。自定义指令解决的就是这件事规范写一次AI 长期照做。它本质上是放在项目里的 Markdown 文件AI 处理聊天请求时自动读取让命名习惯、错误处理方式、代码风格稳定地符合你的项目要求而不是靠你临场提醒。先说清两个边界避免期望错位指令只作用于聊天与 Agent 类请求编辑器里随打字弹出的行内代码补全不会参考它指令在创建或修改文件时生效纯粹的读取类操作一般不会触发。两种指令文件怎么选全局一份还是按文件拆 官方文档Docs/CustomInstructions.md。Copilot for Xcode 支持两种形态的指令文件按规则覆盖面来挑。全局规则放哪里第一种是.github/copilot-instructions.md放在工作区根目录自动作用于该工作区内的所有聊天请求。配置入口Settings Advanced Chat Settings在 Copilot Instructions 一行点Current Workspace写项目级规则或Global写跨项目共享的规则存在偏好设置里不落盘到仓库。这个文件名还有一层红利VS Code、Visual Studio 等第三方 IDE 和 GitHub 网页端都能识别同一份文件一次编写多端复用。按文件类型精准下发的 .instructions.md第二种是一个或多个*.instructions.md文件适合不同场景不同规矩。文件头部用 YAML frontmatter 声明两件事applyToglob 通配符一种按路径匹配文件的写法决定规则自动套到哪些文件写**表示全部description一句话说明鼠标悬停时会显示在聊天视图里。正文就是自然语言加 Markdown。比如单独约束 Swift 文件的风格--- applyTo: **/*.swift description: iOS 项目 Swift 编码规范 --- - 用 guard 提前返回避免深层嵌套 - 可恢复错误用 do-catch 或 Result 处理不可恢复错误用 fatalError - 闭包捕获 self 时明确 weak / unowned 语义在设置里点 Custom Instructions 的Create就能新建文件点Open Instructions Folder直接打开存放目录手动编辑。不想走自动匹配时也可以在聊天输入框的文件选择器里把某个指令文件手动附到某条提问上。两个容易忽视的细节指令之间的空行会被忽略写成一整段或逐行都可以指令里还能用 Markdown 链接引用项目文件或 URL例如[App](https://link.gitcode.com/i/e80f82b761b76715edef10defb3b776f)让 AI 自动把被引用文件的上下文带进来。5 个模板变量让指令看懂当前编辑器 写死的规则只是及格线真正好用的是让指令感知你现在在写什么。Copilot 内置了 5 个模板变量发送前会自动替换成真实内容变量替换成{{selected_code}}编辑器里当前选中的代码{{active_editor_language}}当前文件的编程语言{{active_editor_file_url}}当前文件完整路径{{active_editor_file_name}}当前文件名{{clipboard}}剪贴板文本结合{{active_editor_language}}还能写条件分支语言是 Swift 时输出一套规则Objective-C 时输出另一套其余语言给通用规范——一个文件就能覆盖多语言项目。基于{{selected_code}}还能做出审查型指令先让 AI 复述选中的代码再按命名清晰度、函数长度、错误处理、可测性逐条检查相当于给代码审查配了一张自动执行的检查清单。变量的替换逻辑在 CustomCommandTemplateProcessor.swift 中实现想抠细节可以直接翻源码。把个人经验沉淀成团队资产 指令文件是纯文本天然适合进版本控制。建议按层级组织避免一个文件越长越杂全局层命名、缩进、错误处理这类基础规范项目层架构模式、网络层约定等项目专属内容模块层某个技术栈的专用规则文件层针对特定文件类型的微调。三条落地经验值得照做单条指令只说一件事长段落拆成短句单个文件控制在 10KB 以内别塞大段示例代码规则冲突时更具体的applyTo优先级更高后加载的指令会覆盖先加载的同名指令——用清晰的命名从源头避免撞车指令文件可以在 提示词文件 里以链接方式复用各文件保持聚焦不重复维护。流程上把指令演进纳入分支和 PR变更写清楚、合并前同事过目、定期清理废弃规则。有条件的团队还可以把校验挂进 CI检查 Markdown 语法、扫描applyTo冲突保证任何人提交后规则都不打架。想量化效果盯四个指标代码直接接受率、手动修改次数、审查耗时、引入缺陷数。拿两版指令做 A/B 对比用真实数据决定去留比凭感觉改规则靠谱得多。指令没生效先查这 3 个地方 绝大多数不生效问题都逃不出以下三处。1. 文件放错位置。全局规则必须是工作区根目录下的.github/copilot-instructions.md分场景规则要放在工作区里扩展名是.instructions.md而不是普通.md。2.applyTo通配符没匹配上。**/*.swift只匹配 Swift 文件**/Tests/*.swift只匹配测试目录。先确认 glob 模式和目标路径一致必要时把模式放宽再逐步收窄排查。3. 编辑器状态没就绪。模板变量依赖当前编辑器先保存当前文件确认 Xcode 处于焦点状态扩展权限已完整授予。变量拿不到上下文时会替换成空字符串看起来就像变量没生效。如果是多条规则互相打架跑一句grep -r applyTo: .列出所有指令文件对照检查是否有重复或冲突的匹配模式。仍查不出来时可以在模板处理逻辑里加一行调试日志打印处理前的文本和识别到的编辑器语言一眼定位替换发生在哪一步。【免费下载链接】CopilotForXcodeAI coding assistant for Xcode项目地址: https://gitcode.com/GitHub_Trending/cop/CopilotForXcode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考