能否保存Jupyter Notebook控制台输出？如何重定向至文件？

阿华AIGC实验室

2026-5-21

如何在Jupyter Notebook中保存控制台输出日志

当然可以！在Jupyter Notebook里保存控制台输出有好几种实用的方法，我给你整理了几个最常用的，你可以根据自己的需求选择：

1. 用`%%capture`魔术命令捕获单个单元格输出

这个IPython内置的魔术命令非常适合临时捕获某一段代码的所有输出（包括标准输出和错误输出），之后你可以轻松把内容写入文件：

%%capture captured_output
# 在这里写你的代码，比如打印操作或者会产生输出的逻辑
print("这是要保存的普通控制台消息")
import sys
sys.stderr.write("这是一条错误提示消息\n")

# 将捕获的内容写入日志文件
with open("cell_output_log.txt", "w", encoding="utf-8") as f:
    f.write(captured_output.stdout)  # 写入标准输出内容
    f.write(captured_output.stderr)  # 写入错误输出内容

captured_output对象会存储该单元格的所有输出，你可以选择只保存stdout、只保存stderr，或者两者都保存。

2. 全局重定向所有输出到文件

如果想让整个Notebook运行过程中，所有控制台输出都自动保存到文件（而不在Notebook单元格里显示），可以直接修改Python的标准输出流：

import sys

# 先保存原始的输出流，方便之后恢复
original_stdout = sys.stdout
original_stderr = sys.stderr

# 打开日志文件准备写入
log_file = open("full_notebook_log.txt", "w", encoding="utf-8")

# 重定向stdout和stderr到文件
sys.stdout = log_file
sys.stderr = log_file

# 这里执行你的所有操作，比如打印、运行会产生输出的代码
print("这条消息会直接写入日志文件，不会在Notebook里显示")
1/0  # 触发一个错误，错误信息也会被自动写入日志

# 操作完成后，恢复原始输出流并关闭文件
sys.stdout = original_stdout
sys.stderr = original_stderr
log_file.close()

如果需要同时在Notebook显示输出和保存到文件，可以自定义一个流处理类，把输出同时发送到原始流和文件，这个稍微复杂一点，但也不难实现。

3. 用`logging`模块做结构化日志记录

如果需要更规范、灵活的日志管理（比如按级别记录信息、自定义日志格式），Python标准库的logging模块是更好的选择：

import logging
import sys

# 配置日志：设置输出文件、日志级别和格式
logging.basicConfig(
    filename="structured_notebook_logs.log",
    level=logging.INFO,
    format="%(asctime)s - %(levelname)s - %(message)s",
    encoding="utf-8"
)

# 使用logging输出不同级别的消息
logging.info("这是一条普通操作信息")
logging.warning("这是一条需要注意的警告")
logging.error("这是一条错误提示")

# 如果想把print的内容也同步到日志里，可以这样做
class PrintToLogger:
    def write(self, msg):
        if msg.strip():  # 跳过空行
            logging.info(msg.strip())
    def flush(self):
        pass

sys.stdout = PrintToLogger()
print("这条print的内容也会被转换成日志记录下来")

这种方法的好处是日志结构清晰，方便后续筛选和分析，你还可以添加控制台输出的handler，实现“既在Notebook显示，又保存到文件”的效果。