跳到正文
V2EX·· 8 小时前AI 评分50

开发者开源 wxa-runner,可在普通 Chrome 中运行微信小程序

写了个在普通 Chrome 里直接跑微信小程序的工具: wxa-runner

AI 导读

开发者开源 wxa-runner,可在普通 Chrome(包括无头浏览器)中运行微信小程序,并使用官方基础库渲染。该工具支持通过 URL 直达页面、自动化测试和 CI 运行,可用命令 `npx wxa-runner dev . --open` 启动;它不替代微信开发者工具,真机预览、调试和代码上传仍需使用官方工具,蓝牙等强依赖硬件的特性暂不支持。

正文

写了个在普通浏览器里跑小程序的开源工具:wxa-runner 。

起因很简单:平时写小程序或者跑测试,微信开发者工具实在太重了——几个 G 的内存占用、动不动就要求重新扫码登录,想放进 Linux CI 跑自动化测试更是折腾。

于是干脆做了这个工具,直接把小程序放进普通 Chrome (包括无头浏览器)里跑,用官方基础库渲染,行为跟真机一致,但轻巧得多。

平时用起来主要有几个爽点:

  • AI Agent 可以直接操作:Claude Code 、Codex 这类 Agent 最擅长的就是操作浏览器。小程序跑在浏览器里,它们用现成的浏览器能力就能点页面、看 DOM 、读控制台和网络请求、写 Playwright 测试,不用为小程序额外配置开发者工具的自动化端口

  • 不用开开发者工具:终端敲一行命令直接在 Chrome 里跑,代码改完秒级刷新,不用扫码登录。

  • URL 直达任意页面:地址栏带上页面路径参数,直接跳到对应内页,不用每次从首页一层层手点进去。

  • 授权弹窗不用人守着点:做自动化测试时,手机号、位置这些授权默认直接通过,流程不会卡死,放在 CI 容器里无人值守很省心。

使用很简单,在小程序目录(或 uni-app / Taro 的编译产物目录)执行:

npx wxa-runner dev . --open

适合日常页面快速调试和自动化测试,不替代微信开发者工具,真机预览、调试和代码上传还是要用官方工具;目前不支持的像蓝牙这类强依赖硬件的特性。

大家平时被开发者工具折磨过的欢迎试试:

https://github.com/open-wxa/wxa-runner

来源:V2EX · v2ex.com