如何通过Windows WinAPI输出可重定向的UTF-16控制台Unicode文本

你遇到的空格、BOM无效、重定向后显示正常的现象，本质是Windows控制台和重定向流的编码处理逻辑不一致导致的：

• WriteConsoleW是专门面向控制台缓冲区的API，原生支持UTF-16输出，但它只能工作在输出目标是真实控制台的场景，一旦输出被重定向到文件/管道，调用会直接失败，这也是你觉得它不支持重定向的原因。
• WriteFile是面向字节流的通用API，它不关心你写入的内容是什么编码，只是原样把字节写到目标句柄。当输出目标是控制台时，控制台默认使用单字节代码页（比如简体中文系统默认是GBK代码页936，英文系统是CP437）解析收到的字节流：你的UTF-16LE文本里每个ASCII字符占2字节，低字节是字符本身，高字节是0x00，单字节解析时0x00会被显示为空格，就出现了字符之间夹空格的问题。
• 提前写入BOM无效的原因是：BOM是给静态文件做编码识别用的标记，控制台的实时输出流不会主动检测BOM来切换编码，你写入的0xFF 0xFE会被当成普通单字节字符解析，0xFF在单字节代码页里就是不可识别的白色方块。
• 重定向到管道/文件后显示正常，是因为接收字节流的下游程序（比如PowerShell的管道处理器、文本编辑器）会自动识别UTF-16LE编码，不会按单字节拆分解析，自然不会出现空格。

另外你现有代码还有个隐藏问题：len equ $-string计算的是字符串的字节数，而WriteConsoleW的第三个参数要求传入字符数，你直接传len会让API读取越界的内存，属于未定义行为。

推荐使用官方标准的兼容写法，根据输出句柄的类型自动选择输出API，兼顾控制台显示和重定向需求：

• 如果返回FILE_TYPE_CHAR（值为1），说明输出目标是真实控制台，调用WriteConsoleW输出UTF-16文本，原生支持Unicode无乱码
• 如果返回其他值（文件、管道等重定向场景），调用WriteFile直接写入UTF-16LE字节流，如果目标是文件可以选择前置写入UTF-16LE的BOM（0xFF 0xFE）方便编辑器识别编码，如果是管道场景不要写BOM，避免下游程序读到多余字符。

修正后的64位MASM代码 #

extern GetStdHandle: proc
extern GetFileType: proc
extern WriteConsoleW: proc
extern WriteFile: proc
extern ExitProcess: proc

.data?
    written dq ?
    hStdOut dq ?
.data
    ; UTF-16LE 字符串 "Hello World!"
    string dw 0048h,0065h,006ch,006ch,006fh,0020h,0057h,006fh,0072h,006ch,0064h,0021h
    len_bytes equ $-string       ; 字符串字节长度，给WriteFile用
    len_chars equ len_bytes / 2  ; 字符串字符长度，给WriteConsoleW用
    bom dw 0FEFFh                ; UTF-16LE BOM
    bom_len equ $-bom

.code
main proc
    push    rbp
    mov     rbp, rsp
    sub     rsp, 28h            ; 64位调用约定预留32字节shadow space + 8字节栈对齐
    and     rsp, -10h

    ; 获取标准输出句柄
    mov     rcx, -11            ; STD_OUTPUT_HANDLE
    call    GetStdHandle
    mov     hStdOut, rax

    ; 判断句柄类型
    mov     rcx, rax
    call    GetFileType
    cmp     rax, 1              ; 判断是否为FILE_TYPE_CHAR（控制台）
    je      write_console

write_redirect:
    ; 重定向场景：使用WriteFile，管道场景可删除下方写BOM的逻辑
    mov     rcx, hStdOut
    mov     rdx, offset bom
    mov     r8, bom_len
    mov     r9, written
    mov     qword ptr [rsp+32], 0 ; lpOverlapped传NULL
    call    WriteFile

    ; 写入正文内容
    mov     rcx, hStdOut
    mov     rdx, offset string
    mov     r8, len_bytes
    mov     r9, written
    mov     qword ptr [rsp+32], 0
    call    WriteFile
    jmp     exit_proc

write_console:
    ; 控制台场景：使用WriteConsoleW
    mov     rcx, hStdOut
    mov     rdx, offset string
    mov     r8, len_chars
    mov     r9, written
    mov     qword ptr [rsp+32], 0 ; lpReserved传NULL
    call    WriteConsoleW

exit_proc:
    xor     rcx, rcx
    call    ExitProcess
main endp
end

不推荐的替代方案 #

你也可以在输出前调用SetConsoleOutputCP将控制台输出代码页设置为1200（即UTF-16LE），之后直接用WriteFile写入UTF-16内容控制台也能正确解析，但这个方案有明显缺陷：

• 会全局修改当前控制台窗口的输出编码，程序退出后如果不恢复会影响后续其他命令的正常显示
• 重定向场景下该设置不生效，依然需要单独处理
• 部分旧版本Windows对控制台UTF-16输出模式存在兼容bug

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