如何为Jupyter的ipywidget FileUpload组件指定初始打开目录

前置说明 #

ipywidgets的FileUpload组件本质是封装了浏览器原生的<input type="file">标签，受浏览器安全沙箱限制，前端代码无权指定文件选择框的默认打开目录，所以官方没有提供对应配置参数，找不到相关参数是正常情况。

方案1：使用ipyfilechooser（兼容ipywidgets生态） #

该组件是ipywidgets生态的专用文件选择工具，运行在内核侧，可以直接读取本地文件系统，支持指定初始目录、后缀筛选，交互逻辑和ipywidgets完全一致。

• 安装命令：pip install ipyfilechooser
• 使用示例代码：

import ipywidgets as widgets
from ipyfilechooser import FileChooser

# 替换成你常用的初始目录路径
fc = FileChooser('C:/your/common/starting/path')
# 限制仅显示json文件
fc.filter_pattern = '*.json'
# 单选模式
fc.select_default = False

# 自定义选中文件后的回调逻辑
def on_file_selected(chooser):
    # 获取选中的文件全路径
    selected_file = chooser.selected
    # 直接读取文件内容即可
    with open(selected_file, 'r', encoding='utf-8') as f:
        content = f.read()
    # 后续处理逻辑
    print(f"已加载文件：{selected_file}")

fc.register_callback(on_file_selected)
# 显示组件
display(fc)

方案2：使用系统原生文件选择框（无需额外前端组件） #

你是本地Windows环境运行Jupyter，可以直接调用Python内置的tkinter库弹出系统原生的文件选择框，完全支持指定初始目录，实现更简单：

import tkinter as tk
from tkinter import filedialog
import json

# 初始化tk，隐藏主窗口
root = tk.Tk()
root.withdraw()
# 置顶窗口避免被Jupyter页面遮挡
root.wm_attributes('-topmost', 1)

# 弹出文件选择框，指定初始目录和文件类型
file_path = filedialog.askopenfilename(
    initialdir="C:/your/common/starting/path",
    filetypes=[("JSON文件", "*.json")],
    title="选择要加载的JSON文件"
)

# 读取选中的文件
if file_path:
    with open(file_path, 'r', encoding='utf-8') as f:
        data = json.load(f)
    print(f"文件加载完成，路径：{file_path}")

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