使用 Amazon Q Developer CLI 命令行工具助力开发者最佳实践

本教程专为 Windows 系统优化，其核心是在 Windows 上通过 WSL (Windows Subsystem for Linux) 来运行 Amazon Q Developer CLI，从而助力开发者快速完成开发任务。

本文将使用 Amazon Q Developer CLI 助力完成基于 Python 的 Web 应用程序的开发，体现 Amazon Q Developer 命令行工具高效、智能的强大功能。

安装 WSL 有以下两种方式，即从 Windows PowerShell 安装，和在 Windows Store 中下载并安装。

1. 在 Power Shell 中安装 WSL：

1) 以管理员身份运行 Windows PowerShell。

2) 输入以下命令并按 Enter 键，安装默认版本的 Ubuntu 发行版。
wsl --install

3) 安装完毕后，使用以下命令验证已安装的发行版。
wsl –l

可以看到，Ubuntu 默认版本已经安装成功！

2. 下载并安装 WSL

下载安装 WSL，还可以在 Windows Store 中获取并安装。在 Windows 搜索栏中，搜索关键字 “Windows Store”，选择”以管理员身份运行“。

用鼠标点击“打开“，出现 Windows Store 主页面。

在上方搜索栏，搜索 ”wsl”，得到相应 Ubuntu 的发行版（例如：Ubuntu 22.0.5 LTS）。

点击“获取“按钮即可完成下载安装。安装完毕后，该发行版状态即变为”已安装“。

打开 Chrome 浏览器，访问 Amazon Q Developer for command line 官网链接，可以看到适用于 CLI 的 Amazon Q 开发者版页面。

按照该页面对应操作系统 - Windows下选项，点击下载“适用于 CLI 的 Amazon Q (Windows 版)“，随即重定向到英文下载页面。

用鼠标滚动页面，发现 Amazon Q for command line 仅支持 macOS 和 Linux 操作系统。因此，打开 Windows Subsystem for Linux (WSL) 命令行窗口，执行以下步骤。

在 Windows Store 中选择并安装相应 Linux 发行版（如：Ubuntu 22.04.5 LTS）后，使得 Windows Subsystem for Linux (WSL) 得以运行。

在 Windows 搜索栏，再次搜索 ”wsl” 时，选择“以管理员身份运行“，即可启动运行 WSL。

打开 WSL 后，可以看到 Ubuntu 已在运行。在 Shell 中执行以下命令下载和安装 Amazon Q：

$ wget https://desktop-release.q.us-east-1.amazonaws.com/latest/amazon-q.deb.1

执行结果:

在 WSL 命令行下安装完毕后，提示已将文件保存为 ’amazon-q.deb.1’。

在 WSL 终端，执行以下命令，安装包：

$ sudo ap-get install -f

继续执行:

安装 Amazon Q 的安装包

$ sudo dpkg -I amazon-q.deb.1

在 WSL 终端下，运行以下命令：

$ q login

启动 Amazon Q 登录命令行。

选择第一项“Use for Free with Builder ID”（用构建者 ID 免费使用），按 Enter 键。

按照命令行提示，打开 Web 页面链接： https://view.awsapps.com/start/#/device?user_code=WLMH-LQHB，

点击“确认并继续“按钮。

访问设置：

点击“允许访问“按钮，则在 WSL 终端出现”Logged in successfully”(登录成功)字样。

确认请求：

此同时，在 AWS 的 Web 验证页面，也出现“请求已批准“字样。

在 WSL 终端，运行以下命令，启动 Q 聊天命令行。

$ q chat

在 Q Chat 提示符下，输入提示词如下方英文句子，意为“在 D:盘创建一个名为 D:\Q-Tutorial 的项目文件夹，并且创建一个虚拟环境用作 Python 编程“。

“Create a project folder called 'Q-Tutorial' on the path 'D:\Q-Tutorial', and create a virtual environment for Python programming.“

按照 WSL 终端提示，完成切换项目文件夹：

$ cd q-tutorial

然后，进一步进行虚拟环境激活：

$ source venv/bin/activate

接下来，会用 pip 安装必要的 dependency （Flask）

$ pip install flask

Flask 很快安装完毕，显示”Excellent!” 。

基于 Flask 创建

按照先决条件，由于具备了 Flask，使得创建一个 Web 应用程序成为可能。

此时，输入以下提示词，意为“创建基于 Flask 的 Python Web 应用程序，用以实现酒店客户登记和离开的应用程序“。提示词如下：

“Build a primary Flask web application to implement guest login and logout for registration in a hotel.“

接下来，Amazon Q 会自动构建项目架构。

自动创建：

可以看到，自动化将创建以下一系列主要的 Python 项目文件：

-          App.py

-          Requirements.txt

-          README.md

-          Base.html

-          Home.html

-          Register.html

-          Login.html

-          Dashboard.html

-          Hotel-regtration.html

-          Profile.html

运行完毕时，在终端提示How to Use(如何使用)事项列表。

重新定向：

按照提示第一行，运行本地主机地址http://localhost:5000, 重定向 Web 页面。

点击 New Guest Registration 开始注册。

注册成功：

注册信息填写完毕后，点击确认按钮，显示注册成功。

账号登录：

按照注册过的用户名和密码登录，点击 Login（登录）。

用户文件配置：

点击“View Profile”以便用户配置文件。

通过使用轻量级 Web 框架 Flask 构建本应用程序，使用户了解通过 Amazon Q Developer CLI 协同开发的最佳实践。 项目开发往往离不开平素的日积月累，由 Amazon Q Developer CLI 直接助力开发，会使得开发过程更加高效。

当运行该应用程序时，难免会出现错误。调试和优化步骤必不可少，同时，这些步骤也在证明 Amazon Q 功能强大的突出要点。

当遇到错误时，可按照以下思路解决：

1. 选中报错代码，用鼠标右键选择 “Q: Explain this error”, 按 Enter 键后，Q 会检查代码并给出解决方案；
2. 或者，在 Q 聊天框中输入：“Help me review and optimize the code”来修正出现的错误，Q 会调整和修改代码，甚至是调整 Web 页面端口号，来使flask应用程序正确输出到 Web 页面。

通过本教程，初学者可以学到 Amazon Q Developer 的相关知识和技能。首先，能够在短时间内（15-20 分钟），通过启用 WSL，用 Amazon Q Developer CLI 创建 AI 辅助的 Python 应用程序；其次，学会逐步调试和优化代码；此外，能掌握 Amazon Q 的核心功能，对于高效的项目级开发非常实用。这对于非专业开发者或者初学者来说，无疑是件开心且重要的事情。