Locust 的命令行参数不少。下面按「我平时真正会改的」分组。老版本里叫 --slave / --no-web，现在对应 --worker / --headless；表里两种都写了，以你本机 locust --help 为准。
入口
| 参数 | 作用 |
|---|---|
-f / --locustfile | 脚本路径，默认 locustfile.py |
-h / --help | 帮助 |
-V / --version | 版本 |
Web UI
| 参数 | 作用 |
|---|---|
--web-host | Web 页面绑定的地址，默认本机 |
-P / --web-port | Web 端口，默认 8089 |
-H / --host | 被测系统的根地址，例如 https://example.com |
先起 UI 再在浏览器里设用户数，是最常见的用法：
bash
locust -f locustfile.py --host https://example.com无界面 / 一次性跑完
老参数：--no-web，新参数：--headless。需要同时给出用户数和孵化速率。
| 参数 | 作用 |
|---|---|
-c / --users（老：--clients） | 并发用户数 |
-r / --spawn-rate（老：--hatch-rate） | 每秒启动多少用户 |
-t / --run-time | 跑多久，如 300s、20m、1h30m |
bash
locust -f locustfile.py --headless --users 100 --spawn-rate 10 --run-time 5m --host https://example.com分布式
一台 master 出报表，多台 worker 发请求。
| 参数 | 作用 |
|---|---|
--master | 本节点当 master |
--worker（老：--slave） | 本节点当 worker |
--master-host | worker 要连的 master 地址，默认 127.0.0.1 |
--master-port | master 端口，默认 5557（另会用到 +1 那个端口） |
--master-bind-host / --master-bind-port | 只给 master 用，限制监听地址和端口 |
日志和结果
| 参数 | 作用 |
|---|---|
--csv | 把统计写成 CSV 前缀 |
-L / --loglevel | DEBUG / INFO / WARNING / ERROR |
--logfile | 日志文件；不设就打到终端 |
--print-stats | 终端持续打统计 |
--only-summary | 只打摘要 |
看脚本结构
| 参数 | 作用 |
|---|---|
-l / --list | 列出测试类，配合 -f |
--show-task-ratio | 打印各 task 占比 |
--show-task-ratio-json | 同上，JSON |
不确定本机版本时，先 locust --help。参数对了，比改脚本更常能把一次压测跑起来。