基于Python打造高效便捷的目录结构生成器

目录

• 1.概述
• 2.功能亮点
• 3. 功能使用
• 3.运行效果
• 4. 相关源码
• 5. 总结

1.概述

随着文件和目录管理的复杂性不断增加，尤其是在处理大量项目文件和文件夹时，手动管理和查看目录结构变得越来越繁琐。在这个背景下，我们开发了一款 目录结构生成器，它不仅能够帮助用户高效地生成文件夹目录结构，还具备了很多智能化的功能，如文件大小格式化、Excel 导出、拖拽操作以及动态进度条等，极大提升了文件管理的效率。

本文将深入介绍该工具的功能，帮助大家更好地理解并利用它来优化自己的工作流程。

2.功能亮点

1. 目录结构生成

该工具能够遍历指定的文件夹，自动生成该文件夹下所有子文件夹和文件的目录结构。对于每个文件和文件夹，系统会自动获取其名称、大小以及其他必要的属性，并以表格的形式进行展示。

2. 文件大小格式化

通过对文件大小的自动转换，工具能够将字节数（Bytes）转换为更直观的单位，如 KB、MB、GB 等，极大提升了可读性。

3. 支持 Excel 导出

生成的目录结构可以轻松导出为 Excel 文件，支持动态设置 Excel 文件中工作表的名称，并且可以一键点击打开文件所在目录，便于快速访问。

4. 动态进度条与反馈提示

在生成目录结构的过程中，工具会提供进度条，显示当前操作的完成情况。用户能够清晰地看到操作进度，而在操作完成时，工具还会弹出“导出成功”提示，提升了用户体验。

5. 拖拽操作与美化效果

新增的拖拽区域高亮效果，让用户在拖拽目录时能够更加直观地看到拖拽的目标区域，从而提升操作的准确性和流畅性。

6. 文件图标预览

工具还增加了对 Windows 系统的支持，能够展示文件的图标预览。通过 PyQt6 中的 QIconProvider，让目录中的每个文件都能展现出图标样式，进一步优化了可视化效果。

3. 功能使用

1. 界面设计与操作

该工具的核心界面设计非常简洁，所有操作都集成在一个窗口中，用户可以非常轻松地完成以下任务：

• 选择目标文件夹：点击“选择文件夹”按钮，选择需要生成目录结构的文件夹路径。
• 拖拽操作：在界面的拖拽区域内，用户可以通过拖拽文件夹来快速选择文件夹并自动加载目录结构。
• 查看目录结构：生成的目录结构会以树形结构展示，左侧为文件夹树状图，右侧则展示文件的详细信息（如文件大小、文件类型等）。
• 文件大小显示：文件大小将自动格式化，用户能够清晰地看到文件的大小（如：1.5MB、2GB等）。
• 导出 Excel 文件：点击“导出 Excel”按钮，工具会将当前目录结构生成 Excel 文件。文件生成后，用户可以选择打开文件所在的文件夹。
• 进度反馈：每当操作开始时，工具会显示进度条，完成时会弹出“导出成功”的提示。

2. 高级功能操作

拖拽目录与文件结构生成

为了让用户操作更加便捷，我们特别加入了拖拽操作功能。用户只需要将文件夹拖拽到工具界面的指定区域，工具就会自动加载该文件夹内的目录结构，并以树形方式展示出来。这种方式对于需要快速查看文件夹内容的用户来说，无疑是极大的提升。

导出 Excel 文件

生成目录结构后，用户可以选择将当前目录结构导出为 Excel 文件。导出的文件将包含所有文件夹和文件的相关信息，如文件名、文件路径、文件大小等，并且工具会自动将工作表命名为“目录结构”，方便用户区分。

文件图标预览

对于 Windows 系统用户，工具可以根据每个文件的类型，显示文件的图标。比如，文本文件会显示一个 TXT 图标，图片文件会显示图片缩略图。通过 QIconProvider，文件图标得以自动提取，并显示在界面上，帮助用户快速识别文件类型。

动态进度条与操作提示

在整个操作过程中，用户可以实时查看进度条，工具会根据文件夹大小和文件数量动态更新进度。当生成目录结构或导出 Excel 完成时，用户会收到一个“导出成功”的提示框，极大地增强了用户体验。

3.运行效果

4. 相关源码

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

