文章目录一、通用准备二、Android 平台调试1. 基础环境搭建2. 查看日志3. 断点调试4. 性能分析三、iOS 平台调试1. 环境要求2. 构建与安装3. 查看日志4. 断点调试四、常见问题与技巧1. 真机连接不上 Profiler2. 包体过大无法安装3. 真机闪退 崩溃4. 推荐插件UniLogViewer总结Unity的真机调试是游戏开发中至关重要的一环因为很多问题如性能瓶颈、触摸输入、传感器数据、渲染兼容性只在真机上才会出现。一、通用准备在开始真机调试前请确保Unity版本建议使用长期支持版LTS如2021.3或2022.3。Build Settings勾选Development Build开发版本这会包含调试符号并允许Profiler连接。勾选Script Debugging脚本调试如果你需要在Visual Studio中打断点必须勾选此项会增加包体大小和些许性能开销发布时需关闭。Autoconnect Profiler如果你希望一运行就自动连接Profiler勾选此项。二、Android 平台调试Android是调试相对方便的平台。1. 基础环境搭建JDK/SDK/NDK通过Unity Hub安装或者指定电脑上安装的 Android Studio 路径。手机设置开启开发者模式和USB调试模式。驱动确保电脑能识别手机通常安装手机助手或Android Studio自带驱动即可解决。2. 查看日志这是最常用的调试手段。方法 AUnity Console 窗口连接手机Build Settings中选择 “Build and Run”。Unity Editor底部的Console窗口会自动显示Debug.Log等输出信息。注意有时连接不稳定会断开需重新插拔USB。方法 BADB Logcat推荐最稳定如果你不想用Unity的Console或者Unity崩溃导致日志中断可以使用Android SDK自带的adb命令。打开命令行CMD或Terminal输入adb logcat-sUnity这将只显示Unity相关的日志过滤掉安卓系统的噪音。Android Studio Logcat如果你安装了Android Studio其底部的Logcat窗口功能更强大支持按包名过滤、按错误等级着色。3. 断点调试如果需要在真机上逐行调试代码在 Build Settings 中勾选Script Debugging。点击 “Build and Run” 安装到手机。在 Visual Studio (或 Rider) 中打开脚本设置断点。在 VS 菜单栏选择调试-附加 Unity Debugger。在列表中选择你的 Android 设备通常显示IP或设备ID点击连接。4. 性能分析Profiler确保手机和电脑在同一局域网WiFi。若通过USB连接需在 Editor 中选择adb setup相关选项或直接在Profiler窗口选择设备。若通过WiFi在 Profiler 窗口顶部下拉菜单选择设备IP。Frame Debugger用于查看渲染步骤Draw Calls连接手机后点击 Editor 顶部的Window - Analysis - Frame Debugger点击 Enable 即可实时查看手机上的渲染情况。三、iOS 平台调试iOS的调试必须通过 macOS 系统和 Xcode 进行流程比 Android 繁琐。1. 环境要求一台 Mac 电脑。安装最新版 Xcode。Apple Developer 账号免费账号只能真机调试7天且不能开启Push Notification等功能付费账号$99/年。iPhone 需在设置 - 通用 - 设备管理中信任开发者证书。2. 构建与安装在 Unity 的 Build Settings 中点击Build不要选 Build and RunUnity无法直接安装IPA到手机。Unity 会生成一个 Xcode 工程文件夹。打开生成的.xcodeproj文件。在 Xcode 中设置 Signing Capabilities选择你的 Team。点击 Xcode 左上角的 “Play” 按钮Build and Run安装到手机。3. 查看日志Xcode Console手机运行后Xcode底部的控制台会实时输出Debug.Log信息。这是最标准的方式。Console.app (控制台.app)macOS自带工具。连接iPhone后可以查看设备级的系统日志包括Unity崩溃堆栈。路径应用程序 - 实用工具 - 控制台。4. 断点调试Unity Build Settings 勾选Script Debugging。Build 生成 Xcode 工程。打开 Xcode 工程运行到手机上。回到 Visual Studio (Windows) 或 Rider (Mac)。如果是Windows VS需通过网络连接Mac代理进行调试配置较复杂通常建议直接在 Mac 上用 Rider 或 VS for Mac已停更调试。如果是Mac Rider点击 Rider 顶部的 “Attach to Unity Process”选择运行中的 iPhone 设备。或者直接在Xcode中打断点调试 C 代码但无法直接调试 C# 代码除非通过特定插件桥接。四、常见问题与技巧1. 真机连接不上 ProfilerAndroid尝试使用 USB 连接并在命令行输入adb forward tcp:54999 localabstract:Unity-XXX(具体端口视Unity版本而定通常自动处理)。确保手机没有开启VPN或防火墙拦截端口54999-5555范围。iOS确保手机和Mac在同一WiFi。检查 Xcode 工程中的enableableProfiler标志是否开启通常 Unity Development Build 会自动开启。2. 包体过大无法安装如果使用了Script Debugging包体会显著增大。如果遇到安装失败尝试清理手机空间或关闭 Deep Profiling深度性能分析。3. 真机闪退 崩溃这是真机调试最痛苦的地方。Android使用adb logcat抓取崩溃前最后几十行日志搜索 “Exception” 或 “Error”。iOS在 Xcode 的 Organizer 或设备日志中查看 Crash Report。如果是 IL2CPP 编译问题通常需要看崩溃堆栈对应 C# 的哪一行可以使用第三方工具如 Crashlytics 辅助解析。4. 推荐插件UniLogViewer如果在真机上不方便看电脑日志可以使用开源插件如In-Game Debug Console在手机屏幕上显示一个悬浮窗点击即可查看 Log 输出非常适合测试人员现场复现Bug。总结功能AndroidiOS日志查看Unity Console / ADB LogcatXcode Console断点调试VS/Rider 直接 AttachXcode运行 VS/Rider Attach性能分析USB/WiFi 连接 ProfilerWiFi 连接 Profiler必要工具Android SDK, ADBXcode, Mac电脑建议初学者先从Android ADB Logcat开始熟悉因为它是免费且门槛最低的调试方式。