再也不用盲调PC端微信小程序!开源调试神器,文末附下载地址

一、工具是什么？核心原理

WMPFDebugger 是针对 Windows 微信 WMPF 小程序内核的开源调试工具，核心逻辑很简单：

1. 通过 Hook 拦截微信私有 Protobuf 调试协议，绕过官方沙箱限制，开启 LanDebug 远程调试模式；
2. 自研协议转换层，把微信私有调试协议转为标准 Chrome CDP 调试协议；
3. 直接复用 Chrome/Edge 开发者工具，无需适配新调试面板，前端开发者零学习成本。

核心优势

兼容海量 WMPF 内核版本，最新 19841 版本完美适配，覆盖多年微信客户端完整 DevTools 能力：Console 日志、Sources 源码断点、Network 请求、DOM 渲染查看不仅能调试小程序，还支持微信内置浏览器 H5 页面基础调试

二、环境准备

Node.js LTS v22 及以上版本yarn 包管理器Chrome / Edge 任意 Chromium 内核浏览器Windows 10/11 系统（仅支持 PC 微信）

三、4 步快速上手实战教程

步骤 1：克隆项目并安装依赖

打开终端（CMD/PowerShell，建议管理员运行）执行命令：

cd WMPFDebuggeryarn

等待依赖自动安装完成，无报错即可进入下一步。

步骤 2：启动调试代理服务

运行后会自动启动 CDP 代理服务器，并注入 Hook 脚本监听微信小程序进程。

⚠️ 关键操作顺序（90% 人踩坑）：先启动服务 → 再打开微信小程序 → 最后打开调试面板，顺序颠倒会出现空白面板，需重启服务重试。

npx ts-node src/index.ts

步骤 3：打开 PC 微信目标小程序

在 Windows 微信中，点开你需要调试的任意小程序，保持窗口前台运行。

步骤 4：浏览器打开调试面板

复制地址到 Chrome/Edge 地址栏访问：

devtools://devtools/bundled/inspector.html?ws=127.0.0.1:62000

端口 62000 可在src/index.ts源码中自定义修改。

调试效果预览

下方是工具正常运行截图，左侧 PC 微信小程序窗口，右侧 Chrome DevTools 完整展示源码、日志、调用栈：

四、版本适配 & 微信更新指南

支持的 WMPF 版本：

19921 (最新)、19899 (credit @mathmonkeyliu)、19881 (credit @WIAIV)、19871、19841 (credit @AwangYes)、19823 (credit @mathmonkeyliu)

更早版本

19769、19749 (credit @xiaoriri, @Alfalfaaaa, @chengzongcai)、19481 (credit @cosalone, @jiangjie)、19459 (credit @snowflake-x)、19339 (credit @hidacow)、19201 (credit @hidacow)、19027 (credit @XKaguya)、18955 (credit @MapleLeaf2007)、18891 (credit @1357310795)、18787、18151 (credit @1437649480, @zxjBigPower)、18055 (credit @Howard20181)、17127 (credit @Howard20181)、17071 (credit @hyzaw)、17037 (credit @linguo2625469)、16965、16815、16771、16467 (credit @51-xinyu)、16389 (credit @liding58)、16203 (credit @liding58)、16133 (credit @liding58)、14315 (credit @liding58)、14199、14161、13909、13871、13655、13639、13487、13341、13331、11633、11581 (成功连接但会随后渲染进程 crash，请自行测试)

1. 查看本机 WMPF 内核版本

打开任务管理器，找到WeChatAppEx进程右键「打开文件所在位置」文件夹路径中RadiumWMPF与extracted中间的数字，就是当前内核版本。

2. 更新微信获取最新 WMPF 内核

• 微信 4.x 及以上：官网pc.weixin.qq.com下载新版安装包，自带最新内核；
• 微信 4.x 以下：微信搜索框输入:showcmdwnd（不回车）弹出命令窗口，输入：

/plugin set_grayvalue=202&check_update_force

回车等待更新，重启微信生效。

3. 当前支持主流 WMPF 版本

最新稳定版：19841、19823、19769、19749向下兼容至 11581 等老旧内核，新版本内核会持续更新适配。

五、避坑指南 & 常见问题解决

1. 1.调试面板空白、无小程序内容

• 排查启动顺序：必须先启动服务，再开小程序，最后打开 DevTools；
• 核对 WMPF 内核版本是否在支持列表；
• 浏览器使用无痕模式，清除缓存重试。

2. 2.注入失败、终端无日志输出

• Node 版本升级至 v22+；
• 终端以管理员身份运行；
• 关闭电脑防火墙 / 杀毒软件拦截本地 62000 端口。

3. 3.微信内置 H5 页面调试

4.     参考EXTENSION.md文档，仅支持基础日志、页面调试功能。

项目地址

GitHub：https://github.com/evi0s/WMPFDebugger

扫码关注

社区

鹏组安全社区：comm.pgpsec.cn

专注网络技术与骇客的一个综合性技术性交流与资源分享社区

老用户续费88折扣

社区首页

互助中心