AvaloniaConsole 1.1.0

AvaloniaConsole

一个高性能、易用的 Avalonia 控制台组件,支持大量数据展示、文本选择、自动滚动等功能。

✨ 特性

• 🚀 高性能虚拟化渲染 - 只绘制可见区域,可轻松处理数百万行日志
• 💾 内存高效 - 优化的数据存储,低内存占用
• 🖱️ 完整的鼠标交互
  • 文本选择和复制 (支持多行连续选择)
  • 自定义滚动条 (拖动、点击跳转)
  • 鼠标滚轮滚动
• 📜 自动滚动到底部 - 新内容自动滚动,手动滚动时暂停
• 🎨 完全可定制 - 支持自定义字体、颜色、背景
• 🧵 线程安全 - 支持从任意线程添加日志
• 📦 易于集成 - 简单的 API,MVVM 友好
• 🔄 多实例支持 - 可在同一应用中使用多个控制台组件

🎯 使用场景

• IDE 输出窗口
• 应用程序日志查看器
• 实时监控面板
• 调试信息展示
• 命令行模拟器
• 构建输出显示

📦 安装

NuGet Package Manager

Install-Package AvaloniaConsole

.NET CLI

dotnet add package AvaloniaConsole

PackageReference

<PackageReference Include="AvaloniaConsole" Version="1.0.0" />

🚀 快速开始

1. 在 XAML 中添加控件

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:ac="clr-namespace:AvaloniaConsole;assembly=AvaloniaConsole">
    
    <ac:ConsoleControl Buffer="{Binding ConsoleBuffer}" 
                       FontFamily="Cascadia Code, Consolas, Monospace" 
                       FontSize="14"
                       Background="#1E1E1E"
                       Foreground="#D4D4D4"/>
</Window>

2. 在 ViewModel 中使用

using AvaloniaConsole;

public class MainViewModel : ViewModelBase
{
    public ConsoleBuffer ConsoleBuffer { get; } = new ConsoleBuffer();

    public void AddLog()
    {
        ConsoleBuffer.AddLine($"日志信息 {DateTime.Now}");
    }

    public async Task RunProcess()
    {
        await Task.Run(() =>
        {
            for (int i = 0; i < 10000; i++)
            {
                ConsoleBuffer.AddLine($"处理进度: {i}/10000");
            }
        });
    }
}

3. 基本操作

// 添加单行
ConsoleBuffer.AddLine("Hello World");

// 添加多行
ConsoleBuffer.AddLines(new[] { "Line 1", "Line 2", "Line 3" });

// 清空内容
ConsoleBuffer.Clear();

// 获取行数
int count = ConsoleBuffer.Count;

// 访问特定行
string line = ConsoleBuffer[0];

📖 API 文档

ConsoleControl 属性

ConsoleBuffer 方法

ConsoleBuffer 事件

🎨 样式示例

暗色主题 (VS Code 风格)

<ac:ConsoleControl Background="#1E1E1E"
                   Foreground="#D4D4D4"
                   FontFamily="Cascadia Code, Consolas, Monospace"
                   FontSize="14"/>

亮色主题

<ac:ConsoleControl Background="White"
                   Foreground="Black"
                   FontFamily="Consolas, Courier New, monospace"
                   FontSize="12"/>

自定义颜色

<ac:ConsoleControl Background="#282C34"
                   Foreground="#ABB2BF"
                   FontFamily="JetBrains Mono, monospace"
                   FontSize="13"/>

⌨️ 键盘快捷键

• Ctrl+C - 复制选中的文本到剪贴板

🖱️ 鼠标操作

• 滚轮 - 向上/向下滚动内容
• 拖动选择 - 按住左键拖动选择文本
• 滚动条拖动 - 拖动滚动条快速定位
• 点击滚动条轨道 - 快速跳转到对应位置

🔧 高级用法

在后台线程添加日志

// 从任意线程安全地添加日志
await Task.Run(() =>
{
    for (int i = 0; i < 100000; i++)
    {
        ConsoleBuffer.AddLine($"后台任务 {i}");
        
        if (i % 1000 == 0)
            Thread.Sleep(10); // 模拟耗时操作
    }
});

多个控制台实例

<Grid RowDefinitions="*, *">
    
    <ac:ConsoleControl Grid.Row="0"
                       Buffer="{Binding MainConsole}"
                       Background="#1E1E1E"
                       Foreground="LightGray"/>
    
    
    <ac:ConsoleControl Grid.Row="1"
                       Buffer="{Binding ErrorConsole}"
                       Background="#2D1E1E"
                       Foreground="#FF6B6B"/>
</Grid>

监听新内容事件

ConsoleBuffer.LinesAdded += (sender, e) =>
{
    Console.WriteLine("新内容已添加!");
};

🎯 完整示例

查看 Demo 项目 获取完整的示例代码。

运行示例:

cd src/AvaloniaConsole.Demo
dotnet run

🔍 性能

• ✅ 轻松处理 100 万行+ 日志
• ✅ 虚拟化渲染,只绘制可见行
• ✅ 内存占用随实际内容线性增长
• ✅ 流畅的 60 FPS 滚动体验
• ✅ 无 UI 线程阻塞

🛠️ 技术细节

架构设计

• 数据层: ConsoleBuffer - 线程安全的数据存储
• UI 层: ConsoleControl - 自定义控件,虚拟化渲染
• 滚动: 自定义实现,避免 Avalonia 滚动系统的性能问题
• 选择: 基于坐标的文本选择,支持跨行

性能优化

1. 只渲染可见区域内的文本行
2. 使用 ReaderWriterLockSlim 保证线程安全
3. 字符尺寸预计算,避免重复测量
4. 自定义滚动条,避免递归更新

🤝 贡献

欢迎提交 Issue 和 Pull Request!

📄 许可证

本项目采用 MIT 许可证。

🙏 致谢

灵感来源于 AvalonStudio 的控制台实现。

📮 联系方式

如有问题或建议,请提交 GitHub Issue。

Made with ❤️ for Avalonia Community