2. k6 环境搭建与基础运行

本章将指导你在主流操作系统上完成 k6 的安装、环境验证，并运行第一个 HTTP 请求脚本。掌握这些基础操作是后续进行事件触发、容量压测与巡检编排的前提。

2.1 安装 k6（Windows / macOS / Linux）

k6 提供多种安装方式，推荐使用官方包管理器或直接下载二进制文件。以下为各系统最简洁的安装命令：

2.2 验证安装

安装完成后，打开终端（Windows 使用 CMD 或 PowerShell），执行以下命令验证 k6 是否可用：

k6 version

正常输出示例：

k6 v0.54.0 (2024-09-30T10:23:12+0000/...)

如果看到版本号，说明安装成功。若提示“命令未找到”，请检查环境变量或重新安装。

进一步验证 k6 能否正常执行脚本：

k6 run --help

该命令会输出 k6 run 子命令的详细参数说明，表明运行时环境已就绪。

2.3 运行第一个 k6 脚本（http.get）

创建一个名为 first-test.js 的文件，内容如下：

import http from 'k6/http';
import { sleep } from 'k6';

export default function () {
  http.get('https://test.k6.io');
  sleep(1);
}

在终端中执行：

k6 run first-test.js

你将看到 k6 启动虚拟用户（VU），向 https://test.k6.io 发送 HTTP GET 请求，并输出实时指标。

2.4 理解 k6 输出指标

k6 运行结束后，会在终端输出一份详细的指标报告。以下为关键指标及其含义：

输出报告示例片段：

     data_received..................: 82 kB  27 kB/s
     data_sent......................: 4.2 kB 1.4 kB/s
     http_req_blocked...............: avg=10.23ms  min=0s       med=0s      max=102.3ms
     http_req_connecting............: avg=5.12ms   min=0s       med=0s      max=51.2ms
     http_req_duration..............: avg=112.45ms min=98.1ms   med=110.2ms max=145.6ms
     http_req_failed................: 0.00%  ✓ 0        ✗ 10
     http_req_receiving.............: avg=0.5ms    min=0.1ms    med=0.4ms   max=1.2ms
     http_req_sending...............: avg=0.2ms    min=0.1ms    med=0.2ms   max=0.3ms
     http_req_tls_handshaking.......: avg=5.01ms   min=0s       med=0s      max=50.1ms
     http_req_waiting...............: avg=106.7ms  min=93.2ms   med=104.5ms max=139.8ms
     http_reqs......................: 10     3.33/s
     iteration_duration.............: avg=1.11s    min=1.09s    med=1.11s   max=1.14s
     iterations.....................: 10     3.33/s
     vus............................: 1      min=1       max=1
     vus_max........................: 1      min=1       max=1

2.5 环境搭建与运行流程总览

下图展示了从安装到输出指标报告的完整流程：

2.6 常见问题与排查

• 安装失败： 检查网络连接，尝试使用 Docker 版本绕过系统包管理器问题。
• k6 命令找不到： 确认安装路径已加入系统 PATH 环境变量，重启终端或重新登录。
• 脚本执行报错： 检查 JavaScript 语法，确保 import 路径正确，目标 URL 可访问。
• 指标数据异常： 确认目标服务没有限流或防火墙拦截，尝试使用 https://test.k6.io 官方测试站点。