VS2017下OpenCV VideoCapture读取Unicode路径的问题咨询

我来帮你搞定这个Unicode路径和命令行参数的问题，在VS2017搭配OpenCV的场景下，有几个实用的方案可以解决你的痛点：

方案1：直接使用Windows原生Unicode API获取命令行参数 #

OpenCV的CommandLineParser对Unicode字符串的支持确实不太友好，咱们可以直接绕开它，用Windows系统提供的宽字符命令行API来获取参数，这样能拿到原生的Unicode路径，不用额外转码。

示例代码如下：

#include <windows.h>
#include <vector>
#include <opencv2/opencv.hpp>

int main() {
    int argCount = 0;
    // 获取宽字符格式的命令行参数列表
    wchar_t** args = CommandLineToArgvW(GetCommandLineW(), &argCount);
    
    if (args != nullptr && argCount > 1) {
        // 第一个参数是程序名，第二个参数就是传入的视频路径
        std::wstring videoPath = args[1];
        
        // 先检查文件是否存在
        if (_waccess(videoPath.c_str(), 0) == 0) {
            // 把Unicode路径转成UTF-8，传给OpenCV的VideoCapture
            int utf8Size = WideCharToMultiByte(CP_UTF8, 0, videoPath.c_str(), -1, nullptr, 0, nullptr, nullptr);
            std::string utf8Path(utf8Size, 0);
            WideCharToMultiByte(CP_UTF8, 0, videoPath.c_str(), -1, &utf8Path[0], utf8Size, nullptr, nullptr);
            
            cv::VideoCapture cap(utf8Path);
            if (cap.isOpened()) {
                // 后续视频处理逻辑
            }
        }
        
        // 记得释放API分配的内存
        LocalFree(args);
    }
    return 0;
}

方案2：将Unicode路径转换为UTF-8字符串传入OpenCV #

OpenCV的多数接口（包括VideoCapture）其实支持UTF-8编码的路径，所以核心思路是把从命令行拿到的宽字符（Unicode）路径转成UTF-8格式的字符串，再传给OpenCV。

注意：要确保你的VS项目字符集设置为使用Unicode字符集（右键项目→属性→配置属性→常规→字符集），这样宽字符相关操作才能正常工作。

转码工具函数示例：

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

std::string wstring_to_utf8(const std::wstring& wstr) {
    // 计算所需缓冲区大小
    int buffer_size = WideCharToMultiByte(CP_UTF8, 0, wstr.c_str(), -1, nullptr, 0, nullptr, nullptr);
    std::string utf8_str(buffer_size, 0);
    // 执行转码
    WideCharToMultiByte(CP_UTF8, 0, wstr.c_str(), -1, &utf8_str[0], buffer_size, nullptr, nullptr);
    return utf8_str;
}

获取到Unicode参数后调用转码函数，再传入VideoCapture：

// 假设已经通过wmain或API拿到std::wstring类型的videoPath
std::string utf8_path = wstring_to_utf8(videoPath);
cv::VideoCapture cap(utf8_path);
if (cap.isOpened()) {
    // 处理视频逻辑
}

额外注意事项 #

• 如果是通过拖放文件到程序图标传递路径，Windows同样会以宽字符格式传递，用上面的方法也能正常获取。
• 测试命令行参数时，尽量避免在普通CMD中输入Unicode字符（CMD对Unicode支持有限），可以用PowerShell或者创建快捷方式，在快捷方式的目标中添加Unicode路径参数。

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