在Windows PowerShell中使用C语言结合ncurses实现UTF-8支持的问题

问题说明 #

在Termux环境中，使用ncursesw库（编译链接-lncursesw）可正常显示UTF-8字符，但在Windows系统中，即便结合SetConsoleOutputCP(CP_UTF8)或调用setlocale，ncurses仍无法正确渲染Unicode字符。

解决步骤 #

• 必须使用ncurses宽字符版本（ncursesw）
  Windows默认分发的多数ncurses是窄字符版，不支持UTF-8。需安装ncursesw库，编译时链接-lncursesw而非-lncurses。比如MinGW环境下，可通过包管理器安装mingw-w64-x86_64-ncursesw（64位）或对应32位版本。

• 在initscr()前正确设置locale
  locale初始化是ncursesw处理宽字符的前提，必须放在ncurses初始化之前：

  setlocale(LC_ALL, ".UTF-8");
  // 或自动适配系统locale：setlocale(LC_ALL, "");
  

• 同步Windows控制台编码
  在程序开头同时设置控制台的输入输出编码为UTF-8，避免编码冲突：

  SetConsoleOutputCP(CP_UTF8);
  SetConsoleCP(CP_UTF8);
  

• 使用ncurses宽字符API
  替换窄字符函数为宽字符版本，直接传入Unicode宽字符常量，避免字节序列转换问题：

  mvaddwstr(1, 0, L"\u2713"); // 对勾符号
  mvaddwstr(2, 0, L"\u25cb"); // 空心圆
  mvaddwstr(3, 0, L"\u25cf"); // 实心圆
  mvaddwstr(4, 0, L"\u25af"); // 竖矩形
  

完整示例代码 #

#include <stdio.h>
#include <wchar.h>
#include <ncurses.h>
#include <Windows.h>

int main(int argc, char **argv)
{
    // 设置控制台UTF-8编码
    SetConsoleOutputCP(CP_UTF8);
    SetConsoleCP(CP_UTF8);

    // 初始化locale，必须在initscr之前执行
    setlocale(LC_ALL, ".UTF-8");

    // 初始化ncurses环境
    initscr();
    cbreak();
    noecho();

    // 用宽字符函数显示Unicode符号
    mvaddwstr(1, 0, L"\u2713 任务完成");
    mvaddwstr(2, 0, L"\u25cb 待启动");
    mvaddwstr(3, 0, L"\u25cf 正在进行");
    mvaddwstr(4, 0, L"\u25af 已暂停");

    refresh();
    getch();
    endwin();

    return 0;
}

额外注意事项 #

• 控制台字体：确保Windows控制台使用支持UTF-8的字体（如Cascadia Code、Consolas、Segoe UI Symbol），否则Unicode字符会显示为方块，可通过控制台属性→字体选项修改。
• 编译命令：以MinGW为例，编译指令为：gcc your_code.c -o your_program.exe -lncursesw

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