2. k6 基础回顾：k6 安装、k6 脚本结构、VU 与迭代概念、options 配置入门

在深入自定义检查点与容量压测水位口径之前，必须夯实 k6 的基础操作与核心概念。本章将围绕四个关键维度展开：环境安装、脚本骨架、虚拟用户（VU）与迭代（Iteration）的运作机制，以及 options 配置的入门用法。掌握这些内容，后续章节的边界测试与水位分析才能建立在稳固的认知之上。

2.1 k6 安装与环境验证

k6 支持主流操作系统，推荐使用包管理器或直接下载二进制文件进行安装。以下为常见安装方式：

安装完成后，在终端执行 k6 version 验证是否成功。若返回版本号（如 k6 v0.50.0），则环境准备就绪。

2.2 k6 脚本结构：从入口到导出

一个标准的 k6 脚本（通常以 .js 为后缀）遵循模块化设计，核心由三个部分组成：导入模块、默认导出函数（default export） 以及 可选的 options 配置。以下是一个最小化但完整的脚本示例：

// 1. 导入 k6 内置模块
import http from 'k6/http';
import { check, sleep } from 'k6';

// 2. 定义测试配置（可选，但推荐）
export let options = {
  vus: 10,
  duration: '30s',
};

// 3. 默认导出函数 —— 每个 VU 循环执行的代码
export default function () {
  let res = http.get('https://test.k6.io');
  check(res, {
    'status is 200': (r) => r.status === 200,
  });
  sleep(1);
}

脚本执行流程如下：

• 导入阶段：加载 k6/http 用于发起 HTTP 请求，k6 核心模块提供 check、sleep 等工具函数。
• 配置阶段：options 对象定义测试负载参数，如并发 VU 数、运行时长。
• 执行阶段：k6 根据 options 创建指定数量的 VU，每个 VU 反复执行 export default function 中的代码，直到测试结束。

2.3 VU 与迭代：理解并发与循环

VU（Virtual User，虚拟用户）和迭代（Iteration）是 k6 负载模型的两大基石。理解它们的区别与关系，是设计压测场景的前提。

VU 与迭代的协作关系可以通过以下 SVG 流程图直观展示：

2.4 options 配置入门：控制负载与行为

options 是 k6 脚本中用于声明测试参数的全局对象。它支持多种配置项，从基础的并发控制到高级的阈值设定。以下是最常用的入门级配置：

以下是一个使用 stages 进行阶梯式加压的配置示例，这在容量压测中非常实用：

export let options = {
  stages: [
    { duration: '2m', target: 50 },   // 前 2 分钟，从 0 线性增加到 50 VU
    { duration: '5m', target: 50 },   // 保持 50 VU 运行 5 分钟
    { duration: '2m', target: 100 },  // 2 分钟内增加到 100 VU
    { duration: '5m', target: 100 },  // 保持 100 VU 运行 5 分钟
    { duration: '1m', target: 0 },    // 1 分钟内降至 0 VU，优雅结束
  ],
};

配置项的执行优先级遵循以下规则：

• 若同时指定 duration 和 iterations，k6 会优先使用 iterations，并在达到总迭代次数后停止，忽略 duration。
• stages 与 vus/duration 互斥，使用 stages 时不应再设置 vus 和 duration。
• 阈值（thresholds）在测试结束后统一评估，不会中断正在运行的测试。