linecache模块加载和缓存文件内容详解

linecache模块

接触到linecache这个模块是因为前两天读attrs源码的时候看到内部代码引用了这个模块来模拟一个假文件，带着一脸疑问顺便读了一下这个模块的源码，发现其实也就那么回事儿，代码不多，在这总结一下。

linecache模块可以读取文件并将文件内容缓存起来，方便后面多次读取。这个模块原本被设计用来读取Python模块的源代码，所以当一个文件名不在指定路径下的时候，模块会通过搜索路径（search path）来尝试读取文件。

接口

linecache模块的__all__参数其实只提供了getline/clearcache/checkcache三个接口，但实际上可以使用的不止这些，下面我会对所有接口逐个进行介绍。

linecache.getline(filename, lineno, module_globals=None)

获取指定文件的某一行，filename指定文件名、lineno指定行号、module_globals用于指定模块的上下文我也不知道怎么称呼，姑且称为上下文吧，最后一个参数其实到会传到linecache.updatecache()里，用于尝试使用__loader__加载文件，一般情况下不会用到最后一个参数，忽略即可。当行号小于一或大于文件最大行号时函数直接返回空字符串。

linecache.clearcache()

清空所有缓存，注意是所有。

linecache.checkcache(filename=None)

这个函数用于检查缓存，如果文件的大小或者修改时间有变化，会把文件原先的缓存删除，如果文件是懒加载的则保持不变。当filename为None时检查缓存中的所有文件。

以下是没写进模块__all__参数的接口。

linecache.lazycache(filename, module_globals)

对指定文件使用懒加载，启用懒加载成功的文件会在实际调用获取内容的接口时才将文件内容加载进内存，使用这个可以避免多余的文件IO。返回值为一个布尔值，当懒加载成功时返回True，如果文件内容已经实际加载进内存或者加载失败则返回False。

这个函数的module_globals参数是必填的，其实就是传入要加载文件对应模块的上下文。比如加载linecache模块，则传入linecache.__dict__或者vars(linecache)（目前只想到这两种方法，当然你要自己构建一个字典传进去也是可以的）。然后函数会根据上下文获取__loader__的get_source函数保存到缓存中。这个函数是在Python3.5后新增的。

linecache.updatecache(filename, module_globals=None)

这个函数是整个模块的核心，用于更新文件缓存并返回文件内容。函数中间任何一个环节出错了会返回一个空列表。

对于普通文件，内部使用tokenize.open()函数用于打开文件，检测文件的编码并使用检测到的编码打开文件，如果缺失编码默认使用UTF-8。如果给定路径无法打开文件则使用sys.path指定的路径尝试加载。如果文件内容的最后一行不带/n，会自动在最后一个字符加上/n。