Perl / Python 快速参考指南？

Question

我在编写 Perl/Python 脚本方面有相当的熟练度，但在编写代码时，我经常需要使用 Google 查找一些内置函数的确切操作顺序或某些我知道存在的功能的确切名称。虽然 Google 的效果还不错，但需要一些搜索，并且大约有一半的时间参考页面没有我需要的正确示例。

有人知道任何一个好的 Perl 或 Python 快速参考资料吗？其中包含大部分重要的用法信息和基本示例。我应该制作自己的吗？还是大多数人使用 IDE，不需要这种帮助？（我使用 vim）。

谢谢！

- sgauria

---

对于Python，文档有什么问题吗？ - Ben

http://perldoc.perl.org 我已经配置了浏览器的快捷方式，这样我就可以在URL栏中输入“perldoc perlop”。实际上，如果没有POD和search.cpan.org的访问权限，我无法想象在Perl中进行开发。 - DavidO

@Ben，没问题，但有时我感觉需要更多的例子来澄清如何使用某些东西。我手边没有示例文档页。 - sgauria

这里也有一些免费阅读的书籍：https://www.google.com/search?q=perl+oreally - alex

Answer 1

对于Perl来说，使用perldoc命令。

perldoc Module::Name  # display docs for Module::Name
perldoc -f substr     # display docs for substr()
perldoc -Q parse      # search the FAQ for "parse"
perldoc -v %+         # display docs for special variable %+
perldoc perlcheat     # overview of most important syntax
perldoc perl          # overview of interesting perldoc pages

- Andy Lester

---

你可以使用 pydoc 来完成同样的事情：pydoc collections.OrderedDict。 - mgilson

有一些工具/模块，比如perlfind，可以自动为perldoc提供正确的参数，请参见http://p3rl.org/App::perlfind。 - Jakub Narębski

Answer 2

大部分写得很好的Python代码应该有文档字符串，通过在解释器中输入help可以简单地提供关于模块和函数的信息。

>>> help(str)
>>> (lots of helpful output here!)

- Aesthete

Answer 3

对于Perl来说，如果你想要一个随时可用的工具，那么Johan Vromans所著的Perl参考指南/ Perl便携式参考是最好的选择。 打印PDF文件并装订成小册子，或者到当地书店购买。 （面对现实吧，仅有一页的快速参考手册远远不足以应对Perl的复杂性）。

在使用Perl的许多年里，这个工具帮助了我...直到我转向Python :-)

对于Python来说，顺便说一句，我只是在docs.python.org上进行文档搜索-- 或者在stackoverflow上; Python的语法是什么样的，当我查找某些内容时，我通常需要的是更深入的描述，而不是从快速参考卡中获取到的信息。

- alexis