NumPy Generator类随机数生成实现的技术咨询

为什么跳转时会进入.pyi文件？ #

没错，这确实和Cython编写的实现有关。.pyi文件是类型存根文件，只负责定义函数的参数、返回值类型等接口信息，本身没有函数体。NumPy的随机数生成核心逻辑用Cython（.pyx文件）编写，编译后会生成二进制扩展模块，不会保留Python级别的函数体实现。IDE在跳转定义时，优先找到的是用于类型提示的.pyi文件，而非实际的实现源码。

查看函数实现的推荐流程 #

• 先定位NumPy的本地源码路径：执行import numpy; print(numpy.__file__)，输出的路径是NumPy的安装目录，进入其中的random子文件夹，就能找到_generator.pyx、_bit_generator.pyx等核心Cython实现文件。
• 直接阅读Cython源码：.pyx文件是Cython的源码，混合了Python语法和C级别的操作，里面包含了随机数生成器的核心逻辑（比如各种概率分布的计算、比特生成器的实现）。如果需要更底层的算法实现（比如MT19937伪随机数算法），可以在同目录下找到对应的.c文件。
• 配置IDE指向源码仓库：如果本地安装的是编译后的NumPy，看不到完整源码，可以克隆NumPy的源码仓库到本地，然后在IDE（如PyCharm）中把仓库目录设置为源码根目录，替代默认的安装路径，这样跳转定义时就能直接指向.pyx或C源码文件。
• 结合源码注释理解：NumPy源码里的注释非常详细，尤其是随机数模块的实现文件，会标注算法的出处、实现细节，配合官方文档里的算法说明，能更快理清逻辑。

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