工具需用好，阅读源码没烦恼
文 | 轩辕御龙
来源：Python 技术「ID: pythonall」
每当我们接手一个新项目时，面对庞杂的模块、繁复的代码，想必心情是非常绝望的，“这都特么啥呀？”
如果你也有这样的烦恼，那你就应该看这篇文章。
我们阅读源码的一大烦恼在于，项目代码中存在着各种各样的调用，而我们的大脑却没办法像计算机一样完好地维护一个动态的调用链；时常发生的情况就是一头扎进了源码中，然后——
“我是谁？我在哪儿？我为什么要在这儿？”
显然，作为一个地道的程序员，这个时候应该想到借助工具了。
再根据软件界第一定律“99%的工作都是别人做过的”，于是我们大可以拿来主义一把，琢磨琢磨是不是已经有人做了这样的工具。
说到这里可能很多同学已经想到了一个被局部称为“世界第一编辑器”的软件——Source Insight。（然后看了看正版价格就灰溜溜滚回了Google）
然后还有强大的Understand，付费环节还比较繁琐，暂时pass。
直到我们在V2EX看见有同学推荐了一款名为Sourcetrail的开源软件。
下载安装
打开软件官方网站，可以看到一个很简洁的页面，直截了当地告诉你它是哪条道上的四年级老大哥：Sourcetrail就是为你阅读陌生源码赋能的。同时还免费、开源、跨平台……háo嘛，今年几大红火要素都占齐活儿了，不捞一把都说不过去。
接下来就是download，在GitHub的release页面选择自己系统对应的发布版本下载安装：
具体的安装步骤与其他应用相比大同小异，就不再赘述了，否则这篇文章也太水了点
软件介绍
安装好后，运行程序，会出现这样的界面：
我们选择“New Project”，在随后的界面中填写好项目名称和项目路径：
填好后点击下方的Add Source Group按钮，用以添加代码。
——在Sourcetrail中允许我们在同一个项目中添加多个来源的代码，甚至允许各个代码分组的语言互不相同，这些代码分组即为各个Source Group。
由于我们只需要查看一个代码库的内容，因此我们也只需要添加一个Source Group即可，如下图依次点击：
在继续输入新的信息前，打开你的命令行工具（Windows系统：Win+R，输入cmd然后回车；Linux下不赘述），输入where python（Windows）或which python3(Linux)，即可看到当前环境的Python安装路径，记下这个路径，我们需要用它来解析Python代码。
然后在新的界面中，需要填写Python环境的字段填入刚刚我们查到的Python所在目录（即去除最后一个斜杠及之后的内容）。
其他的需要注意的就是“要建立索引的文件/目录”，这个字段就是添加我们真正要阅读的Python源码路径。字段左下角有一个“+”号，点击即可增加一个源码路径：
原本是想把Python之父龟叔多年前写的爬虫程序作为示例的，奈何网络不给力，迟迟拉取不下源码，于是另外找了一份开源项目“北京实时公交”替换之。
点击右下角“Create”，再点击“Start”：
解析就开始了：
再点击“OK”：
得到下图的解析结果：
可以看到，Sourcetrail将解析结果按“文件”、“模块”等大致分了类。
我们点击最关心的“函数（Function）”来体验一下：
在左边，Sourcetrail为我们生成了形象的调用图；在右边，Sourcetrail列出了当前焦点函数的代码及其相应调用。
无论在左边操作还是在右边操作，都会带来界面的同步变化。
从此我们再也不必苦哈哈地在A4纸上写下繁琐的调用关系了哈哈哈哈，翻身农奴把歌唱
总结
本文介绍了一个可以把源码调用关系可视化的工具，可以极大便利我们阅读他人代码的工作。实际上这类工具还有很多，比如Source Insight和Understand。
只要是能够提升我们学习/开发效率的，我们都应该乐于尝试。后续我们还会推荐一些这类实用的工具，希望可以帮助大家升职加薪[手动滑稽]。
PS：公号内回复「Python」即可进入Python 新手学习交流群，一起 100 天计划！
老规矩，兄弟们还记得么，右下角的 “在看” 点一下，如果感觉文章内容不错的话，记得分享朋友圈让更多的人知道！
【代码获取方式】