前言

作为 AWS 推出的专业 AI 编程助手，Amazon Q Developer 能无缝集成到主流 IDE、命令行和 AWS 控制台中，实现代码生成、重构、调试、安全扫描等一站式开发辅助，不管是个人开发还是企业团队协作，都能大幅提升编程效率。本文结合 AWS 官方文档和实际使用场景，从安装配置到实战操作，手把手教你玩转 Amazon Q Developer，零基础也能快速上手！

一、Amazon Q Developer 支持环境

Amazon Q Developer 几乎覆盖了开发者日常所有开发环境，无需更换工具链，直接在熟悉的环境中就能使用 AI 能力：

1. 主流 IDE

• JetBrains 系列：IntelliJ IDEA、PyCharm、WebStorm 等
• VS Code（Visual Studio Code）
• Visual Studio
• Eclipse

2. 命令行（CLI）

• 类 Unix 系统：macOS、Linux AppImage、Ubuntu
• Windows（原生支持，也可通过 WSL 使用）

3. AWS 控制台

直接在 AWS 云控制台中使用，可辅助云资源配置、网络排查、EC2 实例选型等云开发操作。

二、基础安装与认证（核心四步走）

按照官方标准流程，从安装到使用仅需 4 步，全程耗时不超过 5 分钟，以下是通用操作步骤，不同环境仅安装环节有细微差异。

步骤 1：安装对应环境的插件 / 客户端

• IDE 环境：在各自 IDE 的插件市场中搜索「Amazon Q Developer」，直接安装即可（如 VS Code 在扩展商店、IDEA 在 Plugins 市场）；
• CLI 环境：根据操作系统选择安装方式（下文有 CLI 专属安装教程）；
• AWS 控制台：无需安装，直接注册 / 登录 AWS 账号即可使用。

步骤 2：身份认证

安装完成后，首次使用需要完成认证，二选一即可：

1. 使用Builder ID：适合个人开发者，快速注册即可登录；
2. 使用IAM Identity Center：适合企业团队，基于 AWS 企业身份管理体系登录，更适配团队协作。

步骤 3：开始使用 AI 编程能力

• IDE 中：VS Code 的 Amazon Q 入口在「活动栏」，JetBrains 系列在「工具窗口」，Eclipse/Visual Studio 在对应插件面板；
• CLI 中：在终端直接调用命令即可唤醒 AI 助手；
• AWS 控制台：在控制台首页右侧边栏点击 Amazon Q 图标即可使用。

步骤 4：升级 Pro 版解锁高级功能

基础版可满足日常代码生成、简单问答需求，如需定制化代码推荐、高级安全扫描、企业级私有库集成等功能，可升级到 Amazon Q Developer Pro tier，解锁全量能力。

三、分环境实战使用教程

（一）IDE 环境：核心使用场景 + 操作技巧

IDE 是 Amazon Q Developer 的核心使用场景，提供Chat Window、Inline Code、Inline Chat三大核心功能，覆盖代码编写、理解、重构全流程，以下以 VS Code 和 IntelliJ IDEA 为例，讲解通用操作。

1. 面板快速调起

• VS Code：快捷键Shift+Ctrl+P（Windows）/Shift+Command+P（Mac），输入「Toggle Amazon Q」，回车即可显示 / 隐藏面板；
• IntelliJ IDEA：点击顶部菜单「View -> Tool Windows -> Amazon Q Chat」，调出操作面板。

2. 核心功能 1：Chat Window（交互式聊天窗口）

最基础也最常用的功能，通过自然语言提问，让 AI 返回代码、解答问题、分析逻辑，支持所有开发需求。

• 使用方法：在聊天框直接输入需求 / 问题，回车即可得到回复；
• 实用案例：
  • 代码生成：输入写一个Python的快速排序代码并添加注释，AI 会直接生成可运行代码 + 详细说明；
  • 代码理解：输入帮我分析这段代码的执行逻辑和性能瓶颈（可粘贴代码），AI 会逐行解析；
  • 问题解答：输入Python中如何高效实现字典去重？，AI 会给出多种方案并对比优劣；
• 便捷操作：生成代码后，点击Insert at cursor可直接插入到光标位置，点击Copy可复制代码到剪贴板。

3. 核心功能 2：Inline Code（实时代码补全）

区别于 IDE 原生的简单补全，Amazon Q 的 AI 补全具备上下文感知能力，能根据当前代码逻辑，智能预测并补全后续代码，甚至通过注释直接生成代码片段。

