如何用C++在Windows控制台输出UTF-8文件名？俄文文件名显示异常

问题场景 #

在Windows 10系统中，使用MSVC 19.42编译器，通过/utf8 /std:c++20编译选项编译以下C++代码：

#include <iostream>
#include <locale>
#include <filesystem>
#include <fstream>

int main() {
   std::locale::global(std::locale("en_US.UTF-8"));
    
    std::filesystem::path p1(u8"ÄÖÜ.txt");
    std::ofstream(p1) << "ABC";
    std::cout << p1.filename() << "\n";
  
    std::filesystem::path p2(u8"файл.txt");
    std::ofstream(p2) << "ABC";
    std::cout << p2.filename() << "\n";
}

程序执行后，生成的ÄÖÜ.txt和файл.txt文件可在文件管理器中正常查看，但控制台输出里，欧文文件名显示正常，俄文文件名却变成了????.txt。

原因分析 #

1. 控制台编码不匹配：Windows默认控制台的代码页并非UTF-8（中文系统多为GBK/CP936，俄文系统为CP1251），即便代码中设置了全局locale为en_US.UTF-8，std::cout输出的UTF-8字符流也无法被控制台正确解析。
2. 字符集覆盖范围差异：ÄÖÜ这类欧文属于Latin-1（CP1252）字符集，能被Windows多数默认代码页兼容显示；而俄文西里尔字符不在这些默认代码页的字符映射范围内，因此被替换为问号。
3. 控制台字体限制：部分旧版控制台字体不支持西里尔字符，即便编码设置正确，也会因字体缺失导致字符显示异常。

解决方法 #

方法1：强制控制台使用UTF-8编码 #

在代码开头添加Windows API调用，将控制台输出代码页设置为UTF-8，同时确保控制台使用支持UTF-8的字体（如Consolas、Cascadia Code）：

#include <windows.h> // 需要包含头文件

int main() {
    SetConsoleOutputCP(CP_UTF8); // 设置控制台输出编码为UTF-8
    std::locale::global(std::locale("en_US.UTF-8"));
    
    // 后续代码不变
    std::filesystem::path p1(u8"ÄÖÜ.txt");
    std::ofstream(p1) << "ABC";
    std::cout << p1.filename() << "\n";
  
    std::filesystem::path p2(u8"файл.txt");
    std::ofstream(p2) << "ABC";
    std::cout << p2.filename() << "\n";
}

方法2：使用宽字符输出 #

改用std::wcout输出宽字符路径，配合宽字符locale设置：

#include <iostream>
#include <locale>
#include <filesystem>
#include <fstream>
#include <windows.h>

int main() {
    SetConsoleOutputCP(CP_UTF8);
    std::locale::global(std::locale("")); // 使用系统默认宽字符locale
    
    std::filesystem::path p1(u8"ÄÖÜ.txt");
    std::ofstream(p1) << "ABC";
    std::wcout << p1.filename() << L"\n";
  
    std::filesystem::path p2(u8"файл.txt");
    std::ofstream(p2) << "ABC";
    std::wcout << p2.filename() << L"\n";
}

内容的提问来源于stack exchange，提问作者Angle.Bracket