Kernel32中WriteConsoleOutput()无法显示文本问题求助

嘿，刚看了你写的QuickDraw工具库遇到的WriteConsoleOutput()没输出问题，我帮你梳理几个大概率踩坑的点，还有修正后的参考代码：

1. 控制台句柄路径写错了 #

你代码里写的"$CONOUT"是错误的，Windows控制台输出设备的标准路径是"CONOUT$"（$符号在末尾），路径写错会导致CreateFile返回无效句柄，后续WriteConsoleOutput自然无法工作。

2. 句柄重复创建且未管理 #

你把Handle做成了只读属性，每次访问都会调用CreateFile，这会创建多个未释放的句柄，不仅资源泄漏，还会导致后续调用使用无效句柄。应该在静态构造函数中一次性创建并缓存句柄。

3. WriteConsoleOutput参数完整性缺失 #

你没贴完整的调用代码，但要确保传递的CHAR_INFO数组、缓冲区大小、起始位置、写入区域这几个核心参数都正确匹配，比如字符数组要填充正确的Unicode字符和属性，写入区域不能超出控制台窗口范围。

using System;
using System.IO;
using System.Runtime.InteropServices;
using Microsoft.Win32.SafeHandles;

public static class QuickDraw
{
    private static readonly SafeFileHandle _consoleHandle;
    private static readonly short _windowWidth;
    private static readonly short _windowHeight;

    static QuickDraw()
    {
        // 正确的控制台输出设备路径：CONOUT$
        _consoleHandle = Kernel32.CreateFile(
            "CONOUT$",
            0x40000000, // GENERIC_WRITE 权限
            2, // FILE_SHARE_WRITE 共享模式
            IntPtr.Zero,
            FileMode.Open,
            0,
            IntPtr.Zero);

        // 检查句柄是否有效
        if (_consoleHandle.IsInvalid)
        {
            throw new InvalidOperationException($"获取控制台句柄失败，错误码：{Marshal.GetLastWin32Error()}");
        }

        _windowWidth = (short)Console.WindowWidth;
        _windowHeight = (short)Console.WindowHeight;
    }

    public static void DrawText(string text, int x, int y)
    {
        if (x < 0 || x + text.Length > _windowWidth || y < 0 || y >= _windowHeight)
        {
            throw new ArgumentOutOfRangeException("写入位置超出控制台窗口范围");
        }

        // 准备字符缓冲区
        var charBuffer = new CHAR_INFO[text.Length];
        for (int i = 0; i < text.Length; i++)
        {
            charBuffer[i].UnicodeChar = text[i];
            charBuffer[i].Attributes = 0x07; // 默认黑底白字属性
        }

        var bufferSize = new COORD { X = (short)text.Length, Y = 1 };
        var bufferPos = new COORD { X = 0, Y = 0 };
        var writeArea = new SMALL_RECT
        {
            Left = (short)x,
            Top = (short)y,
            Right = (short)(x + text.Length - 1),
            Bottom = (short)y
        };

        // 调用WriteConsoleOutput
        bool success = Kernel32.WriteConsoleOutput(
            _consoleHandle,
            charBuffer,
            bufferSize,
            bufferPos,
            ref writeArea);

        if (!success)
        {
            throw new InvalidOperationException($"WriteConsoleOutput调用失败，错误码：{Marshal.GetLastWin32Error()}");
        }
    }

    // P/Invoke 定义
    private static class Kernel32
    {
        [DllImport("kernel32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
        public static extern SafeFileHandle CreateFile(
            string lpFileName,
            uint dwDesiredAccess,
            uint dwShareMode,
            IntPtr lpSecurityAttributes,
            FileMode dwCreationDisposition,
            uint dwFlagsAndAttributes,
            IntPtr hTemplateFile);

        [DllImport("kernel32.dll", SetLastError = true)]
        public static extern bool WriteConsoleOutput(
            SafeFileHandle hConsoleOutput,
            CHAR_INFO[] lpBuffer,
            COORD dwBufferSize,
            COORD dwBufferCoord,
            ref SMALL_RECT lpWriteRegion);
    }

    // 所需结构体定义
    [StructLayout(LayoutKind.Sequential)]
    private struct CHAR_INFO
    {
        public char UnicodeChar;
        public ushort Attributes;
    }

    [StructLayout(LayoutKind.Sequential)]
    private struct COORD
    {
        public short X;
        public short Y;
    }

    [StructLayout(LayoutKind.Sequential)]
    private struct SMALL_RECT
    {
        public short Left;
        public short Top;
        public short Right;
        public short Bottom;
    }
}

• 每次调用Win32 API后，可以用Marshal.GetLastWin32Error()获取错误码，快速定位问题（比如错误码6表示句柄无效）。
• 如果控制台被重定向（比如输出到文件），CreateFile会失败，这时候可以加个判断，回退到普通的Console.WriteLine方法。
• 句柄会在程序退出时自动释放，但如果需要提前清理，可以调用_consoleHandle.Dispose()。

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