CPython源码中.c.h文件是什么？为何不用普通.h文件？

在CPython的源码体系里，.c.h是一种内部专用的头文件命名约定，和普通.h文件的定位完全不同：

• 为什么不用普通.h？
  普通.h（比如Python.h）是对外暴露的公共接口，会被第三方扩展或外部代码引用；而.c.h是和对应.c文件强绑定的内部辅助文件，里面的内容只供该模块内部使用，不需要考虑对外兼容性。这种命名能让开发者一眼就明白：这不是公共API，别随便在外部代码里引用。

• 为什么混合函数原型和定义？
  这类文件里的内容大多是模块内部复用的小函数、宏或者内联实现。把它们放在.c.h里，既可以在listobject.c的不同编译部分共享，又不用把这些内部实现放到公共头文件里污染接口。同时，把小函数定义放在这里，还能让编译器做内联优化，提升执行效率。

• 搜索不到相关内容的原因
  .c.h是CPython项目特有的命名习惯，不属于通用的C语言文件规范，再加上搜索引擎对特殊字符的过滤，自然很难搜到通用结果。如果想深挖原因，直接去CPython源码仓库里查看这类文件的提交历史或者相关注释，能找到最直接的设计背景。

内容的提问来源于stack exchange，提问作者James Schaefer-Pham