需遵循五类注释规范：一、清晰函数意图注释；二、JSDoc结构化格式；三、嵌入伪代码步骤；四、引用文件上下文类型与变量；五、用空行和分隔符控制生成粒度。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在编写代码时希望 GitHub Copilot 根据自然语言注释自动补全或生成完整函数，则需遵循特定的注释结构与上下文提示方式。以下是实现注释驱动编码的具体方法：
一、使用清晰的函数意图注释
GitHub Copilot 依赖注释中明确表达的输入、输出、功能目标及边界条件来推断函数逻辑。注释越具体，生成的代码越贴近预期。
1、在函数定义前添加多行注释，以英文或中文描述函数目的；
2、在注释中说明参数名称、类型和含义，例如 参数：text（字符串），表示待处理的原始文本；
3、注明返回值类型与语义，例如 返回：去除首尾空格并转为小写的字符串；
4、可选添加示例调用及预期结果，如 示例：normalize(" Hello World ") → "hello world"。
二、采用 JSDoc 或类似结构化注释格式
结构化注释能显著提升 Copilot 对参数、返回值和异常的理解精度，尤其适用于 TypeScript 或支持类型推导的环境。
1、使用 /** */ 包裹注释块，每行以 * 开头；
2、在注释内逐行标注 @param、@returns、@throws 等标签；
3、确保每个 @param 后紧跟参数名与冒号，再写说明，例如 @param input: 待加密的明文字符串，长度不超过 256 字符；
4、在 @returns 行后换行并缩进书写详细描述，避免与标签挤在同一行。
三、在注释中嵌入伪代码或步骤化逻辑
当函数逻辑较复杂时，Copilot 更易响应分步式指令。将算法流程转化为带编号的自然语言步骤，可引导其生成符合顺序要求的代码。
1、在注释开头写明“步骤如下：”或“执行流程：”；
2、每一步用数字+顿号起始，描述一个原子操作，例如 1、校验输入是否为空字符串，若是则直接返回 null；
3、步骤中避免模糊动词，优先使用“提取”“截取”“遍历”“过滤”“映射”等可编程动作；
4、关键判断条件需显式写出，如 3、若 item.status === 'active' 且 item.score > 80，则加入结果数组。
四、利用文件上下文中的已有变量与类型声明
Copilot 会扫描当前文件中已定义的接口、类型别名、常量和函数签名。在注释中引用这些已有元素，可使生成代码自动适配项目规范。
1、在注释中直接写出类型名，例如 输入：user（UserType）对象，来自 ./types.ts；
2、引用已存在的工具函数名，如 调用 formatTimestamp() 转换 createdTime 字段；
3、若项目使用 ESLint 或 Prettier，注释中可提示风格约束，例如 保持箭头函数语法，不使用 var 声明；
4、避免在注释中重新定义已在作用域中存在的标识符，防止 Copilot 生成冲突声明。
五、通过空行与注释分隔控制生成粒度
Copilot 将连续注释块视为单一提示单元。合理插入空行与分隔性注释，可限定其每次响应的范围，避免生成冗余代码。
1、在函数注释末尾添加一行单独的 // --- 或 // END PROMPT；
2、确保光标位于注释下方第一个空行处，再按 Tab 或 Enter 触发建议；
3、若需生成多个函数，每个函数前使用独立注释块，并以 // 函数二：计算用户积分总和 显式命名；
4、删除未使用的 Copilot 建议后，保留原注释结构，便于后续复用或迭代生成。