import sys
import os
import pandas as pd
import time
import logging
from datetime import datetime
from PyQt6.QtWidgets import (
    QApplication, QWidget, QPushButton, QvboxLayout, QLabel, 
    QFileDialog, QLineEdit, QTextEdit, QProgressBar, QMessageBox,
    QCheckBox, QToolTip, QMenu, QHBoxLayout
)
from PyQt6.QtCore import Qt, QThread, pyqtSignal, QPropertyAnimation, QEasingCurve
from PyQt6.QtGui import QIcon, QPixmap

logging.basicConfig(filename='scanner.log', level=logging.INFO)

class PathTextEdit(QTextEdit):
    """支持拖放文件夹并显示纯路径的自定义文本框"""
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setAcceptDrops(True)
        self.setPlaceholderText("拖拽文件夹到此处或点击浏览按钮")
        self.setMinimumHeight(80)
    
    def dragEnterEvent(self, event):
        if any(url.isLocalFile() and os.path.isdir(url.toLocalFile())
               for url in event.mimeData().urls()):
            self.setStyleSheet("border: 2px dashed #0078D7; background-color: #F0F7FF;")
            event.acceptProposedAction()
        else:
            event.ignore()
    
    def dragLeaveEvent(self, event):
        self.setStyleSheet("border: 2px dashed #9E9E9E; background-color: #FAFAFA;")
        event.accept()
    
    def dropEvent(self, event):
        self.setStyleSheet("border: 1px solid #CCCCCC; background-color: white;")
        valid_paths = []
        for url in event.mimeData().urls():
            if url.isLocalFile():
                path = url.toLocalFile()
                if os.path.isdir(path):
                    valid_paths.append(path)
        
        if valid_paths:
            self.setText("\n".join(valid_paths))
            event.accept()
        else:
            QToolTip.showText(event.pos(), "请拖入有效的文件夹", self)
            event.ignore()
    
    def contextMenuEvent(self, event):
        menu = QMenu(self)
        clear_action = menu.addAction(QIcon("icons/clear.png"), "清空") if os.path.exists("icons/clear.png") else menu.addAction("清空")
        paste_action = menu.addAction(QIcon("icons/paste.png"), "粘贴路径") if os.path.exists("icons/paste.png") else menu.addAction("粘贴路径")
        action = menu.exec(event.globalPos())
        if action == clear_action:
            self.clear()
        elif action == paste_action:
            self.paste()

class DirectoryScanner(QThread):
    progress = pyqtSignal(int, int, float)
    completed = pyqtSignal(list)
    error = pyqtSignal(str)
    
    def __init__(self, directory, file_types):
        super().__init__()
        self.directory = directory
        self.file_types = file_types
        self._is_running = True
    
    def stop(self):
        self._is_running = False
    
    def run(self):
        try:
            file_data = []
            total_files = sum(len(files) for _, _, files in os.walk(self.directory))
            processed_files = 0
            start_time = time.time()
            
            for root, _, files in os.walk(self.directory):
                if not self._is_running:
                    break
                
                for file in files:
                    if self.file_types and not any(file.lower().endswith(ft.lower()) for ft in self.file_types if ft):
                        continue
                    
                    try:
                        file_path = os.path.join(root, file)
                        file_stat = os.stat(file_path)
                        file_data.append([
                            root, file, os.path.splitext(file)[1], os.path.getsize(file_path),
                            time.ctime(file_stat.st_mtime), time.ctime(file_stat.st_ctime), file_path
                        ])
                    except Exception as e:
                        logging.error(f"Error processing {file_path}: {str(e)}")
                        continue
                    
                    processed_files += 1
                    elapsed_time = time.time() - start_time
                    estimated_total_time = (elapsed_time / processed_files) * total_files if processed_files else 0
                    remaining_time = max(0, estimated_total_time - elapsed_time)
                    self.progress.emit(processed_files, total_files, remaining_time)
            
            if self._is_running:
                self.completed.emit(file_data)
        except Exception as e:
            self.error.emit(f"扫描过程中出错: {str(e)}")

