IPython使用指南

简介：

2001年，Fernando Perez为了得到一个更为高效的交互式Python解释器而启动的一个项目，IPython不仅仅是一个加强版的shell，他可以直接进行绘图操作的GUI控制台，一个基于web的交互式笔记本，以及一个轻量级的快速并行计算引擎。

常用命令：

1.启动：ipython/ipython qtconsole –pylab=inline
2.Tab键自动补全

内省

在变量名或命令的前面或后面加一个 “？” 并执行，可以用于显示该对象的一些通用信息，如对象类型、文档字符串等，这就叫做对象内省。这种操作查看到的信息，尤其是函数和类的信息，比通常直接引用变量名然后回车所看到的（repr）要好。“？” 的另一个用法是可以搜索 IPython 的命名空间，配合通配符使用效果如下：

In [1]:import numpy as np
In [2]:np.load?
np.load
np.loads
np.loadtxt
np.pkgload
使用双问号“??”还可以查看对象的源代码（如果可见的话）。

常用快捷键

Ctrl-P 或上箭头键 后向搜索命令历史中以当前输入的文本开头的命令
Ctrl-N 或下箭头键 前向搜索命令历史中以当前输入的文本开头的命令
Ctrl-R 按行读取的反向历史搜索（部分匹配）
Ctrl-Shift-v 从剪贴板粘贴文本
Ctrl-C 中止当前正在执行的代码
Ctrl-A 将光标移动到行首
Ctrl-E 将光标移动到行尾
Ctrl-K 删除从光标开始至行尾的文本
Ctrl-U 清除当前行的所有文本译注12
Ctrl-F 将光标向前移动一个字符
Ctrl-b 将光标向后移动一个字符
Ctrl-L 清屏

魔术命令

在 IPython 的会话环境中，所有文件都可以通过 %run 命令来当做脚本执行，并且文件中的变量也会随即导入当前命名空间。即，对于一个模块文件，你对他使用 %run 命令的效果和 from module import * 相同，除非这个模块文件定义了 main 函数（if name == ‘main:’），这种情况下 main 函数还会被执行。

这种以 % 开头的命令在 IPython 中被称为魔术命令，用于加强 shell 的功能。常用的魔术命令有：

%quickref 显示 IPython 快速参考
%magic 显示所有魔术命令的详细文档
%debug 从最新的异常跟踪的底部进入交互式调试器
%pdb 在异常发生后自动进入调试器
%reset 删除 interactive 命名空间中的全部变量
%run script.py 执行 script.py
%prun statement 通过 cProfile 执行对 statement 的逐行性能分析
%time statement 测试 statement 的执行时间
%timeit statement 多次测试 statement 的执行时间并计算平均值
%who、%who_ls、%whos 显示 interactive 命名空间中定义的变量，信息级别/冗余度可变
%xdel variable 删除 variable，并尝试清除其在 IPython 中的对象上的一切引用
!cmd 在系统 shell 执行 cmd
output=!cmd args 执行cmd 并赋值
%bookmark 使用 IPython 的目录书签系统
%cd direcrory 切换工作目录
%pwd 返回当前工作目录（字符串形式）
%env 返回当前系统变量（以字典形式）

对魔术命令不熟悉的话可以通过 %magic 查看详细文档；对某一个命令不熟悉的话，可以通过 %cmd? 内省机制查看特定文档。值得一提的是，IPython 中使用 del 命令无法删除所有的变量引用，因此垃圾回收机制也无法启用，所以有些时候你会需要使用 %xdel 或者 %reset。

测试代码的执行时间:%time和%timeit

历史输入和输出变量

历史输入和输出变量

与标准 Shell 类似，IPython 中也可以通过 _ 和 __ 访问上一次和上上一次的输出。同时你肯定注意到了，IPython 中每一次的输入输出都有序号。访问历史 X 行输出的方法为：_X；访问历史 X 行输入的方法为：_iX。因为访问历史输出的使用概率较历史输入大很多，所以访问历史输出仅使用下划线加行号即可，同时为了区分，访问历史输入时需添加小写字母 “i”，代表 “in”。

目录书签系统

In [1]: %bookmark db /home/wang
ln [2]: cd db

记录历史输入和输出

IPython能够记录整个控制台会话，包括输入和输出。执行%logstart即可开始记录日志。IPython的日志功能可以在任何时刻开启，它将记录你的整个会话（包括此前的命令）。此外还可以看看几个与之配套的魔术命令%logoff,%logon,%logstate以及%logstop.

