0-学习查阅API资料的重要性及怎样学

说起来我的编程学习经历，我自己都不知道该怎么感慨了。直到我现在基本以python3为主，R为辅的状态之前，我经历但没有学透过的有：vb，c++（mql4），java，matlab......编程语言各有各的好，选择学什么我一开始也是无头苍蝇。但是后来我自己悟出了一句话：

对于一个小白而言，重要的不是能写出能快速运行的程序，而是能快速写出能运行的程序。

基于这个理论，我最终选择了python3。不过，我是被网上遗留的“python3支持的包还不全”给“忽悠”了，所以从python2开始学习的，直到看到2020年官方不再对python2支持为止。

事实上，python2和python3差别不是特别大，一般的代码给print加个括号，把raw_input()全换成input()就都解决了。另外python3对字符串utf-8的支持很给力，可以直接print()出汉字，再也不用轻易地像在python2中去纠结字符编码问题了。当然，现在再决定学习python的小白们很幸运，不用挑了，直接选择python3就可以了。

还记我曾经是一个编程小白的时候（现在也是，一直是：）），那个时候因为对金融交易感兴趣，就花了很多的时间投身其中。时间长了以后就发现，仅凭借我个人的能力，非常辛苦。当然，金融交易仅仅凭借人力不是不能赚钱，但是我个人在了解到智能交易、程序化交易存在很强大的力量之后，我便开始想办法学习编程，找到做程序化交易的方式。

一开始我觉得编程不是很容易。当然逐步学习并且增加自己编写的代码量之后，或许就是熟能生巧，融会贯通了吧。刚刚看完一些入门书籍，尝试解决了一些坑之后，就觉得自己能够找一些API接口程序，搞来改改，然后就能实现我的目标了。

很快，我从网上找到有GitHub这样一个东西，里面有非常多的项目。每一个项目都有好多的文件。我上来一看就懵了，入门的编程书哪里会讲到一个完整的项目是咋出来的，哪里会给你讲GitHub上发布的项目该怎么看，怎么用？如果随便一个完整的项目文件这样复杂，那么其他交易软件的API说明就更看不懂了……

于是乎，我认识到了自己编程的欠缺。所以就先尝试去了解了一个项目的各个文件大概都是做什么的，怎样安装到自己的编程软件中……

在安装完这些包之后，最关键的就是学会怎样去用这些包，那么我们就必须知道怎样取查阅API资料。学习查阅API资料的重要性不言而喻，没有这些API文档或者源代码，我们不可能完全搞清楚这些代码的使用方法和原理的。

GitHub上查阅一个开源API项目资料的方式基本有两种。一种是查看其说明文件，主要是readme文件或项目文档。另一种就是直接看源代码了。这两种大家最好都学会。如果只读readme或者项目文档，一旦这些文字内容写的不是很详尽或没有给出较为合适的例子，那么仍然会造成使用者的理解困难；如果只阅读源代码，这是可以完整掌握项目的原理的，但是如果能够先阅读readme或者项目文档掌握一个大致的框架内容，这样有助于对源代码的理解。

当然，读懂这些一切的前提是对编程软件有一个基本的认识。由于我个人的情况，我这里的文章都是基于python3的。准确的版本是python 3.6.4这个。

接下来，我们就先从一个较为简单的API项目开始学习吧。