IPython魔法命令大全：%timeit与%run等高效指令详解

许多开发者将 IPython 的魔法命令视为一份死记硬背的清单，但在实际应用中，往往卡在更本质的问题上：这条命令究竟是在标准 Python 解释器中运行，还是仅在 IPython 交互环境中有效？

首先要明确一个边界：魔法命令是 IPython 提供的交互式增强功能，仅适用于 IPython 终端或使用其内核的 Jupyter 环境；它们并非标准的 Python 语法，因此不能直接放入普通的 .py 文件中期望被 Python 解释器识别。理清这一界限后，按照“控制会话、代码测速、脚本运行、状态查看”的逻辑来选用命令，日常开发流程将更加顺畅。

先分清 % 和 %%，再记命令

以 % 开头的称为行魔法（Line Magic），仅处理当前行的代码；而以 %% 开头的则是单元格魔法（Cell Magic），作用于整个输入单元格。虽然两者仅相差一个百分号，但这决定了多行代码的组织方式。例如，使用 %timeit sum(range(1000)) 可对单行表达式进行计时；若改为 %%timeit，则从下一行开始的所有单元格内容均被视为待测代码块。

这一规则也解释了为何某些魔法命令看起来不像标准的 Python 代码：IPython 会在执行前识别这些特定前缀，并将其分派给对应的魔法函数处理。其参数通常采用命令行风格，而非传统的括号调用方式。熟悉前缀机制后，你可以先用 %pwd 查看当前工作目录，再通过 %cd 切换路径；在探索数据或文件结构时，这能避免频繁切换终端带来的中断。

行魔法作用于一行，单元格魔法处理整个代码单元。

需要注意的是，这些前缀并非跨环境的通用快捷方式。若将 %cd 或 %%timeit 直接复制到普通 Python 脚本中，会导致语法错误。如果希望将逻辑保存为可复用的脚本，应仅保留标准 Python 代码，并在 IPython 环境中通过魔法命令来调度执行。

比较代码速度，用 %timeit 看重复结果

若需快速了解一行代码的大致耗时，可使用 %time，它适合单次查看 CPU 时间和墙钟时间。然而，若要对比两种写法的性能，单次计时易受启动开销和系统波动影响，此时 %timeit 更为合适：它会自动重复执行代码，智能选择循环次数，并汇总多轮测量结果以提供更具统计意义的数据。

例如，可以直接执行 %timeit sum(range(1000))。当需要预先准备变量或测试多行代码时，应改用单元格模式：首行写入 %%timeit，随后放置待测语句。此外，%timeit 支持通过 -n 指定每轮循环次数，以及通过 -r 设定重复轮数；默认值会根据版本和环境自动调整，初学者通常只需保持默认设置即可。

%timeit 可测单行表达式，%%timeit 可测多行单元格。

解读结果时，应将其视为特定机器与环境下的测量值，而非程序在所有场景中的绝对性能指标。测量对象应严格限定为需比较的核心部分；若将文件读取、数据预处理等额外操作纳入计时范围，所得数据将无法准确反映目标代码的性能。对于异步代码，还需注意工具的兼容性，避免仅凭单次输出轻率下结论。

用 %run 把脚本带进交互探索

Notebook 或 IPython 会话适合即时探索，而较为成熟的代码则更适合封装在 .py 文件中。通过 %run analysis.py 可在交互环境中直接执行脚本；脚本运行结束后，其中定义的变量通常会注入 IPython 的交互命名空间，便于后续查看与调试。默认情况下，脚本会在相对独立的命名空间中执行，以减少副作用。

若脚本需要访问当前会话中已存在的变量，可使用 %run -i analysis.py，强制脚本在 IPython 的用户命名空间中运行。这一选项改变了变量的作用域，虽有利于交互式实验，但也意味着脚本可能依赖会话中的既有状态。为确保程序的可重复性，仍建议明确声明关键输入，避免依赖偶然存在的旧变量。

%run 执行脚本后可继续检查其中定义的变量。

若希望先将文件内容加载到当前编辑区以便修改，可使用 %load；它会将指定源文件的内容载入前端单元格，方便检查或继续编辑，这与 %run 的立即执行行为不同。两者的侧重点各异：前者旨在获取代码进行修改，后者旨在运行脚本并观察输出结果。

用 %who 和 %history 收拾交互现场

交互探索过程中容易积累大量变量。使用 %who 可列出当前会话中由用户定义的名称，而 %whos 则提供更详细的变量信息；当遗忘某个结果变量的名称时，查看列表比重复运行整段代码更为高效。若需按类型筛选，还可附加类型参数，例如执行 %who int 仅显示整型变量。

命令历史记录可通过 %history 查看。它默认输出当前会话的所有输入记录，也支持通过范围参数筛选特定行；使用 %history -n 4-6 可带行号显示指定输入，便于定位和整理。若要将一段可复用代码保存至文件，务必仔细确认选中的历史范围，以免误存临时试验代码或包含敏感信息的输入。

清理变量时需慎用 %reset：它会清空交互命名空间，并可能重置历史等会话状态，切勿将其视为普通的“刷新”按钮。与其背诵完整的命令表，不如养成按需调用的习惯：计时选用 %timeit，运行文件使用 %run，检查变量借助 %whos，追溯输入依赖 %history。清晰区分交互探索与可复现脚本，才能让魔法命令真正提升效率，而非增加会话管理的负担。