2. k6 安装与基础使用

本章将带你完成 k6 的安装、编写第一个压测脚本，并学会运行与查看结果。k6 支持 Windows、macOS 和 Linux 三大平台，安装方式灵活，推荐使用包管理器或官方安装脚本。

2.1 安装 k6

k6 是一个基于 Go 语言开发的单二进制文件工具，安装过程简洁。以下为各平台的推荐安装方式：

2.2 第一个压测脚本

k6 使用 JavaScript（ES6+）编写测试脚本，核心是定义 虚拟用户（VU） 的行为。以下是一个最简脚本，用于对示例 API 发起 GET 请求：

// first-test.js
import http from 'k6/http';
import { sleep } from 'k6';

export default function () {
  // 发送 HTTP GET 请求
  let res = http.get('https://test.k6.io');

  // 检查响应状态码是否为 200
  check(res, {
    'status is 200': (r) => r.status === 200,
  });

  // 模拟用户思考时间（1~3 秒随机）
  sleep(Math.random() * 2 + 1);
}

脚本结构说明：

• import：引入 k6 内置模块，如 http、check、sleep。
• export default function：每个 VU 循环执行的入口函数。
• check()：断言函数，用于验证响应是否符合预期。
• sleep()：模拟用户等待时间，使压测更接近真实场景。

2.3 运行与查看结果

运行脚本使用 k6 run 命令，并通过参数控制并发与时长。以下为常用运行方式：

# 默认运行（1 个 VU，1 次迭代）
k6 run first-test.js

# 指定 10 个 VU，持续 30 秒
k6 run --vus 10 --duration 30s first-test.js

# 分阶段递增并发
k6 run --stage 5s:20,10s:50,20s:30 first-test.js

运行结束后，终端会输出详细报告，包含以下核心指标：

2.4 k6 压测执行流程

下图展示了从脚本编写到结果输出的完整执行链路：

2.5 常用运行参数

k6 提供了丰富的 CLI 参数，用于控制压测行为。以下为高频使用参数：

2.6 结果解读与常见问题

终端报告中的 http_req_duration 是衡量系统性能的核心指标。重点关注 p95 和 p99 分位值，它们反映了绝大多数用户的体验。若 p95 超过 500ms，通常需要优化目标服务或调整压测策略。

常见问题排查：

• 请求失败率高：检查目标服务是否过载、网络是否通畅、脚本中 URL 是否正确。
• VU 数未达到预期：确认系统资源（CPU/内存/文件描述符）是否充足，k6 本身对资源消耗较低。
• 脚本语法错误：使用 k6 run --verbose 查看详细错误堆栈。