C# WinForm自定义调试控制台中RichTextBox换行失效问题

我之前做WinForm调试控制台的时候也踩过这个换行的坑，结合你给出的ConsoleEx类代码片段，问题大概率出在这几个地方，给你一步步排查和解决的方案：

1. 确保手动插入换行符 #

你设置了WordWrap = false，意味着RichTextBox不会自动换行，必须手动插入换行标记才能让文本换行。如果你的Write方法只是单纯追加文本，没有在合适的位置添加换行符，多次调用后文本就会挤在一行。

你可以新增一个WriteLine方法（或者修改现有Write方法），在每次输出末尾添加Environment.NewLine（兼容不同系统的换行符）：

public static class ConsoleEx
{
    private static RichTextBox outTarget;

    public static void Initialize(RichTextBox target)
    {
        outTarget = target;
        // 顺便在这里初始化控件的关键属性，避免遗漏
        target.Multiline = true;
        target.AcceptsReturn = true;
        target.WordWrap = false;
    }

    public static void Write(string source, string message)
    {
        Write(source, Color.LightSkyBlue, message);
    }

    // 新增带换行的WriteLine方法
    public static void WriteLine(string source, string message)
    {
        Write(source, Color.LightSkyBlue, message + Environment.NewLine);
    }

    public static void Write(string source, Color color, string message)
    {
        // 先处理线程安全，WinForm控件必须在UI线程操作
        if (outTarget.InvokeRequired)
        {
            outTarget.Invoke(new Action<string, Color, string>(Write), source, color, message);
            return;
        }

        outTarget.SelectionStart = outTarget.TextLength;
        outTarget.SelectionColor = color;
        // 这里给source加个标识，方便区分输出来源
        outTarget.AppendText($"[{source}] {message}");
    }
}

2. 检查RichTextBox的核心属性 #

除了WordWrap = false，还要确保控件的这两个属性必须为true，否则即使插入换行符也不会生效：

• Multiline = true：允许控件显示多行文本
• AcceptsReturn = true：允许控件识别换行符并换行

你可以在Initialize方法里直接设置这些属性，避免手动在设计器里漏改。

3. 排查线程安全问题 #

如果你的ConsoleEx.Write是在非UI线程（比如后台线程、异步任务）调用的，可能会导致文本显示异常（包括不换行、文本乱序）。上面的代码里已经加了InvokeRequired判断，确保控件操作在UI线程执行，这也是很多人容易忽略的点。

测试验证 #

调用的时候用WriteLine代替Write，或者在需要换行的地方手动添加Environment.NewLine：

// 调用示例
ConsoleEx.WriteLine("Main", "程序启动");
ConsoleEx.WriteLine("Debug", "用户点击了按钮");

这样就能实现你想要的手动控制换行的效果了。

内容的提问来源于stack exchange，提问作者Alexis Shepard