• 使用方法：编写代码时，AI 会自动弹出补全建议，按Tab键即可快速插入；
• 神技巧：注释即代码：输入注释描述需求，AI 会直接生成对应代码，例如输入# 用Python实现冒泡排序并返回排序后的列表，回车后 AI 会弹出完整代码片段，选择即可使用；
• 场景适配：前端开发中，若已有「控件隐藏 / 显示」的代码逻辑，后续编写同类代码时，AI 会智能推测意图，自动补全重复逻辑，节省琐碎编码时间。

4. 核心功能 3：Inline Chat（行内聊天，代码快速重构 / 调试）

无需切换到聊天窗口，直接在代码编辑器中唤醒 AI，对选中的代码进行重构、调试、加注释、改逻辑，全程无缝衔接开发流程。

• 调起快捷键：选中代码后，按Ctrl+I（Windows）/Command+I（Mac），弹出输入框；
• 实用案例：
  • 代码重构：选中冒泡排序代码，输入将这段代码改为快速排序，AI 会以 diff 形式展示代码变更（红色为原代码，绿色为新代码），点击Accept即可确认修改；
  • 错误调试：故意写一个语法 / 逻辑错误的代码，选中后输入排查这段代码的错误并修复，AI 会定位错误并给出修复方案；
  • 文档生成：选中核心函数，输入为这段代码生成详细的函数注释和文档，AI 会自动添加符合行业规范的注释。

（二）CLI 环境：终端里的 AI 助手，开发不离开终端

Amazon Q Developer CLI 将 AI 能力直接带入终端，支持自然语言交互、智能命令补全、代码生成、代理执行，适合习惯终端开发的开发者，以下是完整安装和使用教程。

1. 分系统安装 CLI

macOS（推荐 Homebrew 安装）

brew install amazon-q

也可下载 DMG 安装包，直接拖拽到应用程序文件夹。

Ubuntu/Debian

# 添加Amazon的apt仓库
curl -fsSL https://desktop-release.codewhisperer.us-east-1.amazonaws.com/linux/gpg | sudo gpg --dearmor -o /usr/share/keyrings/amazon-q-archive-keyring.gpg
echo "deb (arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/amazon-q-archive-keyring.gpg) https://desktop-release.codewhisperer.us-east-1.amazonaws.com/linux $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/amazon-q.list > /dev/null
# 更新并安装
sudo apt update
sudo apt install amazon-q-cli

其他 Linux 发行版使用官方 AppImage 安装包即可。

Windows

原生支持 Windows 终端，也可通过 WSL 使用，直接下载官方安装包安装即可。

2. CLI 配置与登录

# 专业版登录（需Pro许可证）
q login --license pro --region us-east-1
# 基础版登录
q login --region us-east-1

执行后终端会生成设备码和授权 URL，在浏览器中打开 URL 并输入设备码，完成认证即可，登录后后台保持状态，无需频繁重新登录。

3. CLI 核心使用命令

# 启动聊天会话（推荐，无需确认即可执行工具）
q chat --trust-all-tools
# 启动标准聊天会话（执行工具需手动确认）
q chat
# 查看版本
q version
# 查看帮助
q help
# 登出
q logout

启动会话后，终端会显示!>提示符，直接输入自然语言需求即可，例如：

• !> 如何在git中撤销最近一次提交但保留修改？
• !> 生成一个Shell脚本，实现批量重命名指定文件夹下的txt文件

4. CLI 核心能力

• 智能命令补全：支持 git、npm、docker、aws 等数百种常用 CLI 工具，自动补全参数和选项；
• 上下文感知：理解当前项目结构、编程语言和框架，给出定制化建议；
• 代理式执行：生成并运行代码片段、创建 / 修改文件、自动化 Git 工作流。

（三）AWS 控制台：云开发专属 AI 辅助

在 AWS 控制台中使用 Amazon Q Developer，可精准适配云开发场景，解决云资源配置、网络排查、实例选型等问题，无需手动查阅文档。

1. 基础使用

登录 AWS 控制台（无账号可免费注册），在首页右侧边栏点击Amazon Q 图标，即可通过自然语言提问，获取 AWS 资源使用指导。

2. 专属云开发能力

• 网络故障排查：与 VPC Reachability Analyzer 联动，检查网络连接、分析配置，快速定位 VPC、子网、安全组等网络问题；
• EC2 实例选型：根据你的业务负载（如微服务、大数据、机器学习），AI 会生成个性化 EC2 实例选型建议，兼顾性能和成本；
• AWS 文档问答：直接提问 AWS 服务使用问题（如S3如何配置跨域访问？），AI 会精准解答并给出配置步骤，无需翻阅官方文档。

