frankenphp 1.5 在 wsl2 中运行 windows 项目需解决路径互通、i/o 性能、权限及监听配置问题，推荐将项目置于 wsl2 原生路径（如 ~/projects/myapp），通过 explorer.exe . 访问编辑，兼顾稳定性与热更新；其他方式包括禁用监控运行 /mnt/c 项目、用 wslpath 软链透明接入，而直接在 windows 运行 frankenphp.exe 不支持核心特性，不推荐。

FrankenPHP 1.5 是一个基于 PHP 的现代 Web 服务器与应用运行时，它原生支持 Swoole、HTTP/3、QUIC、PHP Worker 模式，并能直接托管 PHP 应用（如 Laravel、Symfony、WordPress），无需 Apache/Nginx 中转。在 WSL2 环境下运行 Windows 项目（即项目文件存于 Windows 路径，如 C:myapp），关键在于路径互通性、文件系统性能、权限控制和 FrankenPHP 的监听配置——不是简单“启动就行”，而是要让 FrankenPHP 在 WSL2 中正确加载、服务并热更新 Windows 下的 PHP 项目。

下面分四类实际场景给出可落地的配置方式：

✅ 推荐方式：项目放 WSL2 原生路径（~/projects/myapp），通过 explorer.exe . 访问 Windows 文件资源管理器

这是最稳定、无权限/换行符/I/O 性能问题的方案。

Windows TTS (WSL2)

在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。

下载

• 在 WSL2 终端中执行：

  mkdir -p ~/projects/myapp
  cd ~/projects/myapp
  composer create-project laravel/laravel .

• 启动 FrankenPHP（确保已安装）：

  frankenphp serve
  # 或指定端口和文档根
  frankenphp serve --docroot=public --addr=0.0.0.0:8080

• Windows 端浏览器访问 http://localhost:8080 即可。
• 需要编辑代码？在 Windows 中打开 explorer.exe .（当前目录会自动映射为 \wsl$Ubuntuhomeyouruserprojectsmyapp），用 VS Code/PhpStorm 打开即可，文件实时同步、无权限报错、Git 行尾符正常。

⚠️ 兼容方式：项目保留在 Windows 路径（/mnt/c/myapp），但需绕过 WSL2 的 /mnt/c 性能瓶颈

FrankenPHP 默认会监控文件变更（用于热重载），而 /mnt/c 是跨文件系统挂载，inotify 不可靠，容易导致 file not found 或热更新失效。
解决办法：

• 启动时禁用文件监控（适用于不依赖 --watch 的场景）：

  frankenphp serve --no-watch --docroot=/mnt/c/myapp/public

• 若必须热重载，改用 inotifywait + killall -USR1 frankenphp 手动触发（需额外脚本），不推荐日常开发。
• 重要提醒：不要在 /mnt/c 下运行 composer install 或 php artisan optimize，因符号链接、扩展编译、临时文件权限易出错；应先 cd /mnt/c/myapp，再 wsl -u root -e bash -c "cd /mnt/c/myapp && composer install"（以 root 权限规避部分 chmod 问题）。

?️ 进阶方式：用 wslpath + 反向代理实现 Windows 项目路径“透明接入”

适合已有大量 Windows 工作流（如 IDE 固定打开 C:myapp）、又想用 FrankenPHP 原生能力的用户。

• 在 WSL2 中创建软链指向 Windows 项目（注意：仅对读操作友好）：

  ln -sf $(wslpath "C:\myapp") ~/win-myapp

• 启动 FrankenPHP 指向该链接：

  frankenphp serve --docroot=~/win-myapp/public

• 同时在 Windows 的 hosts 添加：

  127.0.0.1 myapp.test

• 并在 FrankenPHP 的 frankenphp.yaml 中配置虚拟主机（若使用）：

  servers:
    - host: myapp.test
      document_root: /home/youruser/win-myapp/public

❌ 不推荐方式：直接在 Windows PowerShell/CMD 中调用 frankenphp.exe

FrankenPHP 1.5 的 Windows 原生二进制（.exe）不支持 PHP Worker 模式、Swoole 集成、HTTP/3 及多数现代特性，官方明确建议 Linux 环境优先。WSL2 是目前唯一能完整发挥其能力的 Windows 兼容路径。

不复杂但容易忽略：FrankenPHP 启动后默认只监听 127.0.0.1:8080，若从 Windows 浏览器访问失败，请确认是否加了 --addr=0.0.0.0:8080；另外 WSL2 的防火墙由 Windows 管理，无需额外开放端口，只要没启用第三方安全软件拦截即可。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！