wxa-runner
在普通浏览器里，用微信官方基础库运行小程序。为本地调试和 E2E 自动化测试而生。
npx wxa-runner dev ./dist/dev/mp-weixin # 原生小程序目录，或 uni-app / Taro 编译产物 # → http://localhost:3000
- 和真机一致：直接运行小程序的编译产物，渲染、组件、
setData、生命周期都是微信官方基础库的代码，不是 H5 那样由框架重新实现 - 无头 E2E：用 Playwright 直接在浏览器里测试，不用远程控制开发者工具；CI 里无头运行，Linux 上不需要开发者工具
- 用熟悉的工具调试：Chrome DevTools 打断点、看网络请求、看 DOM，保存后热更新
- 跳过走不通的环节：在 setup 里预置登录态、mock 原生 API、拦截请求，不用改业务代码
它不替代开发者工具：预览、上传、真机调试仍然要用开发者工具。
文档
- 快速开始：安装、基础库和编译器
- 启动前准备（setup）：跳过登录、mock 原生 API、拦截
wx.request - 真实登录：借开发者工具的登录态拿真实的 code 和手机号
- 热更新
- 在 Playwright 中测试
- 命令与环境变量
- 功能与限制
参与开发
从源码构建、运行示例和测试见 CONTRIBUTING.md。欢迎提交 Issue 和 PR。
致谢
- 微信团队：官方基础库与编译器
- WEPT：最早验证了在浏览器中运行小程序的可行性
许可证
MIT。内置基础库 wxa-baselib 是微信官方代码，版权归腾讯所有，不适用本项目的 MIT 协议。