四、企业级高级功能：Customization（定制化）

升级 Pro 版后，可使用定制化功能，让 Amazon Q Developer 适配企业私有代码库、编码规范、专有算法，生成的代码建议更贴合团队需求，且严格保障代码安全。

1. 核心定制能力

• 私有库集成：从企业私有代码仓库中生成代码推荐，AI 会学习团队编码风格，确保代码符合企业规范；
• 定制化问答：在聊天窗口中直接提问企业内部代码库问题（如讲解下customerService包的核心功能和调用关系），AI 会给出精准解析，加速新员工熟悉代码；
• 团队权限管理：自定义配置开发者对定制功能的访问权限，按需开放。

2. 数据安全保障

• 企业共享的代码库仅在组织内部使用，不会用于训练 AWS 基础模型；
• 推理端点为企业专属，代码推荐不会泄露到其他公司；
• 支持通过 Amazon KMS（密钥管理服务）加密定制数据，任务完成后自动删除数据。

3. 效果监控

• Dashboard 面板：查看活跃用户数、生成代码行数、安全扫描次数等核心指标，评估 AI 使用效率；
• Amazon CloudWatch：查看代码块接受率、代码行接受率等高级指标，优化 AI 使用效果。

五、安全扫描：代码质量与安全双保障

Amazon Q Developer 内置专业安全扫描功能，将安全检测「左移」到代码编写阶段，在提交代码前发现并修复漏洞，避免线上问题，是企业开发的重要能力。

1. 扫描覆盖的漏洞类型

• 常见安全漏洞：SQL 注入、跨站脚本（XSS）、硬编码密码、数据库连接字符串泄露；
• 代码质量问题：语法错误、性能瓶颈、不符合行业最佳实践的代码；
• 基础设施代码问题：Terraform/CDK 配置错误。

2. 核心优势

• 实时扫描：编写代码时实时检测，发现问题立即提醒；
• 一键修复：检测到漏洞后，直接在 IDE 中给出修复方案，点击即可应用，无需手动修改；
• 免费层可用：基础版每月提供 50 次免费安全扫描，满足个人开发者需求；Pro 版每月 500 次，支持企业团队。

3. 支持的语言 / 工具

• 编程语言：Java、JavaScript、Python、TypeScript、Go、Ruby、Rust（部分支持）；
• 基础设施工具：Terraform、AWS CDK（支持自动代码修复）。

六、支持的编程语言

目前 Amazon Q Developer（含定制化功能）对以下语言提供全量支持，其他语言暂不支持代码分析和生成：Java (.java)、JavaScript (.js/.jsx)、Python (.py)、TypeScript (.ts/.tsx)、Markdown (.md/.mdx)、reStructuredText (.rst)、纯文本 (.txt)。

七、额外实用功能

1. GitLab Duo 集成

Amazon Q Developer 与 GitLab Duo 联动，GitLab Ultimate 自托管客户可体验（目前预览版），在 GitLab 中直接使用 Amazon Q 的 AI 能力，适配 DevOps 流程。

2. .NET 应用大规模迁移

如需将.NET 应用大规模迁移到 AWS，可通过AWS Transform（网页端）结合 Amazon Q Developer，实现自动化迁移，降低迁移成本。

3. /dev 智能体

在 IDE 的 Amazon Q 面板中输入/dev并回车，会调出Q – Dev智能体，通过自然语言描述开发任务（如创建一个基于Flask的RESTful API，支持用户增删改查），AI 会利用项目上下文，自动创建并实现所需代码，大幅提升新功能开发效率。

八、总结

Amazon Q Developer 的核心优势在于无缝集成、上下文感知、全流程辅助，无需改变开发者的日常工具链，就能在 IDE、终端、云控制台中获得 AI 编程能力，从代码生成、理解、重构，到安全扫描、云资源配置，覆盖开发全生命周期。

对于个人开发者，基础版就能满足日常开发需求，大幅提升编码效率；对于企业团队，Pro 版的定制化功能和安全扫描能力，能让 AI 适配团队编码规范，保障代码质量和安全，同时提升团队协作效率。

作为 AWS 官方的 AI 编程助手，其与 AWS 云服务的深度联动，更是云开发场景的一大优势，是开发者值得入手的 AI 工具！

附：官方资源

• Amazon Q Developer 官方入门文档：https://aws.amazon.com/cn/q/developer/getting-started/?p=qdev&z=subnav&loc=13
• AWS 账号注册教程：AWS 官网「Create your AWS account」入口
• 安全扫描功能文档：AWS 官方文档「Amazon Q network troubleshooting」