Hyperf 开发推荐三路径：Windows 用 WSL2，macOS/Linux 直装，跨平台协作用 Docker；禁用虚拟机、宝塔等冗余方案。
Hyperf 本身不依赖虚拟机，但因 Swoole 引擎仅支持 Linux/macOS，Windows 用户需通过兼容层运行。所谓“HyperfVM”并非官方工具，而是社区对基于虚拟化方式搭建 Hyperf 开发环境的统称。实际部署中，不推荐用传统虚拟机（如 VMware + CentOS）作为首选方案，它配置繁琐、资源占用高、网络和文件共享易出问题。
更合理的选择是按系统分路径：
Windows 系统优先用 WSL2
WSL2 是微软官方提供的轻量级 Linux 子系统，性能接近原生，且与 Windows 文件系统无缝互通。
- 启用方式：以管理员身份运行 CMD，执行
wsl --install -d Ubuntu-24.04
- 安装后直接在 Ubuntu 中安装 PHP 8.2、Swoole 扩展和 Composer，再用
composer create-project hyperf/hyperf-skeleton创建项目。 - 无需额外配网络、防火墙或宝塔面板，开发体验干净高效。
macOS 或 Linux 系统直接本地部署
- 确保 PHP ≥ 8.1，已启用
swoole（v5.0+）、json、openssl、mbstring、pdo、redis等扩展。 - 关键一步：在
php.ini中添加swoole.use_shortname = Off
- 运行命令即可启动：
composer create-project hyperf/hyperf-skeleton myapp cd myapp php bin/hyperf.php start
Docker 是跨平台最稳的方案
尤其适合多服务协作或需要 MySQL/Redis 等配套组件的场景。
- 先装 Docker Desktop（Win/macOS）或 Docker Engine（Linux）
- 启动一个预装好环境的 Hyperf 容器：
docker run -it --rm \ -v $(pwd):/data/project \ -p 9501:9501 \ -w /data/project \ hyperf/hyperf:8.1-alpine-v3.18-swoole \ sh -c "composer create-project hyperf/hyperf-skeleton . && php bin/hyperf.php start"
- 本地代码修改后，容器内服务会自动热重启（配合
server:watch命令更佳）。
注意：所有方案都不需要安装 Hyper-V Server、CentOS 虚拟机或宝塔面板——这些属于过时或过度设计的做法，容易引入网络不通、权限异常、SELinux 冲突等问题。
不复杂但容易忽略
