Swoole 在 Windows 上性能差、功能受限、稳定性低，官方不支持原生运行；推荐使用 WSL2 进行开发调试，因其基于 Linux 内核，可正常启用 epoll 和协程等核心功能。
Windows 上跑 Swoole 本身就不是推荐路径
直接说结论：swoole 在 Windows 上性能差、功能受限、稳定性低，这不是配置或代码能根本解决的问题。官方明确不支持 Windows 原生运行（仅提供 WSL 或 Cygwin 兼容层），多数扩展（如 coroutine、channel）在 Windows 下不可用或行为异常。
常见错误现象包括：HTTP 服务吞吐量不足 Linux 的 1/5、定时器延迟严重、协程挂起后不恢复、swoole_server->start() 卡住无报错。
- Windows 版本的
swoole实际是基于libuv模拟事件循环，非原生 epoll/kqueue，调度开销大 -
PHP-FPM+nginx在 Windows 上反而比swoole更稳更快 - 即使启用
SWOOLE_BASE模式，也无法绕过 Windows I/O 多路复用的底层瓶颈
如果非要在 Windows 上调试，只用 WSL2
WSL2 是目前唯一靠谱的折中方案——它不是“Windows 上跑 Swoole”，而是“Linux 内核里跑 Swoole”，性能接近原生 Ubuntu。
使用场景：本地开发调试、CI 前验证逻辑、不想切系统但需测试协程行为。
- 必须用 WSL2（不是 WSL1），否则
epoll不可用，swoole会退化为 select 模式 - PHP 安装必须在 WSL2 内完成，不能复用 Windows 的
php.exe - VS Code 推荐装 Remote - WSL 插件，直接编辑 WSL 文件系统里的代码，避免跨文件系统同步问题
- 数据库等依赖服务也得部署在 WSL2 内（如
mysql、redis），别连 Windows 主机的127.0.0.1，网络延迟高且端口映射易出错
swoole_http_server 在 Windows 下启动慢的典型原因
不是代码写得慢，是初始化阶段就卡在几个固定环节。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
常见错误现象：swoole_http_server->start() 耗时数秒甚至超时，strace（WSL）或 Process Monitor（Windows）可见大量 GetAdaptersAddresses 和 netsh 调用。
- Windows 下
swoole默认尝试枚举所有网卡信息用于日志和绑定提示，而 Windows 网络栈响应极慢，尤其有虚拟网卡（Docker、VMware、Hyper-V）时 - 解决方案：显式指定
host，禁用自动探测：$server->set(['host' => '127.0.0.1'])，不要留空或用'0.0.0.0' - 关闭日志中的 IP 反查：
'log_level' => SWOOLE_LOG_ERROR，避免gethostbyaddr阻塞 - 若用
swoole_websocket_server，务必关掉'open_websocket_close_frame' => false，Windows 对 WebSocket 关闭帧处理有兼容缺陷
别碰 swoole_timer_tick 和 swoole_async on Windows
这两个模块在 Windows 上基本不可靠，不是“需要调参”，而是设计上就不适配。
使用场景：想在本地测定时任务、异步文件读写、DNS 查询——结果往往是定时不准、回调永不触发、swoole_async_readfile 返回 false 且无错误码。
-
swoole_timer_tick底层依赖timerfd或setitimer，Windows 无对应机制，模拟实现精度差（误差常达 500ms+） -
swoole_async系列函数在 Windows 上实际走的是线程池模拟，无法真正异步，且线程创建销毁开销大，频繁调用会导致句柄泄漏 - 替代方案：用
pcntl_fork+sleep（仅限 WSL2）、或改用ReactPHP/amphp这类纯 PHP 实现的异步库（它们对 Windows 友好得多）
真正要上线的服务，别在 Windows 上压测、别信“加了 opcache 就快了”这类说法——底层没换，再怎么调都是在沙上盖楼。
