在Jupyter Notebook中封装视频显示函数后调用无输出且报错

嘿，我碰到过好多次这种情况！把Jupyter里的视频显示代码封装成函数后没反应，大概率是这几个原因，咱一个个来解决：

1. 函数没正确触发视频渲染 #

这是最常见的坑！直接在单元格里写Video("xxx.mp4")时，Jupyter会自动渲染这个对象，但放到函数里就不一样了——函数内部的对象如果不主动输出或返回，Jupyter根本不会理它。

解决方法二选一： #

• 方法1：用display()显式渲染
  在函数里调用display()把视频对象推给Jupyter的输出系统：

  from IPython.display import Video, display
  
  def show_mp4(video_path):
      # embed=True是关键，确保视频嵌入显示而非跳转到外部链接
      video = Video(video_path, embed=True)
      display(video)
  

• 方法2：让函数返回视频对象
  调用函数时直接输出返回值，Jupyter会自动渲染：

  from IPython.display import Video
  
  def show_mp4(video_path):
      return Video(video_path, embed=True)
  
  # 调用时直接写这行，别加print或者赋值后不管它
  show_mp4("test.mp4")
  

2. 视频路径搞混了 #

如果你的函数放在单独的模块文件里，相对路径的基准是当前Jupyter Notebook的工作目录，不是模块所在的目录！很容易出现“本地跑的通，导入模块就找不到文件”的情况。

解决方法： #

把路径转成绝对路径，同时加个文件存在检查，避免踩坑：

import os
from IPython.display import Video, display

def show_mp4(video_path):
      # 把输入路径转换成绝对路径，统一基准
      abs_video_path = os.path.abspath(video_path)
      # 先检查文件是否存在，提前报错
      if not os.path.isfile(abs_video_path):
          print(f"Error: 找不到视频文件 - {abs_video_path}")
          return
      video = Video(abs_video_path, embed=True)
      display(video)

3. 依赖或编码不兼容 #

有时候视频能在本地播放器打开，但Jupyter里显示不出来，可能是编码或依赖的问题：

• 确保你装了ffmpeg：Jupyter处理视频依赖它来解码，用conda安装最稳妥：conda install -c conda-forge ffmpeg，或者用pip装ffmpeg-python：pip install ffmpeg-python
• 检查视频编码：优先用H.264编码的MP4，这是所有浏览器都支持的格式，其他编码可能会被Jupyter拒绝渲染。

4. 模块导入的小细节 #

如果函数放在单独的.py文件里，要确保模块能被正确导入：

• 把模块和Jupyter Notebook放在同一个目录下，直接用from 模块名 import show_mp4导入
• 如果模块在子目录，要给子目录加个__init__.py文件，或者把模块路径加到Python的搜索路径里。

完整可运行的例子 #

把下面的代码保存成video_utils.py：

import os
from IPython.display import Video, display

def show_mp4(video_path, width=640, height=480):
    """在Jupyter Notebook中嵌入显示MP4视频
    参数:
        video_path: 视频文件的路径（相对或绝对）
        width/height: 显示的视频尺寸
    """
    abs_path = os.path.abspath(video_path)
    if not os.path.exists(abs_path):
        print(f"错误：视频文件不存在 -> {abs_path}")
        return
    video = Video(abs_path, embed=True, width=width, height=height)
    display(video)

然后在Jupyter Notebook里调用：

from video_utils import show_mp4

# 替换成你的视频路径
show_mp4("my_video.mp4", width=800)

内容的提问来源于stack exchange，提问作者thescoop