如何在 VS Code 安裝並使用 Amazon Q Developer:擴充、AWS Builder ID 登入與第一條內嵌建議
安裝 Amazon Q、Builder ID 登入,Tab 接受第一條灰色內嵌補全。
要在 VS Code 里用 Amazon Q Developer 拿到第一条內嵌建议,先完成三步:Marketplace 安裝 Amazon Q 扩展、用 AWS Builder ID 免费登入、在代码文件里等灰色補全并用 Tab 接受。
对照 docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE-setup.html 与 inline-suggestions.html。檢索詞 Amazon Q Developer VS Code 安裝、AWS Builder ID 登入。个人开发者可不建 AWS 账户,用 Builder ID 即可。这是 AWS 的 IDE 助手,不是本站会议工具。短会见 sitdraw,步骤见 如何建立與加入房間。
內嵌建议 vs 侧边栏 Chat
Inline suggestions
输入代码或註解时出现灰色续写,Tab 接受、Esc 拒绝。安裝扩展后默认开启,见官方 inline-suggestions 文档。
Amazon Q Chat
活动栏 Amazon Q 图标可对话、解释与重构。第一小时先驗收 ghost text,再开 Chat,避免同时调试登入与 Agent 功能。
| 目标 | 入口 | 第一次怎么驗收 |
|---|---|---|
| 安裝 | Extensions → Amazon Q | 活动栏出现 Amazon Q 图标;必要时 Reload Window |
| 登入 | Amazon Q 面板 → Use for free with AWS Builder ID | 浏览器授权码匹配 → 返回 VS Code 已连接 |
| 內嵌補全 | 在 .py / .ts 等文件输入 | 出现灰色建议 → Tab 接受一行或一段 |
| 暂停補全 | IDE 导航栏 Amazon Q → 任务栏 | Pause / Resume Auto-Suggestions |
安裝、Builder ID、第一条內嵌建议
- 01安裝 VS Code 扩展
扩展视图
Cmd+Shift+X/Ctrl+Shift+X搜索 Amazon Q,发布者 Amazon Web Services,扩展 IDAmazonWebServices.amazon-q-vscode→ Install → Reload。Quick Open:ext install AmazonWebServices.amazon-q-vscode。 - 02用 AWS Builder ID 登入
点活动栏 Amazon Q 图标 → 选 Use for free with AWS Builder ID(或同等「免费使用 Builder ID」按钮)。浏览器打开 AWS 授权页,核对 VS Code 显示的验证码 → Confirm and continue。没有 Builder ID 可在流程中用邮箱注册;无需 AWS 控制台账户。企业 Pro 用户改选 Company account 与 IAM Identity Center Start URL(见官方 VS Code 认证章节)。
- 03驗收第一条 inline suggestion
打开自有仓库中的代码文件,输入函式头或註解,例如
// parse ISO date string to UTC或function clamp(n, min, max) {。稍等灰色 ghost text,按 Tab 接受。若无建议,确认未 Pause Auto-Suggestions,且未与 GitHub Copilot 等扩展争抢內嵌(第一小时建议只留 Amazon Q 補全)。
# First hour · Amazon Q Developer · VS Code · 2026-10-13
# ext install AmazonWebServices.amazon-q-vscode
# Amazon Q panel → Use for free with AWS Builder ID
# Browser: match auth code → Confirm
# Type in source file → Tab on ghost text
# Docs: docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE-setup.html
# Inline: .../inline-suggestions.html- 必须创建 AWS 账户吗?
- 个人免费层用 AWS Builder ID 即可,不必开通 AWS 控制台账户。企业 Pro 走 IAM Identity Center。
- 没有灰色補全?
- 确认 Builder ID 已连接、Auto-Suggestions 未暂停、文件类型受支持。查看 Output 面板 Amazon Q 相关日志;Reload Window。
- 和 Codeium、Copilot 怎么选?
- Amazon Q 绑定 AWS 登入与 AWS 文档生态;对照 Codeium/Windsurf Plugin 与 Tabnine。
- 装完能当架构白板吗?
- 不能。要对齐服务边界图时开 sitdraw。
先 Builder ID,再 Tab
登入与內嵌都就绪后,用小函式或单行註解驗收 ghost text,再探索 Chat 或 /dev 类 Agent 功能。