如何在现有Python项目中查找目标代码实现并厘清模块结构

• 进入signal文件夹后第一优先级看同目录下的__init__.py文件。这个文件是Python包的入口配置，会统一声明对外暴露的所有API的导入来源，直接在文件里搜索butter关键词，就能看到它是从哪个内部模块导入的，顺着路径找就行，不用遍历整个文件夹的文件。很多新手上来就挨个翻目录下的py文件，效率极低，先看包入口的__init__.py是找所有Python开源项目目标代码的通用捷径。
• 实际scipy.signal.butter的核心实现放在signal目录下的_filter_design.py文件中。SciPy这类成熟项目的通用惯例是：对外给用户用的API会统一在__init__.py里导出，具体实现逻辑放在带下划线前缀的内部模块文件中，和用户直接接触的公开接口做隔离。
• 本地排查效率更高：如果你本地环境已经安装了对应版本的SciPy，可以直接在Python交互环境执行以下代码拿到源码位置，比在网页端翻仓库快很多：

import scipy.signal
import inspect
print(inspect.getfile(scipy.signal.butter))

• 模块（module）：单份后缀为.py的Python文件就是一个模块，文件内定义的函数、类、变量都归属于这个模块。
• 包（package）：用来组织多个关联模块的文件夹，传统Python包的目录下一定会有__init__.py文件做初始化和导出配置，Python3.3之后虽然支持无__init__.py的命名空间包，但主流第三方库基本都保留了这个文件。需要注意的是：包本身属于特殊类型的模块，所以日常交流里有人说scipy是模块不算错误，严格分类的话它是顶层包。
• 对应你举的例子：scipy是顶层包，signal是scipy下的子包（也就是你在仓库里打开的那个signal文件夹）；matplotlib.pyplot不是类，是matplotlib包下名为pyplot.py的模块。
• 不存在module.class.function的固定路径模式。Python的导入路径是按照「包-子包-模块」的文件层级走的，函数可以直接定义在模块层级（比如butter就是直接定义在模块里的顶层函数，只是被导出到了scipy.signal的命名空间下），可以定义在类中作为方法，也可以嵌套在其他函数内部，没有强制要求函数必须挂在类下，这是Python和纯面向对象语言的典型差异。

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