Amazon Q Developer 使用教程：从入门到上手

Amazon Q Developer 是什么

Amazon Q Developer 是 AWS 推出的 AI 编程助手，前身叫 CodeWhisperer。它最大的特点是和 AWS 生态深度绑定——如果你日常用 Lambda、S3、ECS 这些 AWS 服务，它能直接在 IDE 里帮你写 AWS SDK 代码、查文档、甚至调试 CloudFormation 模板。和 GitHub Copilot 那种通用补全不同，Q Developer 更擅长 AWS 相关的场景，比如“帮我写一个 S3 上传文件的 Lambda 函数”，它给出的代码基本可以直接用。

目前它支持 VS Code、JetBrains 全家桶（IntelliJ、PyCharm 等），也内置在 AWS 管理控制台里。免费版就能用大部分功能，付费版主要是加了一些企业级能力（比如安全扫描、代码审查）。

核心功能怎么用

1. IDE 代码补全

装好插件后，写代码时它会自动补全。和 Copilot 类似，你写注释或函数名，它就会推荐代码。区别在于，如果你在写 AWS SDK 调用，比如 boto3.client('s3')，它会更懂 AWS 的 API 结构，补全出来的代码基本不需要改。实测写 Python 的 Lambda 函数时，它甚至能自动加上 context 参数和日志配置。

2. AWS 文档问答

这是 Q Developer 最实用的功能。在 VS Code 里按 Cmd+Shift+P（Windows 用 Ctrl+Shift+P），输入“Amazon Q: Ask Question”，然后直接问“怎么给 S3 桶设置跨区域复制”，它会把 AWS 官方文档的关键步骤提炼出来，附带链接。比自己去翻文档快很多，而且答案通常就是最新的 API 用法。

3. AWS 控制台集成

登录 AWS 管理控制台后，右上角有个 Q 图标，点开可以直接问“我的 EC2 实例为什么启动失败”，它会分析你的账户状态和资源，给出排查建议。这个功能对运维场景很实用，但注意它需要联网，国内访问可能受限。

第一次上手步骤

1. 装插件
   在 VS Code 扩展市场搜索“Amazon Q”安装，或去 JetBrains 插件市场下载。安装后会在侧边栏出现 Q 图标。

2. 登录 AWS 账号
   插件启动后会让你登录 AWS。如果你没有 AWS 账号，注册需要海外手机号，国内用户可能遇到困难。这一步是必须的，因为 Q Developer 的代码补全和问答都依赖 AWS 后端。

3. 设置 IAM 权限
   登录后，需要在 AWS IAM 里给当前用户附加 AmazonQDeveloperAccess 策略。如果只是个人用，直接给管理员权限也行，但企业环境建议按最小权限原则。

4. 开始使用
   在 IDE 里新建一个 Python 文件，输入 import boto3，然后写 s3 = boto3.client('s3')，接着打 s3. 就会看到补全建议。如果想测试问答，按 Cmd+Shift+P 调出命令面板，选“Amazon Q: Ask Question”，输入“如何列出 S3 桶里的所有对象”。

适合什么场景

• AWS 项目开发：如果你在写 Lambda、API Gateway、DynamoDB 相关的代码，Q Developer 的补全和问答能省很多查文档的时间。
• 运维排错：控制台里的 Q 功能可以直接问“为什么我的 CloudFront 分发失败”，它会读取你的配置并给出原因。
• 学习 AWS：新手问“DynamoDB 的读写容量单位怎么算”，它给的答案比官方文档更简洁。

不适合的场景：非 AWS 项目（比如写前端 Vue 或后端 Spring Boot 时，它和 Copilot 没区别，甚至不如 Copilot）；国内用户（因为需要联网访问 AWS 服务，可能会遇到延迟或连接问题）。

价格说明

免费版已经包含：代码补全（每月 1000 次）、文档问答（无限次）、控制台集成。付费版叫 Amazon Q Developer Pro，起价 $19/月（约 130 人民币），加上了安全扫描（检查代码里的 AWS 密钥泄露）、代码审查（类似 CodeGuru）、以及更高的补全配额。企业版更贵，但个人开发者用免费版基本够了。

注意：付费需要绑定海外信用卡，国内用户如果没条件，可以考虑国产替代，比如通义灵码（阿里云）或 CodeGeeX（智谱），它们对 AWS 场景的支持虽然弱一些，但国内网络环境更友好。