如何在Tkinter窗口内嵌入文件浏览器，而非使用独立文件选择对话框？

核心思路 #

• 使用tkinter.PanedWindow实现左右可拖拽分割布局，左侧承载文件树，右侧承载文件内容展示区
• 基于ttk.Treeview组件构建目录树，搭配os模块读取系统目录结构，采用懒加载机制避免首次启动卡顿
• 绑定Treeview的选中事件，触发时判断选中节点类型：如果是文件则读取内容渲染到右侧区域，如果是目录则展开/折叠子节点

可运行示例代码 #

import tkinter as tk
from tkinter import ttk
import os

class FileBrowserApp:
    def __init__(self, root):
        self.root = root
        self.root.title("内嵌文件浏览器演示")
        self.root.geometry("1000x600")

        # 分割布局容器
        self.paned_window = ttk.PanedWindow(root, orient=tk.HORIZONTAL)
        self.paned_window.pack(fill=tk.BOTH, expand=True)

        # 左侧文件浏览器区域
        self.left_frame = ttk.Frame(self.paned_window, width=300)
        self.paned_window.add(self.left_frame)

        # 目录树+滚动条
        self.tree_scroll = ttk.Scrollbar(self.left_frame, orient=tk.VERTICAL)
        self.file_tree = ttk.Treeview(self.left_frame, yscrollcommand=self.tree_scroll.set)
        self.tree_scroll.config(command=self.file_tree.yview)
        self.tree_scroll.pack(side=tk.RIGHT, fill=tk.Y)
        self.file_tree.pack(fill=tk.BOTH, expand=True)

        # 配置Treeview列
        self.file_tree['columns'] = ('path',)
        self.file_tree.column('#0', width=200)
        self.file_tree.column('path', width=0, stretch=tk.NO) # 隐藏绝对路径列
        self.file_tree.heading('#0', text='文件浏览器')

        # 绑定事件
        self.file_tree.bind('<<TreeviewOpen>>', self.load_subdir)
        self.file_tree.bind('<<TreeviewSelect>>', self.show_file_content)

        # 初始化根目录（默认使用当前工作目录，可替换为你需要的路径）
        self.root_path = os.getcwd()
        root_node = self.file_tree.insert('', 'end', text=os.path.basename(self.root_path), values=(self.root_path,))
        self.file_tree.insert(root_node, 'end') # 插入占位符，让目录显示可展开箭头

        # 右侧内容展示区域
        self.right_frame = ttk.Frame(self.paned_window)
        self.paned_window.add(self.right_frame)

        # 内容展示区+滚动条
        self.content_scroll = ttk.Scrollbar(self.right_frame, orient=tk.VERTICAL)
        self.content_text = tk.Text(self.right_frame, yscrollcommand=self.content_scroll.set, wrap=tk.WORD)
        self.content_scroll.config(command=self.content_text.yview)
        self.content_scroll.pack(side=tk.RIGHT, fill=tk.Y)
        self.content_text.pack(fill=tk.BOTH, expand=True)

    def load_subdir(self, event):
        # 懒加载子目录
        selected_node = self.file_tree.focus()
        node_path = self.file_tree.item(selected_node, 'values')[0]
        # 清空原有占位符
        self.file_tree.delete(*self.file_tree.get_children(selected_node))
        try:
            for item in os.listdir(node_path):
                item_full_path = os.path.join(node_path, item)
                is_dir = os.path.isdir(item_full_path)
                # 插入节点
                child_node = self.file_tree.insert(selected_node, 'end', text=item, values=(item_full_path,))
                # 如果是目录，插入占位符
                if is_dir:
                    self.file_tree.insert(child_node, 'end')
        except PermissionError:
            # 无权限访问的目录跳过
            pass

    def show_file_content(self, event):
        selected_node = self.file_tree.focus()
        if not selected_node:
            return
        node_path = self.file_tree.item(selected_node, 'values')[0]
        if os.path.isfile(node_path):
            # 清空原有内容
            self.content_text.delete(1.0, tk.END)
            try:
                # 仅演示文本文件读取，其他类型文件可自行扩展渲染逻辑
                with open(node_path, 'r', encoding='utf-8', errors='ignore') as f:
                    content = f.read()
                self.content_text.insert(1.0, content)
            except:
                self.content_text.insert(1.0, "该文件不是文本格式，无法直接预览")

if __name__ == "__main__":
    root = tk.Tk()
    app = FileBrowserApp(root)
    root.mainloop()

扩展提示 #

• 如需给目录/文件添加图标，可引入Pillow库加载对应图标，调用tree.insert()时传入image参数即可
• 当前仅支持文本文件预览，如需支持图片、表格等格式，可替换右侧的Text组件为对应渲染组件
• 可增加文件后缀过滤逻辑，在os.listdir遍历后过滤掉不需要展示的文件类型

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