Python参考手册?
有没有推荐的Python参考手册,比官方文档更好用的?我是一名有经验的程序员(之前用过PHP、C#、JavaScript,最近还用了一些C),我觉得Python的手册相比PHP的手册和MSDN要差很多。特别是,官方文档似乎从来没有告诉我,如果我传入一些无效的东西,会出现什么错误,而且在一个模块里似乎也没有办法进行导航。
以os模块为例。那个页面上没有我可以调用的常量或方法的列表,所以我得按Ctrl+F搜索“stat(
”,直到找到它。然后,一旦我找到它,文档也没有告诉我如果我用一个不存在的目录去调用stat
会发生什么,所以我只能在终端里试试看,看看结果。
这看起来效率太低了……Python程序员是怎么解决这个问题的呢?
2 个回答
我觉得我对Python文档的感觉和你不太一样,不过有时候我确实需要花点时间去更好地理解Python的某些部分。其实大多数编程语言都是这样的。Python是一种学习起来快速简单的语言,花在文档上的时间少,更多的时间可以用来编程。而且,Python的用户群体没有PHP那么大。PHP有很多人每天都在分享示例和详细信息。
Python还有一个很棒的功能,就是它的交互式命令行,可以用来测试东西。我觉得编程的一个好方法就是多做多学,而不是光看。所以如果你想测试一些东西,不需要费劲去编译,只需在解释器里写个简单的脚本就行。这个解释器还有一些参考工具,比如 dir(<标识符>)
和 help(<标识符>)
,可以帮助你查找模块、类或函数的相关信息。
好了,不再为我喜欢的语言辩护了,pyDoc 是一个小工具,可以帮助你获取Python所需的信息。
pydoc是Python自带的一个工具,可以用来查看和生成Python文档。
在实际操作中,你可以做一个简单的测试程序来检查某个功能的表现,或者直接阅读源代码。很多Python标准库的代码写得相当清晰,实际上也很自我说明,所以当你想了解某个功能的具体细节时,查阅这些代码是个很好的做法。
不过有一个例外:对于一些低级系统功能,比如os
模块中的很多函数,这些函数直接对应于底层平台的C语言函数。因此,如果你想了解Python的stat
函数的行为,你需要查阅你所使用平台的原生C语言stat
调用的参考文档。在这种情况下,Python库的文档通常只会解释这个函数的基本用途,以及它和C语言版本的不同之处(如果有的话)。