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

写了个在普通浏览器里跑小程序的开源工具：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