1

有没有比官方文档更好的python推荐参考手册?我是一位经验丰富的程序员(PHP、C#、javascript 和最近的一些 C),与 PHP 手册和 MSDN 相比,我发现 python 手册相当缺乏。特别是,官方文档似乎从来没有告诉我如果我传入无效的东西会发生什么错误,而且显然没有办法在模块内导航。

os 模块为例。在该页面上没有我可以调用的常量或方法列表,所以我必须按 Ctrl+f 输入“ stat(”,直到找到它。然后,一旦我找到它,它不会告诉我如果我stat用一个不存在的目录调用会发生什么,所以我只需要在终端中尝试它,看看会发生什么。

这似乎非常低效……python 程序员如何处理这个问题?

4

2 回答 2

3

在实践中,您要么制作一个快速测试程序来检查行为,要么阅读源代码。大部分 Python 标准库代码都写得很清楚,实际上是自文档化的,因此当您需要了解某事物如何工作的基本细节时,参考它是一种标准做法。

一个例外:对于模块中的许多低级系统函数,这些os函数直接映射到底层平台的 C 同名。因此,如果您需要了解 Python 的行为stat,您可以查找平台的原生 Cstat调用的参考文档。在这些情况下,Python 库文档通常只解释函数的基本用途以及它与 C 等价物的区别(如果有的话)。

于 2011-11-16T06:46:53.810 回答
1

我不认为我对 python 文档有过和你一样的感觉,但我确实有时需要不遗余力地更好地理解 python 的一部分是如何工作的。尽管大多数语言都是这样。Python 是一种快速且易于学习的语言,它需要更少的文档时间和更多的编程时间。python的用户群也没有PHP那么大。PHP 让人们每天都在不断地提供某些函数的示例和详细信息。

python 的另一个优点是它的交互式 shell 可以测试。只是我对编程的想法,你通过做然后看到来了解更多。因此,如果您对测试不需要通过编译的东西感兴趣,只需在解释器中编写一个快速脚本。解释器也有参考工具。示例dir(<identifier>)help(<identifier>)模块、分类或功能需求。

无论如何捍卫我最喜欢的语言,pyDoc是一个有用的工具,可以帮助您从 python 中获得所需的东西。

pydoc 是 Python 自带的一个工具,可以用来查看和生成 Python 文档。

于 2011-11-16T06:57:54.103 回答