在普通浏览器里，用微信官方基础库运行小程序。为本地调试和 E2E 自动化测试而生。

文档 · English · 中文

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 中测试
• 在 CI 中运行：Linux 上无头运行，不装开发者工具
• 命令与环境变量
• 功能与限制
• 常见问题

参与开发

从源码构建、运行示例和测试见 CONTRIBUTING.md。欢迎提交 Issue 和 PR。

致谢

• 微信团队：官方基础库与编译器
• WEPT：最早验证了在浏览器中运行小程序的可行性

许可证

MIT。内置基础库 wxa-baselib 是微信官方代码，版权归腾讯所有，不适用本项目的 MIT 协议。