OpenCV Python函数文档标C++的void却有返回值，原因何在？

核心原因是OpenCV的Python包装器做了语言习惯适配，让接口更贴合Python开发者的使用直觉，具体可以拆成这几点：

• C++与Python的参数传递逻辑差异
  C里的void函数通常靠输出参数返回结果，比如resize的C写法是这样的：

  cv::Mat src = cv::imread("image.jpg");
  cv::Mat dst;
  cv::resize(src, dst, cv::Size(), 2, 2); // dst是预先声明的输出对象，函数本身返回void
  

  但Python没有这种依赖输出参数的习惯，包装器会自动帮你完成输出对象的创建、内存分配，处理完直接把结果作为返回值返回，这就有了resized = cv2.resize(...)的常用写法。

• 包装器的适配转换逻辑
  OpenCV的Python包装器（基于pybind11或早期的SWIG）在封装C++函数时，会做一层转换：

  1. 识别到C++函数的输出参数后，在Python调用时自动创建对应的空对象（比如numpy数组/Mat结构）
  2. 调用底层C++核心函数完成处理
  3. 将处理好的对象作为返回值返回给用户
     这种转换是为了让Python接口更简洁，符合Python“函数直接返回结果”的使用习惯。

• 兼容C++风格的可选用法
  其实Python版OpenCV也保留了类似C++的写法，你可以预先创建好输出数组，然后作为参数传入：

  import cv2
  import numpy as np
  
  to_be_resized = cv2.imread("image.jpg")
  resized = np.zeros((to_be_resized.shape[0]*2, to_be_resized.shape[1]*2, 3), dtype=np.uint8)
  cv2.resize(to_be_resized, resized.shape[:2][::-1], dst=resized, fx=0, fy=0)
  # 此时resized会被直接修改，函数返回值为None
  

  不过这种写法在Python里很少用，因为直接接收返回值的方式更直观。

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