C# Trace实践AOT、跨平台

public static class Tracer
{
    //...
    
    static GeneralTracer()
    {
        Trace.Listeners.Clear();

        //将调试记录转发到Dbgview.exe工具中查看，由于目前没发现官方有Linux版本的Dbgview.exe所以只实现了windows的。
        //如果在Linux操作系统下可通过文本记录的方式查看。
        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
        {
            Trace.Listeners.Add(new WindowsOutputDebugListener());
        }

        //调试记录转发到控制台中查看，例如：IDE的控制台
        Trace.Listeners.Add(new TextWriterTraceListener(Console.Out) { Name = "ConsoleListener" });
        
        //调试记录转发到本地文本文件中记录，由于原生的TextWriteTraceListener写入文件容易出现进程占用，所以手写了一个带队列的写入文件实现。
        InitializeFileListener();

        if (Debugger.IsAttached)
            Trace.Listeners.Add(new DefaultTraceListener());

        Trace.AutoFlush = true;
        _isTracingEnabled = true;
    }
    
    private static void InitializeFileListener()
    {
        var today = DateTime.Now.ToString("yyyy-MM-dd");
        if (today == _currentLogDate && _fileListener != null)
            return;

        var logDir = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Logs");
        Directory.CreateDirectory(logDir);

        var logFileName = Path.Combine(logDir, $"generalupdate-trace {today}.log");
        _fileListener = new TextTraceListener(logFileName);
            
        Trace.Listeners.Add(_fileListener);
        _currentLogDate = today;
    }

    //...

    public static void Info(string message) => WriteTraceMessage(TraceLevel.Info, message);

    public static void Error(string message) => WriteTraceMessage(TraceLevel.Error, message);

    private static void WriteTraceMessage(TraceLevel level, string message)
    {
        if(!IsTracingEnabled())
            return;
        
        InitializeFileListener();
        var timestamp = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff");
        var levelName = GetLevelName(level);
        var fullMessage = string.Empty;

        try
        {
            //这里尝试使用#if !NATIVEAOT或者RuntimeInfomation的做法在代码内判断当前是否AOT编译，这两种方式通常无效，这里为了简单在AOT下通过try的             //方式兼容简化输出。
            
            //在AOT下该方法不可使用，因为StackFrame 的工作机制依赖于程序运行时的动态调试信息和调用栈结构，而 AOT 编译的核心是通过静态优化生成高效、             //精简的机器码，必然会剥离动态信息并改变原始调用栈结构。这种本质冲突导致 StackFrame 在 AOT 环境下通常无法正常使用。
            var stackFrame = new StackFrame(2, true);
            var method = stackFrame.GetMethod();
            var className = method.DeclaringType?.Name ?? "UnknownType";
            var methodName = method.Name;
            var lineNumber = stackFrame.GetFileLineNumber();
            var lineInfo = lineNumber > 0 ? $"Line {lineNumber}" : "Line N/A (Line numbers may not be displayed in Release mode)";
            fullMessage = $"[{timestamp}] [{levelName}] {className}.{methodName} ({lineInfo}): {message}";
        }
        catch
        {
            //为了兼容AOT,在此简化了输出
            fullMessage = $"[{timestamp}] [{levelName}] : {message}";
        }

        Trace.WriteLine(fullMessage);
    }
    
    //...
}