👁 Image
CodeWF.Log.Core 12.0.4.2

CodeWF.Log

👁 NuGet
👁 NuGet
👁 NuGet
👁 NuGet

轻量级、高性能 .NET 日志库，支持控制台和 Avalonia UI 应用程序。

仓库规范

• 当前版本：12.0.4.2，版本号统一维护在根目录 Directory.Build.props 的 <Version> 节点。
• NuGet 包项目统一支持 net8.0;net10.0；Demo、App、测试与内部应用项目统一使用 net11.0 / net11.0-windows。
• 根目录 logo.svg、logo.png、logo.ico 是唯一图标源，子工程只通过 MSBuild Link 引用，不维护图标副本。
• 运行时帮助、Markdown 示例、内置备忘录、设计说明等业务文档按功能保留；仓库级入口文档使用根目录 README.md 和 UpdateLog.md。

两个 NuGet 包

脚本

• pack.bat：还原、构建并打包 CodeWF.Log.Core 与 CodeWF.LogViewer.Avalonia 到 artifacts\packages。

CodeWF.Log.Core

核心日志库，NuGet 包安装：

Install-Package CodeWF.Log.Core

基本使用

Logger.Debug("调试日志");
Logger.Info("普通日志");
Logger.Warn("警告日志");
Logger.Error("错误日志");
Logger.Fatal("严重错误日志");

控制台程序初始化（重要）

控制台程序使用文件日志时，需要在启动时初始化：

// Program.cs 或 Main 方法中调用一次
Logger.RecordToFile();

// 程序退出时刷新缓冲区
await Logger.FlushAsync();

日志输出目标控制

每个日志方法支持参数控制输出目标：

Logger.Info(
 content: "写入文件的内容",
 uiContent: "UI显示的友好内容", // 可选，默认为null，此时UI显示content参数的内容
 log2UI: true, // 是否输出到UI
 log2File: true, // 是否输出到文件
 log2Console: true // 是否输出到控制台
);

// 快捷方法
Logger.InfoToFile("仅写入文件"); // log2UI=false, log2Console=false
Logger.LogToUI(LogType.Info, "仅显示UI"); // log2File=false

配置参数

Logger.Level = LogType.Info; // 日志级别，低于此级别的日志被忽略
Logger.LogDir = "/path/to/logs"; // 日志文件存储目录
Logger.BatchProcessSize = 200; // 批量写入的日志条数阈值
Logger.MaxLogFileSizeMB = 500; // 单个日志文件最大大小（MB）
Logger.EnableConsoleOutput = true; // 是否输出到控制台

CodeWF.LogViewer.Avalonia

Avalonia UI 日志展示控件，NuGet 包安装：

Install-Package CodeWF.LogViewer.Avalonia

XAML 使用

xmlns:log="https://codewf.com"

<log:LogView />

Avalonia 程序初始化

// 程序退出时调用
await Logger.FlushAsync();

注意：LogView 控件内部会自动调用 RecordToFile() 启动文件日志记录，并从 UI 通道消费日志显示到界面。

日志消费

LogView 内部使用 await foreach 异步枚举模式消费 UI 通道日志，支持批量处理和防抖机制：

• 日志数量达到 BatchProcessSize 时立即刷新 UI
• 未达阈值时，最长延迟 LogUIDuration（默认100ms）后刷新

更新日志

V1.0.12（2026-04）

1. ✨[优化]-重构为 Channel 架构，提升性能
2. ✨[优化]-添加防抖机制，避免日志频繁刷新
3. ✨[优化]-UI消费使用 await foreach 异步枚举模式
4. 🐛[修复]-修复 FlushAsync 方法

V1.0.11.3（2025-09-15）

1. 🐛[修复]-修复自定义日志目录打开异常问题

TODO

第三方开源组件审计（2026-05-20）

检查方式：NuGet 元数据、恢复后的 project.assets.json、NuGet.org 与源码仓库信息。优先接受 MIT / Apache-2.0 / BSD。

传递依赖检查结论：Avalonia/SkiaSharp/ANGLE 链均有公开源码，许可证为 MIT 或 BSD-style。未发现 Semi.Avalonia.Dock、Semi.Avalonia.ProDataGrid、Semi.Avalonia.AvaloniaEdit 或其它黑盒主题包。