Amazon Q Developer（亚马逊Q开发者）使用教程：从入门到精通

从选型到落地的可执行指南，适合个人与团队快速上手。

教程正文

从选型到落地的实战步骤。

一、Amazon Q Developer 是什么？

Amazon Q Developer（原 Amazon CodeWhisperer）是亚马逊推出的 AI 编程助手，直接集成在 VS Code、IntelliJ IDEA、PyCharm 等主流 IDE 中。它能实时提供代码补全、生成函数、解释代码、调试错误、编写单元测试，甚至根据自然语言描述生成完整功能。与 GitHub Copilot 不同，Amazon Q 对 AWS 服务有深度优化，并支持自由选择训练数据来源（有无参考公开代码两种模式），适合企业和个人开发者使用。

二、安装与配置

1. 安装 IDE 插件

以 VS Code 为例：

打开 VS Code，点击左侧扩展图标（或按 Ctrl+Shift+X）。
搜索 Amazon Q，找到由 Amazon Web Services 发布的官方插件，点击 Install。
安装完成后重启 VS Code。

2. 登录 AWS Builder ID

Amazon Q 需要登录 AWS Builder ID（免费）才能使用：

点击 VS Code 底部状态栏的 AWS 图标，选择 Add New Connection。
在弹出的浏览器窗口中注册或登录 AWS Builder ID（支持用邮箱注册，不要求绑定信用卡）。
授权后回到 VS Code，状态栏显示 Connected 即可。

三、核心功能实操

1. 代码补全（Inline Suggestion）

假设你想写一个 Python 函数，从 S3 读取 CSV 文件：

在编辑器中输入函数名 def read_csv_from_s3，然后暂停 1-2 秒。
Amazon Q 会自动生成函数体，按下 Tab 接受建议。

Tip：如果你对建议不满意，可以按 Ctrl+→ 逐词接受，或按 Esc 忽略。建议颜色为灰色，与正常代码区分。

2. 自然语言生成代码（Chat 面板）

打开 Amazon Q 聊天面板（快捷键 Ctrl+Shift+Q），输入：

生成一个 Java 方法，用 JDBC 连接 MySQL 数据库并查询用户表

Amazon Q 会返回完整的代码片段，并附带简要解释。你可以点击右上角的 Insert at Cursor 将代码插入编辑器。

3. 代码解释（Explain）

选中一段看不懂的代码，右键选择 Amazon Q > Explain，或直接按 Ctrl+Shift+E（需自定义快捷键）。Amazon Q 会在聊天面板中用通俗语言解释这段代码的作用、输入输出和潜在问题。

例如，选择一段 Promise.all 的 JavaScript 代码，它会告诉你这是并行执行多个异步操作，并提示错误处理建议。

4. 调试错误（Debug）

当代码报错时，选中错误行，右键选择 Amazon Q > Fix。Amazon Q 会分析错误信息并给出修改建议。比如 Python 的 KeyError，它会建议添加 .get() 方法或检查字典键是否存在。

5. 编写单元测试（Test）

选中一个函数，右键选择 Amazon Q > Generate Tests。它会自动生成 pytest 或 JUnit 测试用例，覆盖正常输入、边界值和异常情况。你只需在测试文件中点击 Insert 即可。

四、高级技巧

切换参考模式：在状态栏 AWS 图标右键 → Code Suggestion Settings，可选择 With References（参考公开代码，建议带许可信息）或 No References（仅基于训练数据，适合企业合规）。
代码扫描：在聊天面板输入 /scan，Amazon Q 会扫描当前项目中的安全漏洞（如硬编码密钥、SQL 注入），并给出修复方案。
快捷键速查：Ctrl+Shift+Q 打开聊天面板；Alt+C 触发补全（可自定义）；Ctrl+Shift+L 选中代码后解释。

五、常见问题

Q1: 免费版有什么限制？

个人开发者使用 AWS Builder ID 登录即可免费使用所有基础功能（每月 1000 次代码建议调用和 50 次安全扫描），超出后需订阅 Amazon Q Developer Pro（$19/月）。企业用户可通过 AWS IAM Identity Center 集成。

Q2: 支持哪些语言？

支持 Python、Java、JavaScript、TypeScript、C#、Go、Rust、SQL 等 15+ 种主流语言，对 AWS SDK（Boto3、AWS SDK for Java 等）有特别优化。

Q3: 是否会泄露我的代码？

Amazon Q 承诺不会将你的代码用于训练或分享。企业版可进一步开启 代码屏蔽 功能，确保敏感代码不被发送到云端。

六、总结

Amazon Q Developer 是一款免费且强大的 AI 编程助手，尤其适合 AWS 生态开发者。通过本教程的安装、基础操作和高级技巧，你已经能日常开发中用它提升 30%~50% 的效率。快去 IDE 中试试吧！