如何在Kivy Python应用中通过按钮打开系统默认文件资源管理器

核心思路 #

不需要使用Kivy内置的嵌入式文件选择组件，直接调用系统原生的文件选择接口即可实现需求，以下提供两种常用实现方案：

方案1：使用plyer库（推荐，全平台适配） #

plyer是Kivy官方生态提供的跨平台硬件/系统接口调用库，支持Windows、macOS、Linux、安卓、iOS全平台，是移动端开发的首选方案。

• 安装依赖：
  执行命令pip install plyer完成安装。
• 完整实现代码：

from kivymd.app import MDApp
from kivymd.uix.button import MDRaisedButton
from plyer import filechooser

class FileUploadDemo(MDApp):
    def build(self):
        # 直接给MDRaisedButton绑定点击事件回调
        return MDRaisedButton(
            text="选择上传文件",
            on_press=self.open_system_file_picker
        )

    def open_system_file_picker(self, button_instance):
        # 调用系统原生文件选择器
        selected = filechooser.open_file(
            title="请选择要上传的文件",
            # 可自定义文件类型过滤规则
            filters=[("文档文件", "*.docx", "*.pdf"), ("图片文件", "*.jpg", "*.png")],
            multiple=False # 设为True可开启多选
        )
        # 处理选中的文件
        if selected:
            target_file_path = selected[0]
            print(f"选中的文件路径：{target_file_path}")
            # 此处填入你的文件上传逻辑即可

if __name__ == "__main__":
    FileUploadDemo().run()

方案2：使用内置tkinter实现（仅桌面端可用，无需额外安装依赖） #

如果仅开发桌面端应用，可以直接用Python内置的tkinter文件对话框实现，不需要安装第三方库。

• 完整实现代码：

from kivymd.app import MDApp
from kivymd.uix.button import MDRaisedButton
import tkinter as tk
from tkinter import filedialog

# 初始化tkinter并隐藏默认主窗口，避免弹出空白窗口
tk_root = tk.Tk()
tk_root.withdraw()

class FileUploadDemo(MDApp):
    def build(self):
        return MDRaisedButton(
            text="选择上传文件",
            on_press=self.open_system_file_picker
        )

    def open_system_file_picker(self, button_instance):
        # 调用系统原生文件选择器
        selected_file = filedialog.askopenfilename(
            title="请选择要上传的文件",
            filetypes=[("所有文件", "*.*"), ("图片文件", "*.png", "*.jpg")]
        )
        # 处理选中的文件
        if selected_file:
            print(f"选中的文件路径：{selected_file}")
            # 此处填入你的文件上传逻辑即可

if __name__ == "__main__":
    FileUploadDemo().run()

注意事项 #

• 若需要选择文件夹而非文件，可将filechooser.open_file替换为filechooser.choose_dir，tkinter版本替换为filedialog.askdirectory
• plyer方案在移动端打包时，需要在buildozer配置中添加文件读写权限才能正常使用

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