本篇目标：一次性掌握代码生成、解释、翻译、优化、测试、文档、Review、安全扫描全部能力，附 /dev /test /doc /review 指令速查，直接成为 AWS AI 开发高手

---

一、前言

这一篇是纯代码能力篇，所有功能都在 VS Code 里直接用，不需要切换页面。

你将学会：

1. 代码生成 / 解释 / 翻译 / 优化
2. 自动生成单元测试、API 文档、Code Review
3. 安全漏洞扫描（IAM 风险、SQL 注入、密钥硬编码）
4. 4 个超级指令：/dev /test /doc /review 速查
5. 新手直接复制就能用的提示词

---

二、核心能力 1：代码生成（最常用）

1. 普通代码生成

直接写注释，Amazon Q 自动生成代码。

示例：

# 生成一个函数，接收列表，返回最大值和最小值

2. AWS 原生代码生成

Q 最擅长的就是 AWS 代码，直接写需求：

# 用 boto3 列出所有 S3 桶
# 捕获异常，打印错误信息

3. 一键生成完整项目结构

在空白文件输入：

生成一个 AWS Lambda + S3 上传处理的完整代码

---

三、核心能力 2：代码解释（看懂任何代码）

操作方法

1. 选中代码
2. 右键 → Amazon Q → Explain code
3. 或直接输入指令：

/explain

Q 会告诉你

• 这段代码干什么
• 每一步逻辑
• 输入/输出是什么
• 潜在风险

小白神器：看不懂的代码，一秒变清晰。

---

四、核心能力 3：代码翻译（跨语言转换）

支持：
Python ↔ Java ↔ JavaScript ↔ TypeScript ↔ Go ↔ C#

使用方法

选中代码，输入：

/translate to Java

或

翻译成Python

常见场景

• 老项目 Python 2 转 Python 3
• Java 示例转 Python
• 前端 JS 逻辑转后端 Python

不用自己查语法，Q 直接翻译。

---

五、核心能力 4：代码优化（让代码更干净、更快）

选中杂乱代码，输入：

/optimize

或右键 → Refactor code

Q 会自动优化：

• 简化逻辑
• 减少冗余
• 提升性能
• 规范命名
• 增加可读性
• 修复明显 bug

示例优化前：

def calc(a,b,c):
    x=a+b
    y=x*c
    return y

优化后：

def calculate_total(price: float, tax: float, quantity: float) -> float:
    subtotal = price + tax
    total = subtotal * quantity
    return total

---

六、核心能力 5：自动生成单元测试（/test）

指令：

/test

自动生成：

• 正常场景
• 边界值
• 异常场景
• 可直接运行的测试代码

示例：

# 生成函数
def add(a, b):
    return a + b

选中 → 输入 /test
自动生成：

def test_add():
    assert add(1, 2) == 3
    assert add(-1, 1) == 0
    assert add(0, 0) == 0

---

七、核心能力 6：自动生成 API 文档（/doc）

指令：

/doc

自动生成：

• 函数说明
• 参数类型
• 返回值
• 示例调用
• 异常说明

示例效果：

def upload_to_s3(file_path, bucket_name):
    """
    上传本地文件到 S3 桶
    :param file_path: 本地文件路径
    :param bucket_name: S3 桶名称
    :return: 上传成功返回 True，失败抛出异常
    """

---

八、核心能力 7：自动 Code Review（/review）

指令：

/review

Q 会帮你做代码审查：

• 逻辑问题
• 命名不规范
• 缺少异常处理
• 性能问题
• 安全风险
• 不符合 AWS 最佳实践

提交代码前必用！

---

九、核心能力 8：安全漏洞扫描（最重要）

Amazon Q 能直接扫描出真实生产环境高危漏洞。

支持扫描 3 大类

1. 密钥硬编码（最危险）

access_key = "AKIAXXXXXXXXXXXX"
secret_key = "XXXXXXXXXXXXXX"

Q 会直接标红并警告。

2. SQL 注入

sql = f"SELECT * FROM users WHERE name='{username}'"

Q 提示：存在注入风险，应使用参数化查询。

3. IAM 权限风险（AWS 专属）

• 权限过大
• 允许 * 权限
• 不安全的桶策略
• 可公开访问的资源

开启安全扫描

右键 → Amazon Q → Scan for security issues

---

十、4 个最强指令速查（背会这 4 个就够）

1. /dev
   全能开发助手

• 生成代码
• 解释代码
• 优化代码
• 回答问题

示例：

/dev 写一个 Lambda 处理 S3 事件

2. /test
   生成单元测试

3. /doc
   生成规范文档

4. /review
   代码审查 + 安全扫描

---

十一、新手直接复制的提示词（万能模板）

1. 生成 AWS 代码

用Python + boto3生成一个上传文件到S3的函数，包含异常处理和注释

2. 解释代码

解释这段代码，用最简单的话

3. 代码优化

优化这段代码，让它更干净、更稳定、符合AWS最佳实践

4. 安全检查

检查这段代码是否有安全漏洞，包括密钥、权限、SQL注入

5. 生成完整 Lambda

生成一个AWS Lambda函数，触发源S3，打印文件名，返回成功

---

十二、常见问题

1. 代码不生成？

   • 已登录 AWS
   • 区域切换为 us-east-1
   • 重启 VS Code

2. 安全扫描不生效？

   • 更新 Amazon Q 插件
   • 确保代码已保存

3. 提示权限不足？
   检查 IAM 策略是否包含：

   qdeveloper:*