解决在Unity中封装Debug.Log后代码行定位问题

最新推荐文章于 2025-06-03 14:27:53 发布
最新推荐文章于 2025-06-03 14:27:53 发布
阅读量3.3k 收藏 6
点赞数 2
分类专栏： S3_Unity学习 UnityBuild 文章标签： Unity编译 Debug定位
探讨在Unity中封装Debug.Log后的代码行定位问题，分析Unity处理StackFrame的机制，提供一种通过自定义OnOpenAsset实现代码定位的解决方案。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

 

解决在Unity中封装Debug.Log后代码行定位问题

众所周知，代码中使用Debug.Log*输出的日志在Unity的ConsoleWindow中可以双击定位到对应的代码行，然而将Debug.Log*封装到自己的日志类中后，定位就失去意义了。原因很简单，Unity只会处理StackFrame的栈顶信息，它们保存在LogEntry中，栈顶的方法对应的脚本文件会以其instanceID来保存，其他StackTrace信息则以字符串结果存储，最终在双击ConsoleWindow中的ListView条目时通过指定了OnOpenAssetAttribute的callback来打开代码编辑器。其中，OnOpenAssetAttribute参数用于处理存在多个Callback时的优先级问题。

image

通过阅读ConsoleWindow代码，想到了一个解决思路：自己实现OnOpenAsset，通过获取ConsoleWindow中的ListView得到当前选中的row，然后在LogEntries中取得该行对应的LogEntry，其中的condition字段保存了StackTrace字符串，最后过滤掉包装的日志类后拿到脚本文件名和代码行，用OpenFileAtLineExternal直接打开。在实现过程中发现，完全没有必要拿到LogEntry，因为ConsoleWindow中的m_ActiveText就是StackTrace字符串，直接处理就好了。

在想到该方案之前，看过两个解决方法：1）将日志类编译成DLL；2）输出日志时自己记录StackFrame，通过一系列手段在OnOpenAsset查找LogEntry中对应的StackFrame。不过这两种方案都不能满足个人的完美主义情节，方案1失去了预编译宏的灵活，一旦日志系统改动需要重编DLL和处理依赖，方案2低效且过于复杂。

最后摘出代码供参考，实现环境为：Unity 4.7.5f1, UnityVS+Visual Studio 2015 Pro

 

众所周知，代码中使用Debug.Log*输出的日志在Unity的ConsoleWindow中可以双击定位到对应的代码行，然而将Debug.Log*封装到自己的日志类中后，定位就失去意义了。原因很简单，Unity只会处理StackFrame的栈顶信息，它们保存在LogEntry中，栈顶的方法对应的脚本文件会以其instanceID来保存，其他StackTrace信息则以字符串结果存储，最终在双击ConsoleWindow中的ListView条目时通过指定了OnOpenAssetAttribute的callback来打开代码编辑器。其中，OnOpenAssetAttribute参数用于处理存在多个Callback时的优先级问题。

image

通过阅读ConsoleWindow代码，想到了一个解决思路：自己实现OnOpenAsset，通过获取ConsoleWindow中的ListView得到当前选中的row，然后在LogEntries中取得该行对应的LogEntry，其中的condition字段保存了StackTrace字符串，最后过滤掉包装的日志类后拿到脚本文件名和代码行，用OpenFileAtLineExternal直接打开。在实现过程中发现，完全没有必要拿到LogEntry，因为ConsoleWindow中的m_ActiveText就是StackTrace字符串，直接处理就好了。

在想到该方案之前，看过两个解决方法：1）将日志类编译成DLL；2）输出日志时自己记录StackFrame，通过一系列手段在OnOpenAsset查找LogEntry中对应的StackFrame。不过这两种方案都不能满足个人的完美主义情节，方案1失去了预编译宏的灵活，一旦日志系统改动需要重编DLL和处理依赖，方案2低效且过于复杂。

最后摘出代码供参考，实现环境为：Unity 4.7.5f1, UnityVS+Visual Studio 2015 Pro

 

