uniapp真机调试查看控制台可通过以下方式：在HBuilderX中连接手机后，点击“运行”->“运行到手机或模拟器”->“选择已连接设备”，手机打开调试页面后，HBuilderX底部“控制台”标签页会实时输出日志，也可用Chrome调试：手机开启USB调试并连接电脑，在Chrome地址栏输入“chrome://inspect”，点击“inspect”进入开发者工具查看控制台信息，前者适合实时查看运行日志，后者适合调试网页视图。
Uniapp真机调试如何查看控制台？详细教程助你轻松排查问题
在Uniapp开发中,真机调试是确保应用在真实设备上正常运行的关键环节，而控制台作为查看错误日志、监控网络请求、分析性能的核心工具，掌握其查看方法能极大提升问题排查效率，本文将详细介绍Uniapp真机调试时查看控制台的多种场景和方法，助你轻松搞定调试难题。
真机调试前的准备条件
在开始查看控制台前,需确保以下准备工作已完成：
- 项目环境：已安装HBuilderX或微信开发者工具（根据项目类型选择，如小程序需微信开发者工具）。
- 设备连接：手机与电脑处于同一局域网（Wi-Fi调试），或通过USB数据线连接（USB调试）。
- 权限开启：
- USB调试：手机开启“USB调试模式”（路径：设置→关于手机→连续点击版本号→返回设置→开发者选项→开启USB调试）。
- Wi-Fi调试：部分HBuilderX版本需在手机上安装“HBuilderX调试基座”（通过HBuilderX“运行到手机或模拟器→选择基座安装”）。
开启Uniapp真机调试模式
无论使用哪种工具,真机调试前需先开启调试模式，确保日志能正常输出：
通过HBuilderX开启通用调试模式
- 在HBuilderX中打开Uniapp项目,点击顶部菜单栏“运行→运行到手机或模拟器→选择真机调试（USB或Wi-Fi）”。
- 首次运行时,HBuilderX会提示安装调试基座（若未安装），根据手机系统（Android/iOS）选择对应版本安装。
- 安装完成后,手机会自动启动调试基座，电脑HBuilderX下方控制台会显示“设备已连接”提示，说明调试模式已开启。
微信小程序的特殊调试配置
若项目为微信小程序,需额外在微信开发者工具中开启调试：
- 微信开发者工具中打开项目,点击右上角“详情→本地设置→勾选‘不校验合法域名、web-view（业务域名）、TLS版本以及HTTPS证书’”（避免接口跨域问题影响调试）。
- 点击“工具→编译设置→勾选‘增强编译’”（可选，提升编译速度）。
不同场景下查看控制台的方法
根据项目类型（App、小程序、H5）和调试工具（HBuilderX、微信开发者工具、浏览器），查看控制台的方法有所不同，以下是常见场景的详细步骤：
场景1：使用HBuilderX调试App/小程序/H5（通用方法）
HBuilderX是Uniapp官方推荐工具,其内置控制台可直接查看真机日志，适用于App、小程序、H5等各类项目。
步骤：
-
连接设备：
- USB调试：手机连接电脑，开启USB调试模式，HBuilderX会自动识别设备（若未识别，可点击“运行→选择设备→手动刷新”）。
- Wi-Fi调试：手机与电脑同一局域网，在HBuilderX“运行→运行到手机或模拟器→运行到浏览器→选择手机IP地址输入”（或直接选择“真机调试→Wi-Fi连接”，按提示操作）。
-
查看控制台：
- 设备连接成功后,HBuilderX下方会弹出“控制台”面板（若未显示，可点击底部“控制台”标签页）。
- 控制台会实时输出日志,包括：
- 错误日志：代码语法错误、接口请求失败、组件渲染异常等（红色字体标出）。
- 网络请求：
uni.request的请求URL、参数、响应数据（可通过“过滤”按钮筛选“network”关键词）。 - 日志输出：通过
console.log()打印的调试信息（默认显示，可自定义颜色或过滤级别）。
-
日志过滤与快捷操作：
- 在控制台顶部搜索框输入关键词（如“error”“network”“自定义标识”），可快速定位相关日志。
- 点击日志右侧的“定位源码”按钮，可直接跳转到代码中对应行（需开启“源码映射”）。
场景2：使用微信开发者工具调试小程序
微信小程序需在微信开发者工具中查看控制台,HBuilderX的日志仅作辅助参考。
步骤：
-
启动调试：
- 在微信开发者工具中打开小程序项目,点击顶部“真机调试”按钮（或快捷键
Ctrl+Shift+I），弹出“真机调试”二维码。 - 手机微信扫描二维码,进入小程序调试模式（此时手机端为调试版本，非正式版）。
- 在微信开发者工具中打开小程序项目,点击顶部“真机调试”按钮（或快捷键
-
查看控制台：
微信开发者工具下方会自动切换到“Console”（控制台）面板
