基于OpenCV-WxWidgets的软件中文文件名处理问题

核心问题出在Windows平台的编码差异：wxString内部存储的是UTF-16编码的字符串，而OpenCV的imread在Windows下默认使用本地编码（如GBK）解析std::string类型的文件名，直接转UTF-8会导致编码不匹配，出现乱码或读取失败。

有效解决方案 #

方案1：直接使用宽字符路径调用OpenCV（推荐） #

OpenCV 3.0及以上版本支持宽字符路径的imread重载，直接从wxString获取宽字符指针即可，无需编码转换：

bool AssetFileDropFileTarget::OnDropFiles(wxCoord x, wxCoord y, const wxArrayString &filenames)
{
    const wxString& wxFilename = filenames[0];
    // 获取wxString的宽字符指针（UTF-16）
    const wchar_t* widePath = wxFilename.wc_str();
    // 用宽字符版本的imread读取
    const cv::Mat image = cv::imread(cv::String(widePath), cv::IMREAD_UNCHANGED);

    /* 对image进行操作...*/

    return true;
}

方案2：转换为Windows本地编码的std::string #

如果你的OpenCV版本不支持宽字符路径，可以将wxString转换为Windows本地编码（如GBK）的std::string，匹配imread的预期：

bool AssetFileDropFileTarget::OnDropFiles(wxCoord x, wxCoord y, const wxArrayString &filenames)
{
    const wxString& wxFilename = filenames[0];
    // 使用wxMBConvLocal()转换为本地编码的std::string
    const std::string stdFilename = wxFilename.ToStdString(wxMBConvLocal());
    const cv::Mat image = cv::imread(stdFilename, cv::IMREAD_UNCHANGED);

    /* 对image进行操作...*/

    return true;
}

为什么之前的方法无效？ #

• 设置C.UTF-8区域：Windows平台原生不支持C.UTF-8 locale，导致编码转换失败。
• 使用wxMBConvUTF8()转换：转出来的是UTF-8编码字符串，但Windows下imread无法识别UTF-8格式的文件名，因此出现乱码。

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