2. k6 环境搭建：安装、运行与版本管理

在开始编写压测脚本之前，必须先完成 k6 运行环境的搭建。本章将覆盖主流操作系统（Windows、macOS、Linux）的安装方式、首次运行验证、云服务登录以及版本切换策略，确保你能够快速进入实战状态。

2.1 各平台安装方式对比

k6 官方提供了多种安装途径，包括包管理器、二进制下载和 Docker 镜像。下表列出了各平台推荐安装方式及对应命令：

2.2 k6 run 命令初体验

安装完成后，通过 k6 run 命令执行第一个压测脚本。创建一个名为 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 输出实时指标，包括请求持续时间、HTTP 请求失败率、虚拟用户数等。默认情况下，k6 以 1 个虚拟用户运行 1 次迭代。若要调整并发，可使用 --vus 和 --duration 参数：

k6 run --vus 10 --duration 30s first-test.js

该命令启动 10 个虚拟用户，持续运行 30 秒。输出结果中重点关注以下指标：

• http_req_duration：请求平均/中位数/最大耗时
• http_req_failed：失败请求占比
• vus：当前活跃虚拟用户数
• iterations：总迭代次数

2.3 k6 login cloud：连接 Grafana Cloud k6

Grafana Cloud k6 提供云端结果存储、团队协作和高级分析能力。使用 k6 login cloud 命令将本地 CLI 与云账号绑定：

k6 login cloud -- <YOUR_API_>

API 可在 Grafana Cloud 门户的 k6 Settings → API Tokens 中生成。登录成功后，运行脚本时添加 --out cloud 参数即可将结果上传至云端：

k6 run --out cloud first-test.js

上传后，终端会输出一个 URL 链接，点击即可在浏览器中查看实时仪表盘、历史趋势和对比报告。

2.4 k6 版本管理与升级

k6 采用语义化版本号（SemVer），主版本升级可能引入破坏性变更。以下为版本管理的关键操作：

2.5 环境搭建流程总览

下图展示了从安装到首次云端运行的完整流程，帮助你建立全局视角：

2.6 常见安装问题与排查

• Windows 下 Chocolatey 安装失败：确保以管理员身份运行 PowerShell，并执行 Set-ExecutionPolicy RemoteSigned 解除脚本限制。
• macOS 下 Homebrew 权限错误：运行 brew doctor 修复目录权限，或使用 sudo chown -R $(whoami) /usr/local/share 调整所有权。
• Linux 下 GPG 密钥过期：重新导入 k6 官方密钥，命令见上文 APT 安装步骤。
• Docker 容器内无法连接目标：检查容器网络模式，使用 --network host 或正确配置 DNS。
• k6 login cloud 返回 401：确认 未过期，且在 Grafana Cloud 中具有 k6 资源写入权限。