hoppscotch cli支持五种api测试实操路径：一、基础集合测试执行；二、带环境变量的跨环境测试；三、生成结构化json测试报告；四、控制请求延迟与超时；五、离线执行pre-request scripts和tests脚本。
如果您已熟悉Hoppscotch Web界面，但希望在持续集成、脚本化验证或无图形环境（如服务器、Docker容器）中执行API测试，则需依赖Hoppscotch CLI命令行工具。以下是使用CLI进行API测试的多种实操路径：
一、基础集合测试执行
该方式适用于快速运行导出的Hoppscotch集合JSON文件，无需交互，适合CI流水线中单次验证。
1、确保已全局安装Hoppscotch CLI：npm install -g @hoppscotch/cli
2、确认安装成功：hopp --ver
3、准备一个导出的集合文件，例如user-api.json
4、执行基础测试命令：hopptest user-api.json
5、观察终端输出，包括每个请求的状态码、响应时间及断言结果
二、带环境变量的跨环境测试
通过分离环境配置与集合逻辑，可复用同一套测试脚本在开发、预发、生产等不同环境中运行，避免硬编码URL或密钥。
1、创建环境变量文件env-prod.json，内容示例：
{ "variables": [{ "key": "baseURL", "value": "https://api.prod.example.com" }, { "key": "authToken", "value": "prod_abc123" }] }
2、确保集合中URL使用变量引用，如{{baseURL}}/users
3、执行带环境参数的测试：hopptest user-api.json -e env-prod.json
4、CLI将自动注入变量并替换所有{{key}}占位符
三、生成结构化测试报告
为便于后续解析、归档或集成至质量看板，CLI支持导出机器可读的JSON格式报告，包含汇总统计与逐项明细。
1、执行测试并指定输出路径：hopptest user-api.json --output report-20260506.json
2、等待执行完成，检查当前目录是否生成report-20260506.json文件
3、报告中包含summary字段（total/passed/failed）及details数组，每项含name、status、duration、error（若失败）等键
四、控制请求节奏与超时行为
针对存在速率限制或强依赖顺序的API链路，可通过延迟与超时参数模拟真实调用节拍，避免被限流或因响应过长导致误判。
1、在测试中加入1秒间隔以降低并发压力：hopptest user-api.json --delay 1000
2、为所有请求设置最大响应等待时间为8秒：hopptest user-api.json --timeout 8000
3、组合使用两项参数：hopptest user-api.json --delay 500 --timeout 5000
五、离线模式下执行预请求与后请求脚本
CLI完整支持Hoppscotch Web端定义的Pre-request Scripts和Tests脚本，包括动态变量设置、JSON断言、schema校验等逻辑，全部在Node.js运行时中执行。
1、确认集合JSON中requests数组内各请求含有scripts字段，例如：
"scripts": { "preRequest": "env.set('timestamp', Date.now().toString());", "test": "pw.expect(pw.response.status).to.equal(200);" }
2、执行命令时无需额外标记，CLI默认启用脚本引擎：hopptest advanced-collection.json
3、若某项测试失败，CLI将在对应请求条目下输出error字段，含断言错误堆栈信息
