代码建议（Copilot Suggestions）

Copilot 的核心能力是「上下文理解 + 智能补全」。它会基于当前文件、函数命名、注释、相邻代码风格等给出行内与多行建议，帮助你更快完成实现。

#1. 建议类型

#行内补全

• 根据当前光标位置补全一行或几行代码。
• 适合完成语句、变量名、链式调用、配置对象等。

#多行/整段补全

• 通过注释或函数签名生成完整实现。
• 适合模板化代码（API 调用、CRUD、表单校验等）。

#多候选建议

• Copilot 会提供多个候选版本。
• 在 VS Code 中可以切换下一个/上一个建议（快捷键以本地设置为准）。

#2. 最推荐的写法

#注释驱动（最稳定）

ts复制
// 读取本地缓存的用户配置
// 如果不存在则返回默认值
export function loadUserSettings() {
  // Copilot 会生成完整实现
}

#先写结构，再补细节

ts复制
async function fetchUserProfile(userId: string) {
  // 1. 调用 API
  // 2. 处理错误
  // 3. 返回标准化结构
}

#强化上下文

• 在文件顶部写清楚业务背景与模块职责。
• 用清晰命名的类型与接口，提示 Copilot 你的数据结构。

#3. 快捷键（VS Code 参考）

具体快捷键可在 VS Code 设置或 Keybindings 中修改，以本地为准。

#4. 配置与控制

#针对语言开启/关闭

json复制
{
  "github.copilot.enable": {
    "*": true,
    "markdown": false,
    "plaintext": false
  }
}

#内联建议开关

json复制
{
  "github.copilot.inlineSuggest.enable": true
}

#项目级指令（强烈推荐）

在 .github/copilot-instructions.md 写清楚规范，让 Copilot 输出更稳定：

markdown复制
# Copilot Instructions

## Code Style
- Use TypeScript for all files
- Follow ESLint rules
- Prefer named exports

## Testing
- Use Jest
- Include edge cases

#5. 质量提升技巧

• 明确注释：越具体，输出越稳定。
• 先写类型：模型能更准确对齐数据结构。
• 拆小问题：先让 Copilot 生成一部分，再补下一部分。
• 避免“一键接收”：检查逻辑与边界条件。

#6. 常见问题

#没有建议

• 检查订阅/组织席位是否开通。
• 更新 IDE 与扩展到最新版。
• 重新登录 GitHub。

#建议不准确

• 在函数上方补充注释与示例输入输出。
• 提供更明确的变量命名与类型。

#参考资料

• Copilot Getting Started↗
• Copilot 快速开始↗