【传奇开心果系列】基于Flet框架实现的文件选择文件保存和目录选择的样例自定义模板特色和实现原理深度解析

一、效果展示截图

二、应用场景介绍

它是一个使用 Flet 框架开发的小型桌面应用，主要功能是提供文件选择、文件保存和目录选择的对话框。该应用适用于以下几种场景：

1. 文件选择：用户可以选择一个或多个文件，并获取这些文件的路径。
2. 文件保存：用户可以选择一个文件保存的位置，并获取保存的文件路径。
3. 目录选择：用户可以选择一个目录，并获取该目录的路径。

三、特色说明

1. 多模式支持：

   • 文件选择：支持单选和多选文件。
   • 文件保存：支持选择文件保存位置。
   • 目录选择：支持选择目录。

2. 用户界面友好：

   • 使用 ElevatedButton 和 Text 组件构建简洁的用户界面。
   • 每个按钮都有相应的图标，增强用户体验。

3. 事件处理：

   • 通过 FilePickerResultEvent 处理文件选择、文件保存和目录选择的结果。
   • 结果会实时更新到界面上的 Text 组件中。

4. 跨平台：

   • Flet 框架支持跨平台开发，可以在 Windows、macOS 和 Linux 上运行。

5. 代码结构清晰：

   • 代码逻辑清晰，每个功能模块独立，易于维护和扩展。

6. 禁用 Web 模式：

   • 在 Web 模式下，文件保存和目录选择按钮会被禁用，确保应用在不同环境下的兼容性。

四、示例代码解读和运行应用

1. 文件选择：

pick_files_dialog = FilePicker(on_result=pick_files_result)
selected_files = Text()def pick_files_result(e: FilePickerResultEvent):selected_files.value = (", ".join(map(lambda f: f.name, e.files)) if e.files else "Cancelled!")selected_files.update()

2. 文件保存：

save_file_dialog = FilePicker(on_result=save_file_result)
save_file_path = Text()def save_file_result(e: FilePickerResultEvent):save_file_path.value = e.path if e.path else "Cancelled!"save_file_path.update()

3. 目录选择：

get_directory_dialog = FilePicker(on_result=get_directory_result)
directory_path = Text()def get_directory_result(e: FilePickerResultEvent):directory_path.value = e.path if e.path else "Cancelled!"directory_path.update()

4. 运行应用

要运行这个应用，确保你已经安装了 Flet 框架。可以使用以下命令安装 Flet：

pip install flet

然后运行脚本：

python c:\Users\lxmcq\Desktop\file-picker-all-modes.py

五、Flet 文件选择器项目深度解析

下面我将详细解析这个Flet文件选择器项目的实现原理，涵盖文件操作、对话框管理、事件处理等核心机制。

（一）完整代码结构分析

import flet
from flet import (ElevatedButton,FilePicker,FilePickerResultEvent,Page,Row,Text,icons,
)

（二）核心实现原理深度解析

1. 文件选择器架构设计

文件选择器的三种模式：

# 1. 文件选择模式
pick_files_dialog = FilePicker(on_result=pick_files_result)# 2. 文件保存模式  
save_file_dialog = FilePicker(on_result=save_file_result)# 3. 目录选择模式
get_directory_dialog = FilePicker(on_result=get_directory_result)

解析：

FilePicker 类的作用：

• 封装了原生系统的文件对话框功能
• 提供统一的跨平台文件操作接口
• 支持异步事件回调机制

事件驱动架构：

用户点击按钮 → 打开系统对话框 → 用户选择 → 
FilePickerResultEvent触发 → 回调函数执行 → UI更新

2. 文件选择功能深度解析

def pick_files_result(e: FilePickerResultEvent):selected_files.value = (", ".join(map(lambda f: f.name, e.files)) if e.files else "Cancelled!")selected_files.update()pick_files_dialog = FilePicker(on_result=pick_files_result)
selected_files = Text()# 按钮触发
ElevatedButton("Pick files",icon=icons.UPLOAD_FILE,on_click=lambda _: pick_files_dialog.pick_files(allow_multiple=True),
)

解析：

事件对象结构：

FilePickerResultEvent 包含：
- e.files: 选择的文件列表（每个文件有path, name等属性）
- e.path: 文件保存路径或目录路径

数据处理逻辑：

# 使用map和lambda处理文件列表
", ".join(map(lambda f: f.name, e.files))
# 等价于：
file_names = []
for file in e.files:file_names.append(file.name)
result = ", ".join(file_names)

多文件选择机制：

• allow_multiple=True：允许选择多个文件
• 用户可以通过Ctrl+点击或拖拽选择多个文件
• 返回的文件列表保持选择顺序

3. 文件保存功能深度解析

def save_file_result(e: FilePickerResultEvent):save_file_path.value = e