WMPFDebugger：Windows微信小程序调试工具详解

### 项目概述
WMPFDebugger是一个针对Windows微信小程序的调试工具，通过逆向微信开发者工具，实现了小程序私有调试协议与标准Chrome调试协议（CDP）的转换，从而允许开发者使用基于Chromium浏览器的开发者工具调试任意小程序。

### 技术原理
该工具的核心机制包括：

**协议转换技术**
- 微信小程序调试协议是基于protobuf实现的私有协议
- 通过逆向微信开发者工具提取相应的协议实现
- 将小程序私有协议转换为标准Chrome调试协议（CDP）
- 允许使用标准Chromium浏览器内嵌开发者工具进行调试

**连接机制**
- 通过patch Chrome调试协议的过滤器和条件判断
- 强制小程序连接到外部调试器（远程调试，LanDebug模式）
- 自动注入hook代码到小程序运行时中

### 环境要求
- **Node.js**: 至少需要LTS v22版本
- **包管理器**: yarn
- **浏览器**: 基于Chromium的浏览器（如Chrome、Edge等）

### 使用步骤

**第一步：克隆并安装依赖**
```bash
git clone https://github.com/evi0s/WMPFDebugger
cd WMPFDebugger
yarn
```

**第二步：启动调试服务器**
```bash
npx ts-node src/index.ts
```
该命令会同时启动：
- 调试服务器
- CDP代理服务器
- 自动注入hook代码到小程序运行时

**重要注意事项**：在此步骤之后，必须先启动小程序（第三步），再打开开发者工具（第四步）。如果操作顺序颠倒，需要重新从第二步开始。

**第三步：打开目标小程序**
在微信中打开任意需要调试的小程序。

**第四步：访问开发者工具**
在浏览器中访问以下地址：
```
devtools://devtools/bundled/inspector.html?ws=127.0.0.1:62000
```

### 配置说明
- **CDP端口**：默认端口为62000，可以根据需要修改为任意其他端口
- **端口配置**：相关代码定义在`src/index.ts`文件中

### 技术特点
1. **协议兼容性**：实现了私有协议到标准协议的转换
2. **无缝集成**：可以直接使用熟悉的Chromium开发者工具
3. **自动化注入**：无需手动配置，hook代码自动注入
4. **灵活性**：支持调试任意微信小程序

该工具为Windows平台下的微信小程序开发提供了专业的调试解决方案，解决了传统调试方式的局限性，提高了开发效率和调试体验。

WMPFDebugger：Windows微信小程序调试工具详解

评论已关闭

本文目录

分类

最新文章