本文主要是介绍Python+PyQt5实现文件夹结构映射工具，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
《Python+PyQt5实现文件夹结构映射工具》在日常工作中,我们经常需要对文件夹结构进行复制和备份,本文将带来一款基于PyQt5开发的文件夹结构映射工具,感兴趣的小伙伴可以跟随小编一起学习一下...
概述
在日常工作中，我们经常需要对文件夹结构进行复制和备份，比如仅复制一级目录，或者完整复制多级目录，有时还希望连同文件名及后缀创建空文件。手动操作既费时又容易出错。为了解决这个问题，本文将带来一款基于PyQt5开发的「文件夹结构映射工具」，支持拖拽选取路径，三种复制模式，操作简单直观，极大提升工作效率。
本工具代码精炼，功能实用，界面美观，适合文件管理、项目结构迁移、代码备份等多种场景使用。文章将深入解析程序设计思路、界面布局、功能实现，并附上完整源码下载，方便读者学习和二次开发。
功能亮点
路径拖拽与浏览双重选择：支持从资源管理器拖拽文件夹路径到输入框，也可以点击“浏览”按钮选择目录，操作灵活便捷。
多复制模式支持：
- 仅复制一级目录结构（不进入子文件夹）
- 复制多级目录结构（仅文件夹，无文件）
- 复制多级目录结构并创建空文件（文件名与后缀保持一致）
路径有效性校验：自动检测源路径和目标路径是否合理，防止错误操作。
界面简洁美观：采用淡雅配色和流畅交互，按钮及控件布局合理，使用体验良好。
详细提示反馈：复制完成后弹窗显示创建文件夹数，异常情况及时警告。
展示效果
- 左侧文本框支持拖拽粘贴目录路径
- 右侧按钮可弹出系统文件夹选择窗口
- 中间清晰显示复制模式单选选项
- 右下角“开始映射结构”按钮启动复制
- 复制完成弹窗告知成功与否
软件使用步骤
1.选择源路径
可直接拖拽文件夹至左侧输入框，或点击“浏览”按钮弹出选择窗口，选择想复制的文件夹。
2.选择目标路径
同样支持拖拽或浏览选择，指定复制结果保存位置。注意目标路径不能是源路径的子目录。
3.选择复制模式
- 仅复制一级目录
- 复制多级目录结构，不含文件
- 复制多级目录结构并创建空文件
- 根据需求选择。
4.点击“开始映射结构”
程序将按选定模式复制目录结构。完成后弹窗显示操作结果。
5.查看目标路径
目标路径将生成对应的目录结构（及空文件），验证复制是否正确。
代码解析
1. 主窗口设计（FolderCopyApp）
继承自QWidget，设置窗口标题、尺寸和基础样式，调用init_ui()方法构建界面。
self.setWindowTitle(" 文件夹结构映射工具")
self.setGeometry(300, 300, 600, 350)
self.setStyleSheet("""
background-color: #f4f6f9;
font-family: "Segoe UI";
font-size:14px;
""")
2. 拖拽路径输入框（DropLineEdit）
继承自QLineEdit，重写dragEnterEvent和dropEvent实现路径拖拽识别，提升用户体验。
def dragEnterEvent(self, e):
if e.mimeData().hasUrls():
e.accept()
else:
e.ignore()
def dropEvent(self, e):
if e.mimeData().hasUrls():
path = e.mimeData().urls()[0].toLocalFile()
self.setText(path)
3. 界面布局与控件绑定
使用QvboxLayout整体垂直布局
每个路径输入区用QHBoxLayout横向放置文本框和浏览按钮
复制模式通过QGroupBox和QRadioButton呈现，默认选择一级目录复制
“开始映射结构”按钮绑定复制功能
self.copy_btn.clicked.connect(self.copy_structure)
4. 复制结构核心逻辑
copy_structure函数根据模式执行不同目录复制：
一级目录复制
or name in os.listdir(source):
full_path = os.path.join(source, name)
if os.path.isdir(full_path):
os.makedirs(os.path.join(target, name), exist_ok=True)
多级目录复制
for root, dirs, files in os.walk(source):
rel_path = os.path.relpath(root, source)
target_dir = os.path.join(target, rel_path)
os.makedirs(target_dir, exist_ok=True)
- **多级目录复制 + 空文件**
if mode == "with_files":
for file in files:
open(os.path.join(target_dir, file), 'w').close()
5. 异常处理和提示
校验路径有效性，防止错误操作
捕获异常，弹窗反馈错误
复制完成后提示创建目录数量
源码下载
import sys
import os
from PyQt5.QtWidgets import (
QApplication, QWidget, QLabel, QLineEdit, QPushButton,
QVBoxLayout, QHBoxLayout, QFileDialog, QRadioButton,
QGroupBox, QMessageBox
)
from PyQt5.QtCore import Qt
class DropLineEdit(QLineEdit):
def __init__(self, *args):
super().__init__(*args)
self.setAcceptDrops(True)
def dragEnterEvent(self, e):
if e.mimeData().hasUrls():
e.accept()
else:
e.ignore()
def dropEvent(self, e):
if e.mimeData().hasUrls():
path = e.mimeData().urls()[0].toLocalFile()
self.setText(path)
class FolderCopyApp(QWidget):
def __init__(self):
super().__init__()
self.setWindowTitle(" 文件夹结构映射工具")
self.setGeometry(300, 300, 600, 350)
self.setStyleSheet("""
background-color: #f4f6f9;
font-family: "Segoe UI";
font-size:14px;
""")
self.init_ui()
def init_ui(self):
layout = QVBoxLayout()
# 源路径
source_layout = QHBoxLayout()
self.source_input = DropLineEdit()
browse_source = QPushButton("浏览")
browse_source.setFixedwidth(60)
browse_source.setStyleSheet(self.button_style())
browse_source.clicked.connect(self.select_source)
self.add_field("源路径（拖拽或选择）", self.source_input, browse_source, layout, source_layout)
# 目标路径
target_layout = QHBoxLayout()
self.target_input = DropLineEdit()
browse_target = QPushButton("浏览")
browse_target.setFixedWidth(60)
browse_target.setStyleSheet(self.button_style())
browse_target.clicked.connect(self.select_target)
self.add_field("目标路径（拖拽或选择）", self.target_input, browse_target, layout, target_layout)
# 模式选择
self.mode_group = QGroupBox("选择复制模式")
self.mode_group.setStyleSheet("QGroupBox { font-weight: bold; }")
mode_layout = QVBoxLayout()
self.level1_radio = QRadioButton("仅复制一级目录结构")
self.multilevel_radio = QRadioButton("复制多级目录结构（不含文件）")
self.with_files_radio = QRadioButton("复制多级结构 + 空文件（保留名称与后缀）")
self.level1_radio.setChecked(True)
mode_layout.addWidget(self.level1_radio)
mode_layout.addWidget(self.multilevel_radio)
mode_layout.addWidget(self.with_files_radio)
self.mode_group.setLayout(mode_layout)
layout.addWidget(self.mode_group)
# 操作按钮
self.copy_btn = QPushButton(" 开始映射结构")
self.copy_btn.setStyleSheet(self.button_style())
self.copy_btn.clicked.connect(self.copy_structure)
layout.addWidget(self.copy_btn)
self.setLayout(layout)
def add_field(self, label_text, line_edit, button, layout, sublayout):
label = QLabel(label_text)
label.setStyleSheet("color: #333;")
layout.addWidget(label)
sublayout.addWidget(line_edit)
sublayout.addWidget(button)
layout.addLayout(sublayout)
def button_style(self):
return """
QPushButton {
background-color: #5c9ded;
color: white;
border: none;
padding: 6px 12px;
js border-radius: 4px;
font-family: "Segoe UI", "Roboto", "Helvetica Neue", Arial, sans-serif;
font-weight: bold;
}
QPushButton:hover {
background-color: #468be6;
}
"""
def select_source(self):
path = QFileDialog.getExistingDirectory(self, js"选择源目录")
if path:
self.source_input.setText(path)
def select_target(self):
path = QFileDialog.getExistingDirectory(self, "选择目标目录")
if path:
self.target_input.setText(path)
def copy_structure(self):
source = self.souphprce_input.text().strip()
target = self.target_input.text().strip()
mode = "level1" if self.level1_radio.isChecked() else \
"multilevel" if self.multilevel_radio.isChecked() else "with_files"
if not source or not target:
QMessageBo编程x.warning(self, "错误", "请设置源路径和目标路径")
return
if not os.path.exists(source):
QMessageBox.warning(self, "错误", "源路径无效")
return
if os.path.commonpath([source]) == os.path.commonpath([source, target]):
QMessageBox.warning(self, "错误", "目标路径不能位于源路径内部")
return
try:
created = 0
if mode == "level1":
# 仅复制一级目录结构（直接子文件夹）
for name in os.listdir(source):
full_path = os.path.join(source, name)
if os.path.isdir(full_path):
os.makedirs(os.path.join(target, name), exist_ok=True)
created += 1
else:
for root, dirs, files in os.walk(source):
rel_path = os.path.relpath(root, source)
target_dir = os.path.join(target, rel_path)
os.makedirs(target_dir, exist_ok=True)
created += 1
if mode == "with_files":
for file in files:
try:
open(os.path.join(target_dir, file), 'w').close()
except Exception as fe:
print(f"无法创建文件：{file}, 错误：{fe}")
China编程 QMessageBox.information(self, "完成", f"结构复制完成，创建文件夹数：{created}")
except Exception as e:
QMessageBox.critical(self, "错误", str(e))
if __name__ == "__main__":
app = QApplication(sys.argv)
window = FolderCopyApp()
window.show()
sys.exit(app.exec_())
总结
这款基于PyQt5的「文件夹结构映射工具」功能实用，代码清晰，界面友好，适合所有需要目录结构复制的场景。通过拖拽输入和多复制模式满足不同用户需求。本文不仅介绍了工具功能，还详细剖析了关键代码和实现细节。希望对您学习PyQt5 GUI开发、文件系统操作提供有价值的参考。
到此这篇关于python+PyQt5实现文件夹结构映射工具的文章就介绍到这了,更多相关Python文件夹结构映射内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)！
这篇关于Python+PyQt5实现文件夹结构映射工具的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
