为何运行代码时抛出‘UsageError: Line magic function `%%capture` not found.’错误？

• 核心原因：%%capture是IPython专属的单元格魔法命令，仅能在Jupyter Notebook/Lab、IPython交互式终端这类IPython环境中生效，在普通Python脚本或标准Python解释器中运行会触发该错误。

具体解决办法 #

1. 切换至IPython环境运行 #

如果你的需求就是使用%%capture，直接将代码迁移到Jupyter Notebook、Jupyter Lab，或者打开IPython终端执行，即可正常识别该魔法命令。

2. 用Python原生代码实现输出捕获 #

如果必须在普通Python环境运行，可借助标准库的io和contextlib模块实现等效功能：

import io
from contextlib import redirect_stdout, redirect_stderr

# 捕获标准输出与错误输出
with io.StringIO() as output_buf, io.StringIO() as error_buf:
    with redirect_stdout(output_buf), redirect_stderr(error_buf):
        # 此处放入你原本需要捕获输出的代码
        print("测试输出内容")
        raise ValueError("测试错误信息")
    captured_output = output_buf.getvalue()
    captured_error = error_buf.getvalue()

# 查看捕获结果
print("捕获的输出:", captured_output)
print("捕获的错误:", captured_error)

3. 检查并调整运行环境 #

确认当前代码的运行方式：

• 若用python xxx.py执行脚本，属于普通Python环境，不支持IPython魔法命令；
• 若在IDE的交互式窗口运行，需确认是否启用了IPython内核（比如PyCharm的Python Console可切换为IPython模式）。

内容的提问来源于stack exchange，提问作者Cicilia D Souza