安装
|
如果遇到问题，请查阅 故障排除安装 部分。 |
-
安装 Python（如果尚未安装）
-
安装 Locust
pip3 install locust -
验证安装
locust -V locust 2.32.5 from /usr/local/lib/python3.12/site-packages/locust (Python 3.12.5)
使用 uvx（替代方法）
-
安装 uv
-
在临时环境中安装并运行 Locust
uvx locust -V locust 2.32.5 from /.../uv/.../locust (Python 3.12.5)
Done!
现在，您可以 创建并运行第一个测试了。
预发布版本
如果您需要最新的 Locust 版本，并且等不及下一个版本发布，可以像这样安装开发版：
pip3 install -U --pre locust预发布版本在每次将分支/PR合并到主分支时发布。
为开发安装
如果您想修改 Locust 或为项目做出贡献，请参阅 开发和文档 Locust。
故障排除安装
一些常见安装问题的解决方案：
ERROR: Failed building wheel for xxx
虽然 Locust 本身是一个纯 Python 包，但它有一些依赖项（例如 gevent 和 geventhttpclient）是从 C 代码编译而来的。几乎所有常见平台都有 PyPi 上的二进制包，但有时会有新版本没有提供二进制包，或者您正在使用一些特殊的平台。在这种情况下，您有两个选择：
-
（在 macOS 上）安装 Xcode：
xcode-select --install -
使用
pip install --prefer-binary locust来选择预编译版本的包，即使有更高版本的源代码包可用。 -
尝试通过搜索错误信息来查找具体的失败包（而不是 Locust），确保您安装了适当的构建工具等。
Installation works, but the locust command is not found
在运行 pip 时，是否看到警告：“The script locust is installed in '…' which is not on PATH”？
请将该目录添加到您的 PATH 环境变量中。
Increasing Maximum Number of Open Files Limit
每个来自 Locust 的用户/HTTP 连接都会打开一个新的文件（技术上是文件描述符）。许多操作系统默认设置了一个较低的最大可同时打开文件的限制。Locust 会尝试自动调整这一限制，但在很多情况下，您的操作系统可能不允许这样做（在这种情况下，您会在日志中看到警告）。因此，您需要手动进行调整。
如何执行此操作取决于您的操作系统，但您可以在以下网站找到一些有用的信息：
对于基于 systemd 的系统（例如 Debian/Ubuntu），图形登录会话使用不同的限制。请参阅 Unix StackExchange 上的附加设置 以获取更多设置方法。