Windows 11下C++程序接收UTF-8命令行参数时argv值异常且无法输出的问题

我来帮你捋捋这个问题，Windows下的命令行参数编码确实是个容易踩坑的点，尤其是涉及UTF-8的时候，咱们一步步拆解原因和解决办法：

为什么会出现你遇到的这些情况？ #

首先得搞懂Windows命令行参数的底层逻辑：

1. main函数的argv异常：Windows默认会把命令行参数用**系统活动代码页（ACP）**转换为多字节字符串传递给main。如果你的控制台或调用环境的代码页不是UTF-8，像“う”这种非ASCII的UTF-8字符就会被当成无效字符，直接替换成问号（0x3F）——这就是你看到argv里是3f的原因。你直接打印字符串字面量“う”能成功，是因为SetConsoleOutputCP(CP_UTF8)只处理了输出编码，但命令行参数的输入编码根本没被正确处理。
2. wmain函数输出失败：wmain接收的是Windows原生的宽字符（UTF-16LE）参数，你看到的46 30其实是“う”的UTF-16编码U+3046的小端存储（0x46 0x30），这个值本身是对的！之所以wcout打不出来，是因为wcout默认会把宽字符转换为多字节字符，而转换用的locale和控制台输出编码不匹配，导致输出被截断或转成了乱码。
3. Python能正常工作：Python在Windows下已经帮你封装好了编码转换逻辑——它会直接读取系统的宽字符命令行参数，内部自动转成正确的字符串编码，所以不用你手动处理这些细节。

针对你的问题的具体解决办法 #

办法1：修复wmain的输出配置

既然wmain已经拿到了正确的UTF-16参数，咱们只需要让控制台正确输出宽字符就行，用_setmode把标准输出设置为UTF-16模式，绕过多字节转换：

#include <iostream>
#include <fcntl.h>
#include <io.h>

int wmain(int argc, wchar_t** argv) {
    // 把标准输出切换为UTF-16宽字符模式
    _setmode(_fileno(stdout), _O_U16TEXT);
    for (int i = 0; i < argc; i++) {
        std::wcout << argv[i] << std::endl;
    }
    return 0;
}

编译运行后，再传递“う”作为参数，应该就能正常输出了。

办法2：让main函数直接接收UTF-8参数（Win10 1903+ / Win11适用）

如果你更习惯用main函数，可以让程序声明自己是UTF-8感知的，这样Windows会直接以UTF-8编码传递命令行参数，不用手动转换：

1. 添加manifest文件：在项目里新建一个app.manifest文件，内容如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <activeCodePage xmlns="http://schemas.microsoft.com/SMI/2019/WindowsSettings">UTF-8</activeCodePage>
    </windowsSettings>
  </application>
</assembly>

2. 修改main函数代码：加上SetConsoleOutputCP(CP_UTF8)确保输出编码匹配：

#include <iostream>
#include <windows.h>

int main(int argc, char* argv[]) {
    SetConsoleOutputCP(CP_UTF8);
    for (int i = 0; i < argc; i++) {
        std::cout << argv[i] << std::endl;
    }
    return 0;
}

这样编译运行后，argv里就能拿到正确的UTF-8编码的“う”（0xE3 0x81 0x86），输出也正常。

办法3：手动获取宽字符命令行再转UTF-8

如果不想改manifest，也可以直接调用Windows API获取原生宽字符命令行，再手动转成UTF-8：

#include <iostream>
#include <windows.h>
#include <string>

int main() {
    // 获取完整的宽字符命令行
    wchar_t* cmdLine = GetCommandLineW();
    // 解析成参数数组
    int argc;
    wchar_t** argv = CommandLineToArgvW(cmdLine, &argc);
    
    if (argv) {
        SetConsoleOutputCP(CP_UTF8);
        for (int i = 0; i < argc; i++) {
            // 把UTF-16宽字符转成UTF-8
            int len = WideCharToMultiByte(CP_UTF8, 0, argv[i], -1, nullptr, 0, nullptr, nullptr);
            std::string utf8Arg(len, 0);
            WideCharToMultiByte(CP_UTF8, 0, argv[i], -1, &utf8Arg[0], len, nullptr, nullptr);
            std::cout << utf8Arg << std::endl;
        }
        // 释放API分配的内存
        LocalFree(argv);
    }
    
    return 0;
}

最后再补一句 #

Windows的命令行编码问题确实容易让人头大，毕竟它的底层设计就是基于UTF-16的，和Unix系的UTF-8默认逻辑不太一样。你之前的尝试其实已经摸到了门道，差的就是把输入输出的编码配置对应起来而已～

内容来源于stack exchange