与操作系统交互

更系统相关的IPython魔术命令

命令	说明
!cmd	在系统shell中执行cmd
output=!cmd args	执行cmd，并将stdout存放在output中
%alias alias_name cmd	为系统shell命令定义别名
bookmark	使用IPython的目录书签系统
%cd directory	将系统工作目录更改为directory
%pwd	返回系统的当前工作目录
%pushd directory	将当前目录入栈，并转向目标目录
%popd	弹出栈顶目录，并转向目标目录
%dirs	返回一个含有当前目录栈的列表
%dhist	打印目录访问历史
%env	以dict形式返回系统环境变量

异常和跟踪

(I)Python调试器命令

命令	功能
help	显示命令列表
help command	显示command的文档
c(ontinue)	恢复程序的执行
q(uit)	退出调试器，不再执行任何代码
b(reak) number	在当前文件的第number行设置一个断点
b path/to/file.py:number	在指定文件的第number行设置一个断点
s(tep)	单步进入函数调用
n(ext)	执行当前行，并前进到当前级别的下一行
u(p)/d(own)	在函数调用栈中向下或向上移动
a(rgs)	显示当前函数的参数
debug statement	在新的（递归）调试器中调用语句statement
l(ist) statement	显示当前行，以及当前栈级别上的上下文参考代码
w(here)	打印当前位置的完整栈跟踪(包括上下文参考代码)

Notebook

Notebook 的官方信息可以从 ipython.org/notebook 获得，不过好像被墙了。上不去的话也可以访问它的 github 页面，ipython/examples/Notebook 目录下有很多可供参考的内容。前面说过 Notebook 有一种 .ipynb 的文件格式，当你打开这个例程目录下的某个文件后，就能体会到 Notebook 的奇妙之处了。

演示文档

目前在各种 Python 研讨会上，一种流行的演示手段就是使用 IPython Notebook，然后再将 .ipynb 文件发布到网上以供所有人查阅。除了前面说过的可以内嵌 matplotlib 绘图外，Notebook 还同时提供了对 LaTex 和 MarkDown 的支持！

如上图便展示了一个 .ipynb 文件的示例页面。其中一对 In Out 会话被视作一个单元，称为 cell。第一个 cell 里我写入的内容其实是：

LaTex 演示

---

$Z=\frac{X-\bar{X}}{S}$
分别使用了 MarkDown 和 LaTex 的语法。按下 Shift + Enter 后这段内容就被渲染成了图片中的样子。

cell 特别亲切的地方在于：它可以作为一个类似“段落”的概念来进行编辑，不管是执行前还是执行后，而且既可以针对内容进行编辑，也可以对 cell 整体应用 copy、paste、cut 等操作，甚至还可以前后移动 cell 的位置。这带来的好处是，在大量试验性的交互操作过后，他不会像普通 shell 那样留下无数没用的 IO 内容。如果某条命令的输出不理想或者报了错，你就可以回头编辑后重新运行，或把它移位或干脆删掉。这样在很久的一段交互过程后，Notebook 留下的反而是一份干净整洁的文档。

.ipynb 文件使用的是一种类 JSON 的文本格式，就像这样：

“worksheets”: [
{
“cells”: [
{
“cell_type”: “markdown”,
“metadata”: {},
“source”: [
“##LaTex \u6f14\u793a\n”,
“—\n”,
“$Z=\\frac{X-\\bar{X}}{S}$”
]
},
这种交互式计算环境，对绘图、数学公式、简易排版语法的支持，还有一种方便的文档格式，共同帮助 Notebook 成为了 Python 科学计算的理想工具。另外这种使用浏览器和服务进程的 C/S 结构还暗含了一种远程连接可能，抛开安全性不谈的话，其在教学方面也有很高的潜力。

操作指南

当通过 IPython Notebook.exe 进入应用时，首先打开的是 Home 页面，地址一般为：http://127.0.0.1:8888/tree。Home 目录下会列出所有的历史文件记录，右上角则有一个 “New Notebook” 按钮可以新建一个会话。

在 .ipynb 文件的交互页面，需要注意的除了标准的 IPython 语法外，就是页面抬头处的菜单栏和工具栏了。Notebook 很贴心地提供了非常友好的帮助页面，因此本文不再赘述。基本看完这两个页面（内容很少）后就能对 Notebook 的操作方式了解的差不多。