class DirectoryScannerApp(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()
        self.setup_animations()
    
    def initUI(self):
        self.setWindowTitle("目录结构生成器")
        self.setGeometry(100, 100, 650, 550)
        
        # 主布局
        self.main_layout = QVBoxLayout()
        self.main_layout.setSpacing(15)
        self.main_layout.setContentsMargins(20, 20, 20, 20)
        
        # 标题区域
        title_layout = QHBoxLayout()
        self.title_icon = QLabel()
        if os.path.exists("icons/folder.png"):
            self.title_icon.setPixmap(QPixmap("icons/folder.png").scaled(32, 32))
        title_layout.addwidget(self.title_icon)
        
        self.title_label = QLabel("目录结构生成器")
        self.title_label.setStyleSheet("font-size: 18pt; font-weight: bold; color: #0078D7;")
        title_layout.addWidget(self.title_label)
        title_layout.addStretch()
        self.main_layout.addLayout(title_layout)
        
        # 目录选择部分
        self.dir_group = QWidget()
        dir_layout = QVBoxLayout()
        
        self.dir_label = QLabel("选择扫描目录:")
        dir_layout.addWidget(self.dir_label)
        
        self.directory_input = PathTextEdit()
        dir_layout.addWidget(self.directory_input)
        
        self.browse_button = QPushButton(" 浏览目录")
        if os.path.exists("icons/folder_open.png"):
            self.browse_button.setIcon(QIcon("icons/folder_open.png"))
        self.browse_button.clicked.connect(self.browse_directory)
        dir_layout.addWidget(self.browse_button)
        
        self.dir_group.setLayout(dir_layout)
        self.main_layout.addWidget(self.dir_group)
        
        # 过滤选项部分
        self.filter_group = QWidget()
        filter_layout = QVBoxLayout()
        
        self.filter_label = QLabel("文件类型过滤:")
        filter_layout.addWidget(self.filter_label)
        
        self.filter_input = QLineEdit()
        self.filter_input.setPlaceholderText("例如: .txt,.docx,.xlsx")
        filter_layout.addWidget(self.filter_input)
        
        self.filter_group.setLayout(filter_layout)
        self.main_layout.addWidget(self.filter_group)
        
        # 选项设置
        self.options_group = QWidget()
        options_layout = QVBoxLayout()
        
        self.checkbox_size = QCheckBox("显示友好文件大小（KB/MB）")
        self.checkbox_open = QCheckBox("导出后自动打开文件")
        options_layout.addWidget(self.checkbox_size)
        options_layout.addWidget(self.checkbox_open)
        
        self.options_group.setLayout(options_layout)
        self.main_layout.addWidget(self.options_group)
        
        # 操作按钮
        self.generate_button = QPushButton(" 生成Excel文件")
        if os.path.exists("icons/excel.png"):
            self.generate_button.setIcon(QIcon("icons/excel.png"))
        self.generate_button.clicked.connect(self.generate_excel)
        self.main_layout.addWidget(self.generate_button)
    www.devze.com    
        # 进度显示
        self.progress_bar = QProgressBar()
        self.progress_bar.setTextVisible(True)
        self.main_layout.addWidget(self.progress_bar)
        
        # 状态栏
        self.status_bar = QHBoxLayout()
        self.status_icon = QLabel()
        if os.path.exists("icons/info.png"):
            self.status_icon.setPixmap(QPixmap("icons/info.png").scaled(16, 16))
        self.status_bar.addWidget(self.status_icon)
        
        self.status_label = QLabel("就绪")
        self.status_bar.addWidget(self.status_label)
        self.status_bar.addStretch()
        
        self.version_label = QLabel(f"探客白泽  {datetime.now().year}")
        self.status_bar.addWidget(self.version_label)
        self.main_layout.addLayout(self.status_bar)
        
        self.setLayout(self.main_layout)
        self.apply_stylesheet()
    
    def setup_animations(self):
        self.animations = {}
        for btn in [self.browse_button, self.generate_button]:
            animation = QPropertyAnimation(btn, b"geometry")
            animation.setDuration(200)
            animation.setEasingCurve(QEasingCurve.Type.OutQuad)
            self.animations[btn] = animation
            
            def make_animator(button):
                return lambda: self.animate_button(button)
            
            btn.clicked.connect(make_animator(btn))
    
    def animate_button(self, button):
        animation = self.animations[button]
        orig_rect = button.geometry()
        animation.setStartValue(orig_rect.adjusted(0, 5, 0, 5))
        animation.setEndValue(orig_rect)
        animation.start()
    
    def apply_stylesheet(self):
        self.setStyleSheet("""
            /* 主窗口样式 */
            QWidget {
                font-family: 'Microsoft YaHei', 'Segoe UI';
                font-size: 10pt;
                background-color: #F5F5F5;
            }
            
            /* 分组框样式 */
            QWidget#dir_group, QWidget#filter_group, QWidget#options_group {
                background-color: white;
                border-radius: 6px;
                padding: 12px;
            }
            
            /* 标签样式 */
            QLabel {
                color: #333333;
                font-weight: 500;
            }
            
            /* 输入框样式 */
            QTextEdit, QLineEdit {
                background-color: white;
                border: 1px solid #CCCCCC;
                border-radius: 4px;
                padding: 8px;
                selection-background-color: #0078D7;
            }
            
            QTextEdit:hover, QLineEdit:hover {
                border: 1px solid #0078D7;
            }
            
            /* 按钮基础样式 */
            QPushButton {
                color: white;
                border: none;
                border-radius: 6px;
                padding: 10px 18px;
                min-width: 100px;
                font-weight: 500;
            }
            
            /* 浏览按钮样式 */
            QPushButton#browse_button {
                background-color: #4CAF50;
            }
            
            QPushButton#browse_button:hover {
                background-color: #3E8E41;
            }
            
            QPushButton#browse_button:pressed {
                background-color: #2E7D32;
            }
            
            /* 生成按钮样式 */
            QPushButton#generate_button {
                background-color: #FF5722;
                font-weight: bold;
            }
            
            QPushButton#generate_button:hover {
                background-color: #E64A19;
            }
            
            QPushButton#generate_button:pressed {
                background-color: #BF360C;
            }
            
            /* 进度条样式 */
            QProgressBar {
                border: 1px solid #CCCCCC;
                border-radius: 4px;
                text-align: center;
                height: 24px;
            }
            
            QProgressBar::chunk {
                background-color: #4CAF50;
                border-radius: 3px;
            }
            
            /* 复选框样式 */
            QCheckBox {
                spacing: 8px;
                color: #333333;
            }
            
            QCheckBox::indicator {
                width: 18px;
                height: 18px;
            }
            
            QCheckBox::indicator:unchecked {
                border: 1px solid #CCCCCC;
                background: white;
                border-radius: 3px;
            }
            
            QCheckBox::indicator:checked {
                border: 1px solid #0078D7;
                background: #0078D7;
                border-radius: 3px;
            }
            
            /* 状态栏样式 */
            QLabel#version_label {
                color: #666666;
                font-size: 9pt;
            }
        """)
        
        # 设置对象名用于样式选择
        self.browse_button.setObjectName("browse_button")
        self.generate_button.setObjectName("generate_button")
        self.version_label.setObjectName("version_label")
        self.dir_group.setObjectName("dir_group")
        self.filter_group.setObjectName("filter_group")
        self.options_group.setObjectName("options_group")
    
    def browse_directory(self):
        directory = QFileDialog.getExistingDirectory(self, "选择目录")
        if directory:
            self.directory_input.setText(directory)
            self.status_label.setText(f"已选择目录: {directory[:50]}..." if len(directory) > 50 else directory)
    
    def generate_excel(self):
        directory = self.directory_input.toPlainText().strip()
        file_types = [ft.strip() for ft in self.filter_input.text().split(',') if ft.strip()]
        
        if not directory or not os.path.isdir(directory):
            QMessageBox.warning(self, "错误", "请选择有效的目录！")
            return
        
        default_name = f"目录结构_{datetime.now().strftime('%Y%m%d_%H%M%S')}.xlsx"
        save_path, _ = QFileDialopythong.getSaveFileName(
            self, "保存 Excel 文件", 
            default_name, 
            "Excel Files (*.xlsx)"
        )
        
        if not save_path:
            return
        
        self.scanner = DirectoryScanner(directory, file_types)
        self.scanner.progress.connect(self.update_progress)
        self.scanner.completed.connect(lambda data: self.save_to_excel(data, save_path))
        self.scanner.error.connect(self.show_error)
        self.generate_button.setEnabled(False)
        self.status_label.setText("正在扫描目录...")
        self.status_icon.setPixmap(QPixmap("icons/loading.png").scaled(16, 16)) if os.path.exists("icons/loading.png") else None
        self.scanner.start()
    
    def update_progress(self, processed, total, remaining_time):
        self.progress_bar.setMaximum(total)
        self.progress_bar.setValue(processed)
        
        progress_percent = processed / total * 100
        status_text = (
            f"扫描进度: {progress_percent:.1f}% | "
            f"已处理: {processed}/{total} | "
            f"剩余时间: {remaining_time:.0f}秒"
        )
        self.status_label.setText(status_text)
    
    def save_to_excel(self, file_data, save_path):
        try:
            df = pd.DataFrame(file_data, columns=[
                "目录路径", "文件名", "类型", "大小(B)", "修改日期", "创建时间", "文件位置"
            ])
            
            # 添加人性化大小显示
            if self.checkbox_size.isChecked():
                df["大小"] = df["大小(B)"].apply(
                    lambda x: f"{x/1024:.2f}KB" if x < 1024*1024 else f"{x/1024/1024:.2f}MB"
                )
            
            # 添加超链接
            df["文件位置"] = df["文件位置"].apply(lambda x: f'=HYperlINK("{x}", " 打开")')
            
            with pd.ExcelWriter(save_path, engine='xlsxwriter') as writer:
                df.to_excel(writer, index=False, sheet_name='目录结构')
                
                workbook = writer.book
                worksheet = writer.sheets['目录结构']
                
            php    # 设置列宽
                col_widths = {
                    "目录路径": 40, "文件名": 30, "类型": 10, 
                    "大小(B)": 15, "大小": 15, "修改日期": 20,
                  http://www.devze.com  "创建时间": 20, "文件位置": 15
                }
                
                for idx, col in enumerate(df.columns):
                    worksheet.set_column(idx, idx, col_widths.get(col, 15))
                
                # 添加冻结窗格和自动筛选
                worksheet.autofilter(0, 0, 0, len(df.columns)-1)
                worksheet.freeze_panes(1, 0)
  python          
            self.status_label.setText(f"导出成功: {os.path.basename(save_path)}")
            self.status_icon.setPixmap(QPixmap("icons/success.png").scaled(16, 16)) if os.path.exists("icons/success.png") else None
            
            if self.checkbox_open.isChecked():
                try:
                    if sys.platform == "win32":
                        os.startfile(save_path)
                    elif sys.platform == "darwin":
                        os.system(f'open "{save_path}"')
                    else:
                        os.system(f'xdg-open "{save_path}"')
                except Exception as e:
                    logging.error(f"无法打开文件: {str(e)}")
        
        except Exception as e:
            self.show_error(f"生成Excel时出错:\n{str(e)}")
            logging.error(f"Excel导出错误: {str(e)}")
        
        finally:
            self.generate_button.setEnabled(True)
            self.progress_bar.reset()
    
    def show_error(self, message):
        QMessageBox.critical(self, "错误", message)
        self.status_label.setText("操作失败")
        self.status_icon.setPixmap(QPixmap("icons/error.png").scaled(16, 16)) if os.path.exists("icons/error.png") else None
        self.generate_button.setEnabled(True)
    
    def closeEvent(self, event):
        if hasattr(self, 'scanner') and self.scanner.isRunning():
            self.scanner.stop()
            self.scanner.wait()
        event.accept()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    app.setStyle('Fusion')
    
    # 设置应用程序图标
    if os.path.exists("icons/app_icon.png"):
        app.setWindowIcon(QIcon("icons/app_icon.png"))
    
    window = DirectoryScannerApp()
    window.show()
    sys.exit(app.exec())

5. 总结

1. 整体优化

目录结构生成器 v3.0 在原有版本的基础上，进行了多项优化和功能扩展。尤其是在界面美化和操作便捷性方面，加入了拖拽操作、文件图标预览等细节，使得工具的使用体验更加流畅和直观。

2. 性能提升

除了界面和功能的提升，工具在处理大量文件和目录时的性能也得到了优化。通过合理的进度反馈和动态颜色变化的进度条，用户能够清晰地感受到操作的进展，不会在等待过程中产生焦虑。

3. 实际应用

该工具非常适合需要管理大量文件或处理复杂目录结构的用户，尤其对于开发人员、IT运维人员、文档管理员等群体而言，它可以显著提高工作效率。通过自动生成目录结构和文件大小显示，再结合 Excel 导出功能，用户能够轻松导出目录数据并进行后续处理或备份。

以上就是基于Python打造高效便捷的目录结构生成器的详细内容，更多关于Python目录结构生成器的资料请关注编程客栈(www.devze.com)其它相关文章！