C# 日志记录方案 - 阿柒の站

一个不依赖框架、灵活的日志记录类。

优点:

不依赖其他框架，极简灵活。
分块存储，不怕单文件过大。
写日志时自动检测创建文件，不担心删除文件后写入不了。
随用随调，静态实现，任何地方直接调用就能记录日志。

Logs.cs

1
public static class Logs
2
{
3
    private static readonly ConcurrentQueue<(string Level, string Message, DateTime Time)> LogQueue = new();
4
    private static readonly CancellationTokenSource TokenSource = new();
5
    private static readonly string LogRoot = Path.Combine(AppContext.BaseDirectory, "Log"); // 存储路径，默认程序根目录下的Log文件夹下
6
    private static readonly long MaxFileSize = 5 * 1024 * 1024; // 5MB
7
    private static DateTime _lastLogTime = DateTime.MinValue;
8
    private static readonly object WriteLock = new();
9

10
    static Logs()
11
    {
12
        Task.Factory.StartNew(ProcessQueue, TaskCreationOptions.LongRunning);
13
    }
14

15
    public static void Info(string message) => Enqueue("info", message); // 详情记录
16
    public static void Error(string message) => Enqueue("error", message); // 错误记录
17
  // 可继续扩展...
18

19
    private static void Enqueue(string level, string message)
20
    {
21
        LogQueue.Enqueue((level.ToLower(), message, DateTime.Now));
22
    }
23

24
    private static async Task ProcessQueue()
25
    {
26
        while (!TokenSource.IsCancellationRequested)
27
        {
28
            while (LogQueue.TryDequeue(out var entry))
29
            {
30
                try
31
                {
32
                    WriteLog(entry.Level, entry.Message, entry.Time);
33
                }
34
                catch
35
                {
36
                    // 可扩展重试逻辑或写入到 fallback 文件
37
                }
38
            }
39
            await Task.Delay(100); // 避免空转
40
        }
41
    }
42

43
    private static void WriteLog(string level, string message, DateTime time)
44
    {
45
        var basePath = Path.Combine(LogRoot, time.ToString("yyyy_MM"));
46
        Directory.CreateDirectory(basePath);
47

48
        var filePrefix = Path.Combine(basePath, $"{time:dd}_{level}");
49
        var filePath = GetAvailableLogFile(filePrefix);
50

51
        var content = $"[{time:yyyy-MM-dd HH:mm:ss.fff}] {message}{Environment.NewLine}";
52

53
        lock (WriteLock)
54
        {
55
            File.AppendAllText(filePath, content, Encoding.UTF8);
56
        }
57

58
        _lastLogTime = time;
59
    }
60

61
    private static string GetAvailableLogFile(string basePath)
62
    {
63
        for (int i = 0; i < 1000; i++)
64
        {
65
            var filePath = i == 0 ? $"{basePath}.txt" : $"{basePath}_{i}.txt";
66
            if (!File.Exists(filePath) || new FileInfo(filePath).Length < MaxFileSize)
67
                return filePath;
68
        }
69

70
        throw new IOException("日志文件已超过最大数量限制");
71
    }
72

73
    public static void Stop()
74
    {
75
        TokenSource.Cancel();
76
    }
77
}

使用示例：

1
Logs.Info("记录详情日志");
2
Logs.Error("记录错误日志");