python参考手册？

Question

python的推荐参考手册是否比官方文档更好？我是一名经验丰富的程序员（PHP，C＃，javascript和最近的一些C），我发现python手册相当于PHP手册和MSDN。特别是，官方文档似乎从来没有告诉我，如果我传入一些无效的内容会发生什么错误，并且显然没有办法在模块中导航。

以the os module为例。我没有可以在该页面上调用的常量或方法列表，因此我必须按Ctrl + f查看“stat(”，直到找到它为止。然后，一旦我找到它，它就不会告诉我如果用一个不存在的目录调用stat会有什么期望，所以我只需要在终端中尝试它，看看会发生什么。 / p>

这看起来非常低效...... python程序员如何处理这个？

Answer 1

在实践中，您要么制作快速测试程序来检查行为，要么阅读源代码。许多Python标准库代码都是相当清晰的编写，实际上是相当自我记录的，所以当你需要知道某些东西如何工作的细节时，引用它是标准做法。

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

Answer 2

我认为我对python docs的感觉并不像你那样，但我有时候需要一些时间让我更好地理解python的一部分是如何工作的。虽然这是大多数语言的方式。 Python是一种快速简便的学习语言，它需要更少的文档时间和更多的编程时间。 python的用户群也没有PHP那么大。 PHP让人们每天不断提供某些功能的示例和详细信息。

关于python的另一个好处是它的交互式shell可以测试出来。只是我对编程的想法，你可以通过观察来了解更多。因此，如果您对测试某些内容感兴趣，则无需编译，只需在解释器中编写快速脚本即可。口译员也有参考工具。示例dir(<identifier>)和help(<identifier>)用于模块，clasa或函数需求。

足以保护我最喜欢的语言，pyDoc是一个有用的工具，可以帮助你从python中获得所需的东西。

  

pydoc是Python附带的一个可用于查看的工具   并生成Python文档。