open-wxa/wxa-runner

这是什么？

核心功能

• 01在浏览器中基于微信官方基础库运行小程序编译产物。
• 02支持原生小程序以及 uni-app、Taro 的编译输出。
• 03可用 Playwright 无头运行 E2E 测试，无需开发者工具。
• 04支持用 Chrome DevTools 打断点、查看网络请求和 DOM。
• 05保存代码后自动热更新。
• 06通过 setup mock 原生 API、拦截 wx.request 并预置登录态。

适用场景

• 在 Linux CI 中为小程序编写并运行 Playwright 端到端测试。
• 开发阶段用浏览器开发者工具调试页面逻辑和网络请求。
• 测试需要模拟登录或桩化后端响应的业务流程。

快速上手

1. 1

   对编译后的小程序目录启动开发服务器

   npx wxa-runner dev ./dist/dev/mp-weixin
2. 2

   在浏览器中打开终端显示的本地地址

使用前须知

• !不能替代微信开发者工具，预览、上传和真机调试仍需使用开发者工具。
• !内置的微信官方基础库版权归腾讯所有，不适用本项目的 MIT 协议。

标签

常见问题

wxa-runner 是什么？

在普通浏览器中用微信官方基础库运行小程序，支持 Chrome DevTools 调试与 Playwright 端到端测试。 wxa-runner 可以直接在桌面浏览器中运行小程序的编译产物，支持原生小程序目录，也支持 uni-app 和 Taro 的编译结果。页面渲染、组件、setData 和生命周期都由微信官方基础库执行，而非框架重新实现，行为更接近真机。

wxa-runner 可以免费使用吗？用的什么许可证？

wxa-runner 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

wxa-runner 还在维护吗？

活跃维护中。wxa-runner 最近一次提交是在 2026年10月21日。

wxa-runner 适合用来做什么？

在 Linux CI 中为小程序编写并运行 Playwright 端到端测试。 开发阶段用浏览器开发者工具调试页面逻辑和网络请求。 测试需要模拟登录或桩化后端响应的业务流程。

wxa-runner 怎么安装和运行？

对编译后的小程序目录启动开发服务器: npx wxa-runner dev ./dist/dev/mp-weixin 在浏览器中打开终端显示的本地地址

在哪里获取 wxa-runner？

源代码和安装说明在 GitHub 上：https://github.com/open-wxa/wxa-runner