1小时搞定：用await快速开发天气查询CLI工具
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
开发一个Node.js命令行天气查询工具，功能包括：1) 接收城市名参数；2) 调用天气API(如OpenWeatherMap)；3) 显示当前天气和预报；4) 支持保存查询历史。要求：使用commander.js处理命令行参数，用chalk美化输出，用inquirer.js实现交互式查询，所有异步操作使用await，要有完整的错误处理和用户引导。提供示例API调用和模拟数据用于快速测试。 - 点击'项目生成'按钮，等待项目生成完整后预览效果
最近想练习Node.js的异步编程，于是决定用await语法快速开发一个命令行天气查询工具。整个过程从构思到可运行产品只用了1小时，分享这个快速原型的实现思路和踩坑经验。
1. 项目构思与工具选型
目标是做一个能查询实时天气和预报的CLI工具，需要满足：
- 输入城市名即可查询
- 显示温度、天气状况等基础信息
- 界面友好且有颜色区分
- 能记录查询历史方便回溯
选择以下工具链：
commander.js：处理命令行参数chalk：给终端输出加颜色inquirer.js：实现交互式问答axios：调用天气API- 全程使用
async/await处理异步
2. 核心功能实现步骤
初始化项目创建项目目录后，用npm初始化并安装上述依赖。注意
axios和inquirer都需要显式安装。命令行参数解析用
commander定义city参数作为查询入口，比如weather-cli query --city Beijing。这里通过.option()方法配置参数规则。API请求封装使用OpenWeatherMap的免费API，用
axios发起GET请求。关键点：- 在环境变量配置API_KEY
- 用
try/catch包裹请求过程 对HTTP错误状态码做统一处理
数据展示优化用
chalk给不同天气状况配颜色：- 高温显示红色
- 低温显示蓝色
- 降雨提示黄色背景
使用
console.table美化预报列表历史记录功能每次查询后将结果写入本地
.weather_history文件，下次启动时显示最近5条记录。用Node.js的fs/promises实现文件操作。交互模式增强通过
inquirer提供两种交互：- 主菜单选择查询或查看历史
- 查询失败时提示重新输入城市名
3. 开发中的关键技巧
- 错误处理：对网络超时、无效城市名、API限额等场景都有友好提示
- 快速测试：开发时用
mock数据跳过真实API调用（如模拟axios.get返回值） - 用户体验：查询时显示加载动画，用
ora库实现 - 配置管理：通过
dotenv管理API密钥，避免硬编码
4. 完整开发流程示例
- 创建
index.js作为入口文件 - 编写
weatherService.js处理API逻辑 - 实现
cli.js整合所有交互功能 - 在
package.json中添加bin字段使其可全局安装 - 测试时用
npm link本地调试
整个过程代码不到200行，但覆盖了CLI工具的核心需求。用await让异步逻辑清晰易读，比如：
async function getWeather(city) { try { const response = await axios.get(API_URL, { params: { q: city } }); return response.data; } catch (error) { throw new Error('获取天气数据失败'); } }5. 快速原型经验总结
- 迭代要快：先用最简单实现跑通流程，再逐步增强
- 模块化：拆分功能到不同文件，方便后续扩展
- 用户体验：CLI工具要特别关注错误引导和状态反馈
这个项目在InsCode(快马)平台可以一键运行测试，他们的在线编辑器内置Node.js环境，省去了本地配置的麻烦。我实际测试发现：
- 直接粘贴代码就能运行
- 终端交互效果和本地完全一致
- 无需操心API密钥泄露（有环境变量管理）
对于想快速验证想法的小工具，这种免配置的开发体验确实高效。如果继续迭代，下一步可能加入：多语言支持、空气质量指标、天气预警通知等功能。
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
开发一个Node.js命令行天气查询工具，功能包括：1) 接收城市名参数；2) 调用天气API(如OpenWeatherMap)；3) 显示当前天气和预报；4) 支持保存查询历史。要求：使用commander.js处理命令行参数，用chalk美化输出，用inquirer.js实现交互式查询，所有异步操作使用await，要有完整的错误处理和用户引导。提供示例API调用和模拟数据用于快速测试。 - 点击'项目生成'按钮，等待项目生成完整后预览效果
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考