如何让CPython仅在Vectorcall能提升性能时标记其可用？

Vectorcall是PEP 590定义的Python C API新调用约定，核心是通过C数组直接传递参数，避免传统调用中创建中间元组/字典的开销，以此提升函数调用性能。但它并非在所有场景下都适用，以下是具体的性能优劣场景及判断方法，可用于优化PyO3的pycall!宏调用效率：

性能更优的场景 #

• 绑定方法配合PY_VECTORCALL_ARGUMENTS_OFFSET标记调用：这种场景下可直接复用绑定方法的上下文，无需额外包装参数，完全跳过元组/字典的创建步骤，基准测试已验证其性能优势。
• 目标函数无可变参数需求：当函数接收固定数量的位置参数和关键字参数，不需要收集*args或**kwargs时，Vectorcall能直接通过C数组传递参数，彻底避免中间结构的内存分配与拷贝开销。

性能下降的场景 #

• 目标函数需要收集*args：这类函数会强制Python将Vectorcall传入的C数组参数重新打包成元组，反而多了一层转换操作，开销比直接传入元组的传统调用更大，基准测试已证实此情况。
• 目标函数需要收集**kwargs：同理，此时Python需要把C数组中的关键字参数重新构建为字典，额外的构建操作会抵消Vectorcall的优势，甚至导致性能不如传统调用。

判断与优化方法 #

1. 检查函数签名：
   • 若调用的是绑定方法，优先使用带PY_VECTORCALL_ARGUMENTS_OFFSET标记的Vectorcall方式。
   • 若函数无*args/**kwargs可变参数，直接采用Vectorcall。
   • 若函数明确需要收集可变参数，则使用传统调用约定。
2. 基准测试验证：针对高频调用的路径编写基准测试，对比两种调用方式的实际性能，实测结果是最可靠的判断依据。
3. 宏逻辑自动适配：在PyO3的pycall!宏中添加逻辑，通过函数的__code__对象解析参数签名，自动判断并选择最优的调用方式。

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