Python: Tools

在日常 Python 开发中，有两个小工具几乎绕不开——pip 和 pydoc。一个管模块安装，一个管文档查看，用好了效率能提升不少。下面就来聊聊它们的具体用法和实用技巧。

1、pip 安装 Module

从 Python 2.7.9 之后，pip 就被正式引入，成为官方推荐的包管理器。它的基本用法非常直观：

• 安装指定包：python -m pip install SomePackage
• 安装指定版本：python -m pip install SomePackage==1.0.4
• 安装最小版本：python -m pip install "SomePackage>=1.0.4"
• 升级指定包：python -m pip install --upgrade SomePackage

如果机器上同时安装了多个 Python 版本，可以通过指定 Python 解释器来执行 pip 命令：

python2 -m pip install SomePackage  # 默认 Python 2  
python2.7 -m pip install SomePackage  # 指定 Python 2.7  
python3 -m pip install SomePackage  # 默认 Python 3  
python3.4 -m pip install SomePackage  # 指定 Python 3.4

万一你的 Python 还没有 pip，也不需要慌，一行命令就能搞定：

python -m ensurepip --default-pip

这条命令会帮你安装默认版本的 pip，之后就能畅快使用了。

2、pydoc 查看 API doc

之前我们提到过，通过 dir() 配合对象的 __doc__ 属性可以查看模块、类、函数的文档。但真的要在一个命令行里翻来翻去地找 API，体验实在算不上友好。其实，Python 自带了一种更优雅的方式——pydoc，它就在 ${PYTHON_HOME}/Lib/pydoc.py 里，安装 Python 时默认就会带上。

pydoc 可以自动生成 HTML 格式的 API 文档，就像 Ja va 的 ja vadoc 一样。使用方法也很简单：

python -m pydoc -g -w -p 5007

执行后，系统会弹出一个图形界面（GUI），你可以在里面搜索模块、函数、类，然后直接跳转到对应的文档页。更赞的是，它还会启动一个本地 HTTP 服务器，你可以在浏览器里查看，体验简直和在线文档一样流畅。

在浏览器中打开的界面长这样，清晰、直观，查找起来效率高多了：

这两个工具虽然基础，但确实是日常开发中的“好帮手”。熟练使用它们，能让你在模块管理和文档查阅上节省不少时间。