#快速上手

本章用官方 Quickstart 的两条路径：在 VS Code 里 接受第一条行内建议，再 打开 Chat 问一句。完整步骤见 Quickstart for GitHub Copilot。

请先完成 安装与登录。下面示例用 JavaScript；Python、TypeScript、Go 等同样适用。官方写明 Copilot 对 Python、JavaScript、TypeScript、Ruby、Go、C#、C++ 等尤其顺手。

#打开练习文件夹

Windows（PowerShell 7）：

mkdir $HOME\copilot-quickstart
cd $HOME\copilot-quickstart
code .

macOS：

mkdir -p ~/copilot-quickstart
cd ~/copilot-quickstart
code .

在 VS Code 里确认左下角 / 状态栏 Copilot 已登录。

#第一次补全（幽灵文本）

1. 新建 dates.js。
2. 输入函数头（先不要自己写函数体）：

function calculateDaysBetweenDates(begin, end) {

3. 停一下。Copilot 通常会用灰色幽灵文本补上函数体，具体内容每次可能不同。
4. 接受： Tab。
5. 拒绝： Esc，或继续打字覆盖。

若灰色文字一直不出现：状态栏确认 Copilot 未暂停；Windows 试 Alt+\，macOS 试 Option+\ 手动触发（见 行内补全）。

自己读一遍建议：日期计算很容易差一天或时区搞错。接受不等于正确。

#用注释引导下一句

另起一行，用自然语言注释描述目标，再写一个空函数头：

// Return true if the year is a leap year in the Gregorian calendar.
function isLeapYear(year) {

等幽灵文本出现后，Tab 接受或 Esc 丢掉。这就是官方说的 comment-driven code generation：注释越具体（边界、返回类型、不要做什么），建议越接近你要的实现。

#第一次 Chat

官方 VS Code Quickstart：打开 Chat 视图。

也可以点标题栏的 Chat / Copilot 图标。若组织关掉了 Chat，输入框会不可用——那是政策，不是快捷键坏了。

在输入框试一句（先选中 calculateDaysBetweenDates 或打开 dates.js）：

Explain this function in three bullets. Quote any timezone assumptions.
Do not rewrite the file unless I ask.

看回复是否引用了你文件里的符号。若答非所问，补上下文：选中代码，或使用 #file / @workspace（见 Chat）。

#让 Chat 改一处小逻辑（仍要人审）

接着发：

Add a JSDoc comment to calculateDaysBetweenDates.
Keep the implementation. If begin > end, document the return value.

Chat 可能给出补丁或插入代码块。Keep / Accept 之前对照：

• 有没有改你没要求的文件
• 空值、字符串日期、时区是否仍含糊

不满意就拒绝，改用更短的提示，或改回行内补全自己敲。

官方 Quickstart 里还有一个「用 Agent 生成完整任务管理网页」的演示。那是 Agent 模式，会写多个文件。第一次练习请先走 Ask / 普通 Chat，确认你能看懂 diff，再在 Coding Agent 里放大范围。

#第一个任务清单

1. 安装扩展并用 GitHub 登录
2. 新建 dates.js，用 calculateDaysBetweenDates 拿到幽灵文本
3. Tab 与 Esc 各做一次，体会接受 / 拒绝
4. 用注释驱动 isLeapYear
5. Ctrl+Alt+I / Control+Command+I 打开 Chat，解释当前文件
6. （可选）打开 github.com 上任意你有权限的仓库里的一个文件，点 Copilot 图标，问 Explain this file.——网站 Quickstart 的路径

#Windows 与 macOS 差异（本章）

键位可在 Keyboard Shortcuts 里按命令名搜索（例如 editor.action.inlineSuggest.commit），以你本机绑定为准。

#下一步

• 行内补全
• Copilot Chat
• 实战案例