小游戏
  • 工具
    • 小游戏调试/真机调试/真机调试升级Beta

    真机调试能力升级 Beta

    查看 Markdown

    最后一次编辑于 2026-07-04

    当前小游戏真机调试已支持以下能力：

    • 在 Sources 面板中对源代码进行断点调试
    • 在 Console 面板中查看日志、运行代码

    虽然能对开发者调优、定位游戏问题提供一定帮助，但仍然存在以下问题：

    1. Network 无法显示网络请求
    2. Sources 显示的混淆后的代码
    3. 函数调用、网络请求无法与游戏逻辑关联
    4. 无法获取小游戏启动耗时、首帧耗时等小游戏框架的性能
    5. 缺少wx接口耗时分析的手段

    因此平台计划在原真机调试功能的基础上，逐步对小游戏真机调试能力进行升级。

    原真机调试功能入口及基础使用请查看文档

    v1.0

    版本变更

    1. 支持 Performance
    2. Network 支持查看 wx.request、wx.downloadFile、wx.uploadFile、wx.connectSocket 数据
    3. Sources 面板支持Source Map

    版本要求

    • Android 微信客户端版本 >= 8.0.55
    • 基础库版本 >= 3.7.4
    • 微信开发者工具版本 >= Nightly 1.06.2412302

    注意：iOS暂不支持

    使用

    1. Network

    Tab切换至 Network 面板，即可查看所有网络请求

    1. Sources

    Tab切换至 Sources 面板，可查看业务源代码

    1. Performance

    Tab切换至 Performance 面板，可查看CPU和wx接口调用

    关于Performance，可查阅chrome文档

    已知问题

    1. Console 面板中会显示非业务的日志
    2. Network 中的请求无法查看响应
    3. Network 中部分请求响应的size显示为0
    4. Network 中没有wx.createImage的请求

    v2.0

    版本变更

    1. 支持 iOS 高性能模式真机调试
    2. 调试面板支持 Sources、Network、Console、Performance 功能
    3. Sources 支持 Source Map
    4. Network 支持查看 wx.request、wx.downloadFile、wx.uploadFile、wx.connectSocket 数据
    5. Performance支持分析主线程执行性能

    版本要求

    使用

    前置准备

    • 通过 USB 数据线将 iOS 设备连接到电脑（如果是 Mac 则可直接连接，Windows 电脑需要安装 iTunes）
    • iOS 设备开启「网页检查器」：设置 - Safari浏览器 - 高级 - 网页检查器
    • iOS 设备信任电脑、电脑允许配件连接

    使用 Mac 电脑时，可以通过以下方式验证前置准备是否完成：参考Enabling Web Inspector开启 Safari 的「开发」子菜单， iOS 手机通过数据线连接电脑后，可在「开发」中显示设备。

    切换 iOS 系统调试

    默认「iOS 系统」调试不可选择，当满足以下条件时可选：

    • 完成前置准备
    • iOS 系统版本 >= 16.4
    • 开启小游戏高性能模式

    注意：只支持一台 iOS 设备和电脑连接，请拔掉除调试设备外的其他 iOS 设备

    使用 iOS 设备扫码调试

    使用 iOS 设备扫码后，即可正常开始调试

    注意：当使用 iOS 客户端版本或基础库版本不符合要求的设备扫码时，会立即结束调试

    已知问题

    1. Windows 电脑上使用时，会出现防火墙提示，允许即可
    2. Mac 电脑请确保已安装如下包

    • libplist

    • libusbmuxd

    • libimobiledevice

      示例

      brew install libplist libusbmuxd libimobiledevice

    问题反馈 & 建议