Jupyter Notebook中FileUpload widget如何访问已上传文件供后续代码使用？

版本适配说明 #

ipywidgets不同版本的FileUpload接口差异极大，是最常见的踩坑点，需要根据安装的版本选择对应读取逻辑：

8.x 及以上新版本（当前官方推荐使用的版本） #

• 上传完成后，uploader.value会返回一个元组，每个元素对应当前已上传的一个文件对象，核心可用属性包括：
  • name：上传文件的文件名
  • content：文件的原始二进制字节流，可直接被下游代码使用
  • metadata：文件大小、上传时间等元信息
• 上传单张图片并打印展示的完整示例：

# 导入所需依赖
import io
from PIL import Image
from IPython.display import display

# 读取第一个上传的文件
first_uploaded = uploader.value[0]
# 将二进制流转换为可识别的图片格式
img = Image.open(io.BytesIO(first_uploaded.content))
# 展示打印图片
display(img)

7.x 及更早的老版本 #

• 老版本的uploader.value是字典结构，以文件名为key，对应的值中存储的是base64编码后的文件内容，需要手动解码才能拿到可用的二进制流
• 老版本读取并展示图片的示例：

# 导入所需依赖
import io
import base64
from PIL import Image
from IPython.display import display

# 遍历字典拿到第一个上传的文件信息
for filename, file_detail in uploader.value.items():
    # 手动解码base64内容为原始二进制
    raw_bytes = base64.b64decode(file_detail['content'])
    # 转换为图片并展示
    img = Image.open(io.BytesIO(raw_bytes))
    display(img)
    break

常见扩展操作 #

• 支持多文件上传：初始化组件时添加multiple=True参数即可：

  uploader = widgets.FileUpload(multiple=True)
  

  之后遍历对应版本的文件列表，即可依次处理所有上传的文件。
• 将上传文件保存到本地：直接将获取到的二进制流写入本地文件即可，以新版本为例：

  # 按上传的文件名保存到当前工作目录
  with open(first_uploaded.name, 'wb') as f:
      f.write(first_uploaded.content)
  

• 自动触发上传完成后的处理逻辑：不要在定义组件的代码块中立刻读取uploader.value，因为组件状态更新是异步的，同一代码块运行时还没等用户选完文件，拿到的永远是空值。可以通过observe方法绑定回调，实现文件上传完成后自动执行打印逻辑：

  def on_file_upload(change):
      # 仅监听文件value属性的更新事件
      if change['name'] == 'value':
          # 处理上传的第一个文件
          new_file = change['new'][0]
          img = Image.open(io.BytesIO(new_file.content))
          display(img)
  
  uploader.observe(on_file_upload)
  

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