GeWuYou 23489570bf fix(analyzers): 降低 Core、Cqrs、Godot 与生成器的构建警告
- 清理 GFramework.Core 与 GFramework.Cqrs 中的大量低风险 Meziantou 警告

- 修复 GFramework.Godot 运行时中的 ConfigureAwait、StringComparison 与参数校验告警

- 调整 Core SourceGenerators 中的字符串比较、文件命名与局部长方法问题

- 拆分部分配置与缓存辅助类型文件以消除 file/type mismatch 告警

- 更新 warning reduction 跟踪与执行记录,保留下一批结构性告警的恢复点
2026-04-18 16:47:44 +08:00

76 lines
2.6 KiB
C#

using System.Globalization;
using GFramework.Core.Abstractions.Logging;
using GFramework.Core.Logging;
using Godot;
namespace GFramework.Godot.Logging;
/// <summary>
/// Godot平台的日志记录器实现。
/// 该类继承自 <see cref="AbstractLogger"/>,用于在 Godot 引擎中输出日志信息。
/// 支持不同日志级别的输出,并根据级别调用 Godot 的相应方法。
/// </summary>
/// <param name="name">日志记录器的名称,默认为根日志记录器名称。</param>
/// <param name="minLevel">最低日志级别,默认为 <see cref="LogLevel.Info"/>。</param>
public sealed class GodotLogger(
string? name = null,
LogLevel minLevel = LogLevel.Info) : AbstractLogger(name ?? RootLoggerName, minLevel)
{
// 静态缓存日志级别字符串,避免重复格式化
private static readonly string[] LevelStrings =
[
"TRACE ",
"DEBUG ",
"INFO ",
"WARNING",
"ERROR ",
"FATAL "
];
/// <summary>
/// 写入日志的核心方法。
/// 格式化日志消息并根据日志级别调用 Godot 的输出方法。
/// </summary>
/// <param name="level">日志级别。</param>
/// <param name="message">日志消息内容。</param>
/// <param name="exception">可选的异常信息。</param>
protected override void Write(LogLevel level, string message, Exception? exception)
{
// 构造时间戳和日志前缀
var timestamp = DateTime.UtcNow.ToString("yyyy-MM-dd HH:mm:ss.fff", CultureInfo.InvariantCulture);
var levelStr = LevelStrings[(int)level];
var logPrefix = $"[{timestamp}] {levelStr} [{Name()}]";
// 添加异常信息到日志消息中
if (exception != null) message += "\n" + exception;
var logMessage = $"{logPrefix} {message}";
// 根据日志级别选择 Godot 输出方法
switch (level)
{
case LogLevel.Fatal:
GD.PushError(logMessage);
break;
case LogLevel.Error:
GD.PrintErr(logMessage);
break;
case LogLevel.Warning:
GD.PushWarning(logMessage);
break;
case LogLevel.Trace:
GD.PrintRich($"[color=gray]{logMessage}[/color]");
break;
case LogLevel.Debug:
GD.PrintRich($"[color=cyan]{logMessage}[/color]");
break;
case LogLevel.Info:
GD.Print(logMessage);
break;
default:
GD.Print(logMessage);
break;
}
}
}