双击unity控制台打印的日志无法定位到指定代码
qq_42898629的博客
06-14 2850
unity控制台日志双击定位 打开该设置项完整路径Editor--->Project Settings-->Player--->Other Setting ...
Unity 封装Debug.Log,代码重定向行号
wakakakakakakak的博客
10-25 840
Unity 封装Debug.Log,代码重定向的解决
Cassandra 日志详解：system.log、debug.log 和 gc.log
最新发布
学亮编程手记
06-03 902
Cassandra 对日志记录提供了丰富的支持，并试图在最大限度地为操作人员提供对数据库的洞察力的同时，限制日志中的噪音。
unity, 对于Debug.Log输出的log，可以双击定位到代码
weixin_34220179的博客
08-13 969
unity, 对于Debug.Log输出的log，可以双击定位到代码
Unity里包裹Debug，且不影响Debug的重定向
一只飞鸟的自白
09-28 1971
Debug.Log, Debug.LogWarning, Debug.LogError在工程中经常需要再包裹一层，做些定制，也方便开关Log。但有一个问题时，当用一个类将Debug包裹起来后，Console里的Log双击后，跳到的是你自己写的类的实现，而不是Log的记录处。 为此纠结了一段时间，后来偶然看到一篇日志里有写这个问题。http://www.xuanyusong.com/archives
Unity自定义DebugLog工具
04-15
代替自带的debug 类 该工具已经扩展到object 类下 在其他只要继承这个类下面都可以使用this.Log();
Debugger_UNITY用LOG系统_源码
10-02
可对系统日志分类，在PC端请用“`”键呼出关闭日志系统，在移动端请三个手指同时按屏幕呼出关闭日志系统。统一开关日志开关，可出包时一键屏弊日志
Unity Debug的简单封装
weixin_44238530的博客
12-03 1138
Project Settings-Player-Other Settings-Script Define Symbols添加 EnableLog，点击Apply。日志拦截器, 实现Unity中Console窗口双击跳转到合理的位置。对Unity Debug的简单封装。
Unity3D重新封装Debug实现自主控制是否开启Debug输出
04-11
3. 封装Unity的Debug方法，如`Debug.Log`，在新的方法中添加条件判断，只有当`IsDebugEnabled`为true时，才调用原生的Debug方法输出信息。 4. 提供设置`IsDebugEnabled`状态的接口，允许在运行时动态切换调试开关。 ...
Unity Debug.Log 性能分析
Lee的博客
08-03 7528
1.介绍 介绍Debug.Log , 主要是因为发现有些同学，对这个并不是很在意，可能以为只是打印到Unity控制台。当你发Release版本的时候，Unity并不会自动帮你禁用Debug.Log，Debug.Log会产生GC，非常影响性能(开启Unity Deep Profiler可以查看性能分析)。 Unity5.3提供手动关闭Debug功能 if (Debug.isDebugBuild...
Unity自定义封装Debug类
12-02
自定义调试类，更加便捷的使发布后的程序，直接在主界面观看所自行输出的Log；右下角可一键清理输出内容，也可一键 开启/关闭 log滚动查看。开启可通过修改 常量：...解决了以往自行封装Log双击定位不准确问题。
Unity 在安卓IOS等移动设备环境下的log查看解决方案
12-24
用于Unity打包移动设备的调试，能够简单快速的查看报错等信息 Unity 在安卓IOS等移动设备环境下的log查看解决方案
Unity Debug.Log 扩展
08-09
扩展Debug.Log()以便随时关掉输出Log信息,同时加入数组和列表的输出,并支持输出不同格式的字体
【Unity3D游戏开发】之定制Debug.log输出 (八)
热门推荐
Teng's world
07-27 2万+
环境:Unity开发时会有很多的Debug.log输出测试 问题:最后游戏发布的时候，不希望在Produce发布环境也输出大量的日志，官方目前也没有正统的做法。 解决方法1: 重新封装 将Debug.log重新封装，自己添加开关。 using UnityEngine; using System.Collections; public class Debuger { st
Unity ConsoleLog双击重定向
a977621265的博客
12-22 1254
在一个标准的开发流程中，unity原生的Log可能无法满足所有需求 于是我们需要定制自己的Log类 比如一个打印不同颜色信息的简单需求： publicclassLog { publicvoidDebug(stringformat,paramsobject[]args) { UnityEngine.Debug.Log(string.Fo...
【转载】Unity编辑器扩展-ConsoleWindow中的双击日志定位
qq_16440237的博客
07-24 905
很多项目都有自己重写Debug.Log的习惯，难免会遇到在Unity的Console窗口中双击日志，但是没法直接跳转到想要看到的代码那一行的时候，解决办法有以下2种： 1、将自己封装的日志类制作成DLL再导入到Unity使用，但是有时候想修改日志类的代码却比较麻烦了～～ 2、使用本文提供的LogEdi...
Unity Mac下编译工具以及调试安卓输出Debug日志
博客
11-28 795
《安装编译工具Mac下》 1.下载Xcode最新版 2.终端输入：sh-keygen一直回车 生成密钥注册机  接着输入：pbcopy 。 3.获取HomeBrew，命令下载工具 终端输入：/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/ma
[总结]Unity Console面板的问题汇总
⭐
01-26 2776
unity console debug log
Unity C#调试技巧：高效定位与解决问题
欢迎来到《技术探索》，这是一个专注于游戏开发技术的博客。在这里，我们将深入探讨游戏引擎、图形渲染、人工智能、物理模拟等领域的最新技术和最佳实践。无论您是初学者还是经验丰富的开发者，我们都希望为您提供有价值的见解和实用的技巧。
01-23 151
友情提示，本文中关于U3D中C#代码调试原理的内容仅占两节的篇幅，其余部分将重点介绍在Unity日常开发过程中使用到的各种调试技巧和方法。如果您只对调试原理感兴趣，可以直接跳到“Windows C#客户端与Unity C#程序调试区别”以及“Mono Runtime 调试框架”这两小节。此外，本文仅讨论在Unity Windows Editor中的调试，且所指的调试为源码级调试，不涉及IL2CPP相关的知识点。
项目里面多出来debug.log文件
04-03
### 项目中出现 `debug.log` 文件的原因 在软件开发过程中，尤其是涉及 Node.js 或 Unity 的环境中，`debug.log` 文件通常是由调试工具或框架自动生成的日志文件。以下是具体原因： 1. **Node.js 环境下** 在某些情况下，Node.js 及其相关模块可能会生成日志文件用于记录运行时错误或其他信息。例如，当安装依赖项失败或者缓存出现问题时，Node.js 会在指定路径下生成类似的日志文件[^1]。 2. **Unity 开发环境** 在 Unity 中，默认的 `Debug.Log()` 方法会将消息输出到控制台，并可能写入本地磁盘上的日志文件（如 `Player.log`）。如果未正确配置日志管理机制，则可能导致不必要的日志堆积[^3]。 3. **操作系统层面的影响** Windows 10 用户有时也会遇到随机生成的 `debug.log` 文件问题。这可能是由于 Chromium 浏览器引擎中的 Bug 所致，该问题会影响基于 Chromium 构建的应用程序（如 Chrome 和 Edge），从而在其工作目录中留下多余的日志文件[^5]。 --- ### 如何处理 `debug.log` 文件 针对不同场景下的解决方案如下： #### 对于 Node.js 项目 可以按照以下步骤清理并预防此类问题的发生： - 删除报错信息中提到的具体日志文件位置：`C:\Program Files\nodejs\node_cache_logs\**\**-debug.log`。 - 移除项目根目录下的 `node_modules` 文件夹以重新构建干净的依赖关系。 - 同时删除 `package-lock.json` 文件以便更新锁定版本号至最新状态。 #### 关闭 Unity 运行时日志功能 为了优化性能和保护隐私数据安全，在正式发布前应禁用所有的打印语句操作。可以通过以下方式实现这一目标： - 封装原始 API 调用逻辑，仅保留特定条件下的有效行为；比如定义全局开关变量来判断当前所处模式是否允许显示提示信息[^4]。 ```csharp public static class CustomLogger { private const bool IsLoggingEnabled = false; public static void Log(string message){ if(IsLoggingEnabled){ UnityEngine.Debug.Log(message); } } public static void LogWarning(string warningMessage){ if(IsLoggingEnabled){ UnityEngine.Debug.LogWarning(warningMessage); } } public static void LogError(string errorMessage){ if(IsLoggingEnabled || true /* Always show errors */ ){ UnityEngine.Debug.LogError(errorMessage); } } } ``` #### 处理 Win10 桌面上无故产生的 debug 日志现象 如果是因第三方应用引起的干扰情况，则需定位确切源头再采取针对性措施。一般建议尝试升级对应客户端版本修复已知漏洞或是调整权限设置阻止非法访问活动发生。 --- ### 总结 通过上述分析可以看出，无论是前端还是后端领域都存在类似需求即合理管控各类冗余记录以免造成资源浪费甚至安全隐患风险增加等问题。因此有必要建立完善的管理制度规范日常作业流程减少意外状况发生的可能性。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值