如何阅读文档-以Pandas库为例

如何阅读文档-以Pandas库为例

0.1相信文档

有时候我们并不完全知道该如何阅读文档，甚至不会读文档。遇到问题只会到百度上查找解决，百度上答案你抄我我抄你，简单问题反复重复，复杂问题无人问津。

这儿我给得第一个建议就是：

建议一：相信文档而非百度。

文档是设计库\软件的官方写的。官方都说不清，还能被网友几句话给说清么？切记：

任何时候，像百度这样面向大众的搜索引擎，提供的都是知识的广度而非深度。谷歌也是一样的。

0.2相信自己

文档大部分是用英文写的，偶尔有些有中文。

下文展示了中英文对照的Requests库，你可以速览一下。

一般来说，速览完中文，我们就对一段文字有了大致了解，但速览完英文，我们可能一无所获。为了阅读一篇文档，如果需要逐字逐句，那时间成本简直太高了。

很多人说自己学英语已经够努力了，怎么还是学不好。但真的够努力了么？想想你自己的中文吧，从小学一个一个字学起，初中高中一步一步读更厚，用词更复杂的书。甚至你课上敢看杂志，如今也时刻走路也看新闻，那个时候不是在学中文。

跟这种程度比，我们的英语真的够努力了么？

学英语首先要明确用英语干什么。阅读已经够难，写作和口语更难。例如我，学英语主要就是为了浏览来自英语文化圈的资讯，我的首要任务很明确，不讲口语没关系，我先读。

下载一个有道云划词翻译，克服恐惧，然后就去读吧。无他，唯手熟尔。

1.何时读

首先先明确何时该读文档：

1，没有需求不读文档，需求简单也不读文档。

2，常用此库，但细节模糊不定时，需读文档。

3，一个例外情况，可以提前学习一些常用库以备不时之需。

2.误区

**1.试图通读。**通读很累，而且没有用。读下来很多时候你已经变成机械阅读了。很多时候，20%功能被80%次使用。

**2.依靠中文读。**这个文档能靠，那个文档能靠么? 旧文档能靠，新文档能靠么？况且，只要还是在用中文读，就没有跳出中文的文化圈，就还是保留着对英语的恐惧，对英语文化圈信息的获取能力就注定是底下的。

3.实战

【1】Garry很刻苦，他们专业要做很多数据处理。读入，处理，写出。一个库要是能提供这些功能就好了。（定义需求）

【2】他搜索到Python 数据清洗库。速览几个页面后，他发现，很多人都提到了Pandas库。

【3】通过上边的搜索，他获得了一个词语——Pandas。他先搜索了Pandas 百度百科，速览了百科给的说明。的确符合我需求。因为方案已经足够明确，本来他还打算到知乎这种平台再搜索一下的，想了想就放弃了。

【4】他搜索Pandas，找到且进入pandas官网，看了看官网的英文介绍。然后径直找到Document。Document目录下有一个类似于快速介绍的东西。

【5】里面如下。可以这就是我想要的。Garry逐字逐句读了起来。

【6】他按如下方法阅读。先通读了前面几个找到点Pandas的感觉。他有点明白了，说白了，pandas就是一个程序实现的EXCEL啊。而且取东西很方便，你想怎么取，就怎么取。例如df[0:3,‘A’]这种切片语句。还有一些求平均值，最大值最小值，数据透视等方法。

他看了一下目录，口中念念有词。对象创建、浏览数据、选择、缺失数据处理、运算、合并、分组、改变形状、Time Series时间序列，这是啥呀、Categoricals这又是啥，绘图，数据输出输出，陷阱。

OK。他就算读完这个文档了。他发现这次他主要想要的就是导入数据，选择，计算出结果，导出。

他就着重看了下Getting Data In/Out，Selection。前后他才花了10min钟。顺便一提因为他要求一个平均值，所以他使用Ctrl+F大法搜索了mean，快速找到了函数位置。

【7】挺好的，这个库挺好的用。不过再多花时间学习也没有必要。看完是不可能看完的。之后有不懂再看就好。Garry如此想。

<完>