如何编写兼容多版本OpenCV的C++ Aruco标记检测代码？

问题根源 #

普通if判断属于运行时分支，编译器会解析所有分支代码，若某个分支调用了当前OpenCV版本不存在的API，必然触发编译错误。而预处理器分支（#if/#endif）是编译前处理，只会保留符合版本条件的代码块，是解决这类版本兼容问题的正确方式。

正确的版本判断宏 #

OpenCV提供官方版本宏用于预处理器判断：

• CV_MAJOR_VERSION：主版本号（如4对应OpenCV 4.x）
• CV_MINOR_VERSION：次版本号（如2对应4.2.x，6对应4.6.x）
• CV_SUBMINOR_VERSION：修订版本号（如0对应4.2.0）

兼容代码示例 #

以下代码会根据OpenCV版本自动选择对应Aruco检测API：

#include <opencv2/opencv.hpp>
#include <opencv2/aruco.hpp>

int main() {
    cv::Mat frame = cv::imread("test.jpg");
    std::vector<int> markerIds;
    std::vector<std::vector<cv::Point2f>> markerCorners;
    cv::Ptr<cv::aruco::DetectorParameters> detectorParams = cv::aruco::DetectorParameters::create();
    cv::Ptr<cv::aruco::Dictionary> dictionary = cv::aruco::getPredefinedDictionary(cv::aruco::DICT_4X4_50);

#if (CV_MAJOR_VERSION == 4 && CV_MINOR_VERSION == 2)
    // OpenCV 4.2.0 专属API：detectMarkers的参数顺序不同，且不需要rejectedCorners
    cv::aruco::detectMarkers(frame, dictionary, markerCorners, markerIds, detectorParams);
#elif (CV_MAJOR_VERSION >= 4 && CV_MINOR_VERSION >= 6)
    // OpenCV 4.6.0+ 专属API：新增rejectedCorners参数
    std::vector<std::vector<cv::Point2f>> rejectedCorners;
    cv::aruco::detectMarkers(frame, dictionary, markerCorners, markerIds, detectorParams, rejectedCorners);
#else
    // 其他版本的兼容处理（可选）
    #error "Unsupported OpenCV version. Please use 4.2.0 or 4.6.0+"
#endif

    // 后续处理标记结果
    if (!markerIds.empty()) {
        cv::aruco::drawDetectedMarkers(frame, markerCorners, markerIds);
    }
    cv::imwrite("result.jpg", frame);
    return 0;
}

常见错误排查 #

• 宏名称错误：不要混淆CV_MINOR_VERSION和CV_VERSION_MINOR，OpenCV 4中正确的宏是CV_MAJOR_VERSION/CV_MINOR_VERSION。
• 条件逻辑错误：多条件判断要加括号避免优先级问题，比如(CV_MAJOR_VERSION ==4 && CV_MINOR_VERSION ==2)的括号不能省略。
• 头文件引用问题：确认已包含<opencv2/aruco.hpp>，不同版本的Aruco模块头文件路径一致。

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