4.1 从零开始：第一个 k6 脚本的完整解剖

在编写第一个 k6 脚本之前，你需要理解 k6 脚本的核心——它本质上是 JavaScript (ES6+) 代码，但运行在 k6 内置的 JavaScript 运行时中，而非浏览器。这意味着你不能使用 window、document 等浏览器 API，但可以调用 k6 提供的强大内置模块。

4.1.1 JavaScript 基础回顾：你只需要掌握这些

k6 脚本不需要复杂的 JavaScript 知识。以下是你必须掌握的核心语法，它们足以支撑 90% 的性能测试脚本编写：

4.1.2 k6 脚本的黄金结构：三块基石

每个 k6 脚本都遵循一个固定的三层结构。理解这个结构，你就掌握了编写任何 k6 脚本的框架。

4.1.3 核心武器：http.get 请求

http.get(url, [params]) 是 k6 中最常用的方法。它发送一个 HTTP GET 请求并返回一个 Response 对象。这个对象包含了你在性能测试中需要的一切：

4.1.4 完整脚本实战：导出与运行

现在，让我们将以上所有知识整合成一个完整的、可运行的 k6 脚本。这个脚本将模拟 10 个虚拟用户在 30 秒内持续访问一个 API 端点。

// 第 1 层：导入层
import http from 'k6/http';
import { check, sleep } from 'k6';

// 第 2 层：配置层
export let options = {
  vus: 10,           // 10 个虚拟用户
  duration: '30s',   // 持续 30 秒
  thresholds: {
    http_req_duration: ['p(95)<500'], // 95% 的请求响应时间 < 500ms
    http_req_failed: ['rate<0.01'],    // 失败率 < 1%
  },
};

// 第 3 层：执行层
export default function () {
  // 发送 GET 请求
  let res = http.get('https://test-api.k6.io/public/crocodiles/');

  // 检查响应
  check(res, {
    '状态码是 200': (r) => r.status === 200,
    '响应时间 < 300ms': (r) => r.timings.duration < 300,
    '返回数据非空': (r) => r.body.length > 0,
  });

  // 模拟用户思考时间
  sleep(1);
}

4.1.5 运行脚本：从命令行到报告

将上述代码保存为 first-test.js，然后在终端中运行以下命令：

# 运行脚本（输出到终端）
k6 run first-test.js

# 运行脚本（输出 HTML 报告）
k6 run --out html=report.html first-test.js

# 运行脚本（输出 JSON 日志）
k6 run --out json=result.json first-test.js

4.1.6 脚本调试技巧：快速验证你的第一个脚本

在运行大规模测试之前，先用 调试模式 验证脚本的正确性：

• 使用 --iterations 1：只执行一次迭代，快速检查语法和逻辑
• 使用 --vus 1：单用户模式，排除并发问题
• 打印调试信息：使用 console.log() 输出变量值（仅在调试时使用，生产环境移除）
• 检查响应体：使用 console.log(res.body) 查看 API 返回的实际数据

# 调试命令示例
k6 run --vus 1 --iterations 1 first-test.js