OpenCV中const cv::Mat为何未阻止内容修改？

首先咱们先搞清楚你遇到的问题根源：为什么声明了const cv::Mat&参数，却仍然能调用putText修改图像内容，还没编译警告？

问题原因：cv::Mat的const限定不保护像素数据 #

cv::Mat本质是一个带引用计数的容器对象，它的const修饰符只限制修改Mat自身的元数据（比如行数、列数、数据指针的指向等），但不会阻止修改它指向的像素数据。这是因为OpenCV的很多操作函数（包括putText）内部会通过类型转换绕过const限定，或者利用Mat的“写时复制”机制——如果传入的Mat是const且引用计数为1，函数会直接修改原始像素；如果引用计数大于1，会先拷贝一份数据再修改，但无论哪种情况，编译器都不会因为你声明了const而报错。

防止误修改的最佳实践 #

1. 使用cv::InputArray作为只读参数类型

这是OpenCV官方推荐的只读输入参数方式，InputArray是专门设计的只读包装类型，会从编译阶段阻止对数据的写操作。如果你的函数只需要读取图像数据，或者必须修改的话只能操作副本，就用它：

void addText(cv::InputArray mat) {
    // 尝试直接调用putText会编译报错，因为putText需要可写的InputOutputArray
    // 正确做法：创建副本再修改
    cv::Mat temp = mat.getMat().clone();
    cv::putText(temp, "test", cv::Point2f(100, 100), cv::FONT_HERSHEY_PLAIN, 2, cv::Scalar(0, 0, 255, 255));
    // 如果需要返回修改后的图像，可以将temp作为返回值，或者通过OutputArray参数传出
}

2. 显式创建副本并操作副本

如果你必须保留const cv::Mat&参数，最稳妥的方式是在函数开头就创建原始图像的副本，所有修改操作都针对副本进行，彻底避免误改原始数据：

void addText(const cv::Mat& mat) {
    cv::Mat temp = mat.clone(); // 显式创建副本
    cv::putText(temp, "test", cv::Point2f(100, 100), cv::FONT_HERSHEY_PLAIN, 2, cv::Scalar(0, 0, 255, 255));
    // 后续操作都用temp，原始mat完全不受影响
}

3. 启用编译器严格警告

开启编译器的严格警告选项（比如GCC的-Wall -Wextra -Wcast-qual），可以捕获一些OpenCV内部绕过const限定的不安全转换，提前提醒你潜在的误修改风险。

4. 运行时检查只读状态（可选）

如果需要在运行时确保图像不被修改，可以调用mat.isReadOnly()方法，它会返回当前Mat是否处于只读状态。不过这只是运行时检查，无法替代编译阶段的保护：

void addText(const cv::Mat& mat) {
    if (mat.isReadOnly()) {
        // 处理只读场景，比如创建副本再操作
        cv::Mat temp = mat.clone();
        cv::putText(temp, "test", cv::Point2f(100, 100), cv::FONT_HERSHEY_PLAIN, 2, cv::Scalar(0, 0, 255, 255));
    } else {
        // 若允许修改原始数据再执行操作，否则还是用副本
        cv::putText(mat, "test", cv::Point2f(100, 100), cv::FONT_HERSHEY_PLAIN, 2, cv::Scalar(0, 0, 255, 255));
    }
}

总结 #

最可靠的编译阶段保护是使用cv::InputArray作为只读参数；如果必须进行写操作，一定要显式创建副本，从根源上避免意外修改原始图像数据。

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