使用Python/C API扩展C++至Python，本地C++函数需声明为static吗？

为什么官方示例和常见代码会用static？ #

• 限制作用域避免冲突：static会把函数的作用域锁在当前编译单元（也就是当前.cpp文件）内。如果不用static，函数就属于全局外部符号，要是其他编译单元里有同名函数，链接时直接就会报符号重复的错误——这在多模块的扩展项目里很容易踩坑。
• 遵循封装原则：那些py_前缀的函数本质是Python API的内部实现，只需要通过PyMethodDef结构体暴露给Python解释器，完全没必要让其他文件的代码访问。用static正好把这些内部实现藏起来，符合代码封装的思路。
• 官方规范的引导：Python官方文档这么写，就是给开发者一个安全、规范的写法，帮你提前规避链接层面的潜在问题。

能不能不声明为static？ #

可以，但得承担对应的风险：

• 不用static的话，函数会变成外部链接符号，其他编译单元能直接调用它。如果项目里不小心出现同名函数，链接阶段必然报错。
• 只有当你的扩展有多个编译单元，且这些单元之间需要互相调用这些函数时，才需要去掉static，但这种场景非常少见——毕竟Python扩展的入口都是通过注册的方法表对外暴露的，内部逻辑尽量封装在单个编译单元里更稳妥。

内容的提问来源于stack exchange，提问作者一小木