Python結(jié)合PyQt5實現(xiàn)目錄文件掃描與導(dǎo)出工具
更新時間：2026年02月07日 08:51:28 作者：老歌老聽老掉牙
這篇文章主要為大家詳細(xì)介紹了Python如何結(jié)合PyQt5實現(xiàn)一個簡單的目錄文件掃描與導(dǎo)出工具,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以了解下
本文將詳細(xì)介紹如何使用 Python 和 PyQt5 創(chuàng)建一個功能完整的目錄文件掃描器。該工具能夠選擇目錄、遞歸掃描所有文件、以樹形結(jié)構(gòu)展示結(jié)果，并將文件列表導(dǎo)出為文本文件。
核心功能實現(xiàn)
效果如下
1. 主窗口與界面設(shè)計
"""
文件掃描器主程序
功能：選擇目錄、掃描文件、樹形展示、導(dǎo)出TXT
作者：智能助手
日期：2024年1月24日
"""
import os
import sys
from pathlib import Path
from datetime import datetime
from PyQt5.QtCore import Qt, QThread, pyqtSignal, QSize
from PyQt5.QtGui import QFont, QColor, QIcon, QPalette, QLinearGradient
from PyQt5.QtWidgets import *
class FileScannerApp(QMainWindow):
"""主應(yīng)用程序窗口，負(fù)責(zé)界面布局和功能協(xié)調(diào)"""
def __init__(self):
super().__init__()
self.current_dir = ""
self.file_list = []
self.scanner = None
self._setup_ui()
self._setup_styles()
self.setWindowTitle("文件掃描器")
self.setGeometry(100, 100, 1000, 700)
def _setup_ui(self):
"""初始化用戶界面"""
central_widget = QWidget()
self.setCentralWidget(central_widget)
main_layout = QVBoxLayout(central_widget)
main_layout.setSpacing(10)
main_layout.setContentsMargins(15, 15, 15, 15)
# 標(biāo)題
title_label = QLabel("?? 目錄文件掃描器")
title_label.setStyleSheet("font-size: 20px; font-weight: bold; color: #2c3e50;")
title_label.setAlignment(Qt.AlignCenter)
main_layout.addWidget(title_label)
# 目錄選擇區(qū)域
dir_group = QGroupBox("目錄設(shè)置")
dir_layout = QHBoxLayout()
self.dir_label = QLabel("未選擇目錄")
self.dir_label.setStyleSheet("color: #7f8c8d; padding: 5px; border: 1px solid #ddd; border-radius: 3px;")
self.dir_label.setMinimumHeight(30)
self.browse_btn = QPushButton("選擇目錄")
self.browse_btn.setFixedWidth(100)
self.browse_btn.clicked.connect(self.select_directory)
dir_layout.addWidget(self.dir_label, 1)
dir_layout.addWidget(self.browse_btn)
dir_group.setLayout(dir_layout)
main_layout.addWidget(dir_group)
# 控制按鈕區(qū)域
control_group = QGroupBox("操作控制")
control_layout = QHBoxLayout()
self.scan_btn = QPushButton("?? 開始掃描")
self.scan_btn.setFixedWidth(120)
self.scan_btn.clicked.connect(self.start_scan)
self.scan_btn.setEnabled(False)
self.stop_btn = QPushButton("? 停止")
self.stop_btn.setFixedWidth(100)
self.stop_btn.clicked.connect(self.stop_scan)
self.stop_btn.setEnabled(False)
self.export_btn = QPushButton("?? 導(dǎo)出TXT")
self.export_btn.setFixedWidth(120)
self.export_btn.clicked.connect(self.export_files)
self.export_btn.setEnabled(False)
control_layout.addWidget(self.scan_btn)
control_layout.addWidget(self.stop_btn)
control_layout.addWidget(self.export_btn)
control_layout.addStretch()
control_group.setLayout(control_layout)
main_layout.addWidget(control_group)
# 進(jìn)度條
self.progress_bar = QProgressBar()
self.progress_bar.setVisible(False)
main_layout.addWidget(self.progress_bar)
# 文件樹顯示
tree_group = QGroupBox("文件列表")
tree_layout = QVBoxLayout()
self.file_tree = QTreeWidget()
self.file_tree.setHeaderLabels(["文件/目錄", "路徑"])
self.file_tree.setColumnWidth(0, 300)
self.file_tree.header().setSectionResizeMode(0, QHeaderView.Interactive)
self.file_tree.header().setSectionResizeMode(1, QHeaderView.Stretch)
tree_layout.addWidget(self.file_tree)
tree_group.setLayout(tree_layout)
main_layout.addWidget(tree_group, 1)
# 狀態(tài)欄
self.status_bar = QStatusBar()
self.setStatusBar(self.status_bar)
self.status_label = QLabel("就緒")
self.status_bar.addWidget(self.status_label)
def _setup_styles(self):
"""設(shè)置界面樣式"""
self.setStyleSheet("""
QMainWindow {
background-color: #f5f5f5;
}
QGroupBox {
font-weight: bold;
border: 1px solid #ccc;
border-radius: 5px;
margin-top: 10px;
padding-top: 10px;
}
QGroupBox::title {
subcontrol-origin: margin;
left: 10px;
padding: 0 5px 0 5px;
}
QPushButton {
background-color: #3498db;
color: white;
border: none;
padding: 8px 15px;
border-radius: 4px;
font-weight: bold;
}
QPushButton:hover {
background-color: #2980b9;
}
QPushButton:disabled {
background-color: #bdc3c7;
color: #7f8c8d;
}
QTreeWidget {
background-color: white;
border: 1px solid #ddd;
border-radius: 3px;
font-family: 'Microsoft YaHei', 'Segoe UI';
font-size: 12px;
}
QTreeWidget::item {
padding: 3px;
}
QTreeWidget::item:hover {
background-color: #ecf0f1;
}
QTreeWidget::item:selected {
background-color: #3498db;
color: white;
}
""")
def select_directory(self):
"""選擇目錄"""
dir_path = QFileDialog.getExistingDirectory(
self,
"選擇目錄",
str(Path.home()),
QFileDialog.ShowDirsOnly
)
if dir_path:
self.current_dir = dir_path
self.dir_label.setText(f"已選擇: {dir_path}")
self.scan_btn.setEnabled(True)
self.clear_file_tree()
self.status_label.setText("目錄已選擇，點擊開始掃描")
def start_scan(self):
"""開始掃描文件"""
if not self.current_dir or not os.path.exists(self.current_dir):
QMessageBox.warning(self, "警告", "請先選擇有效的目錄")
return
self.clear_file_tree()
self.scan_btn.setEnabled(False)
self.browse_btn.setEnabled(False)
self.stop_btn.setEnabled(True)
self.export_btn.setEnabled(False)
self.progress_bar.setVisible(True)
self.progress_bar.setValue(0)
self.scanner = FileScanner(self.current_dir)
self.scanner.progress.connect(self.update_progress)
self.scanner.finished.connect(self.on_scan_finished)
self.scanner.error.connect(self.on_scan_error)
self.scanner.start()
self.status_label.setText("正在掃描文件...")
def stop_scan(self):
"""停止掃描"""
if self.scanner and self.scanner.isRunning():
self.scanner.stop()
self.scanner.wait()
self.reset_controls()
self.status_label.setText("掃描已停止")
def update_progress(self, current, total, filename):
"""更新掃描進(jìn)度"""
if total > 0:
progress = int((current / total) * 100)
self.progress_bar.setMaximum(total)
self.progress_bar.setValue(current)
display_name = filename if len(filename) < 40 else f"{filename[:37]}..."
self.status_label.setText(f"掃描中: {current}/{total} - {display_name}")
def on_scan_finished(self, file_list):
"""掃描完成處理"""
self.file_list = sorted(file_list)
self.build_file_tree()
self.reset_controls()
self.export_btn.setEnabled(True)
self.status_label.setText(f"掃描完成！共找到 {len(self.file_list)} 個文件")
QMessageBox.information(self, "完成", f"掃描完成！\n找到 {len(self.file_list)} 個文件")
def on_scan_error(self, error_msg):
"""掃描錯誤處理"""
QMessageBox.critical(self, "錯誤", f"掃描失敗: {error_msg}")
self.reset_controls()
self.status_label.setText(f"錯誤: {error_msg}")
def reset_controls(self):
"""重置控件狀態(tài)"""
self.scan_btn.setEnabled(True)
self.browse_btn.setEnabled(True)
self.stop_btn.setEnabled(False)
self.progress_bar.setVisible(False)
def clear_file_tree(self):
"""清空文件樹"""
self.file_tree.clear()
def build_file_tree(self):
"""構(gòu)建文件樹結(jié)構(gòu)"""
if not self.file_list:
return
root_name = os.path.basename(self.current_dir) or self.current_dir
root_item = QTreeWidgetItem(self.file_tree, [root_name, self.current_dir])
root_item.setExpanded(True)
for file_path in self.file_list:
self.add_to_tree(root_item, file_path)
def add_to_tree(self, parent_item, file_path):
"""添加文件到樹中"""
parts = file_path.split(os.sep)
current_item = parent_item
for i, part in enumerate(parts):
found = False
for j in range(current_item.childCount()):
child = current_item.child(j)
if child.text(0) == part:
current_item = child
found = True
break
if not found:
full_path = os.path.join(self.current_dir, *parts[:i+1])
is_file = (i == len(parts) - 1)
new_item = QTreeWidgetItem(current_item, [part, full_path])
if is_file:
new_item.setForeground(0, QColor(0, 128, 0))
current_item = new_item
def export_files(self):
"""導(dǎo)出文件列表到TXT"""
if not self.file_list:
QMessageBox.warning(self, "警告", "沒有文件可導(dǎo)出")
return
default_name = f"文件列表_{datetime.now().strftime('%Y%m%d_%H%M%S')}.txt"
file_path, _ = QFileDialog.getSaveFileName(
self, "保存文件列表",
str(Path.home() / default_name),
"文本文件 (*.txt);;所有文件 (*)"
)
if file_path:
try:
with open(file_path, 'w', encoding='utf-8') as f:
f.write(f"目錄: {self.current_dir}\n")
f.write(f"掃描時間: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}\n")
f.write(f"文件總數(shù): {len(self.file_list)}\n")
f.write("=" * 50 + "\n\n")
for file in self.file_list:
f.write(file + "\n")
QMessageBox.information(self, "成功", f"文件已保存到:\n{file_path}")
self.status_label.setText(f"已保存: {os.path.basename(file_path)}")
except Exception as e:
QMessageBox.critical(self, "錯誤", f"保存失敗: {str(e)}")
2. 文件掃描線程
class FileScanner(QThread):
"""后臺文件掃描線程，避免界面卡頓"""
progress = pyqtSignal(int, int, str) # 當(dāng)前進(jìn)度, 總數(shù), 當(dāng)前文件
finished = pyqtSignal(list) # 文件列表
error = pyqtSignal(str) # 錯誤信息
def __init__(self, root_dir):
super().__init__()
self.root_dir = root_dir
self._running = True
def run(self):
"""線程執(zhí)行函數(shù)"""
try:
if not os.path.exists(self.root_dir):
self.error.emit(f"目錄不存在: {self.root_dir}")
return
file_list = []
total_files = 0
# 先統(tǒng)計總文件數(shù)
for root, dirs, files in os.walk(self.root_dir):
if not self._running:
return
total_files += len(files)
processed = 0
for root, dirs, files in os.walk(self.root_dir):
if not self._running:
return
for file in files:
if not self._running:
return
try:
full_path = os.path.join(root, file)
rel_path = os.path.relpath(full_path, self.root_dir)
file_list.append(rel_path)
processed += 1
if total_files > 0:
self.progress.emit(processed, total_files, rel_path)
except Exception:
continue
if self._running:
self.finished.emit(file_list)
except Exception as e:
self.error.emit(str(e))
def stop(self):
"""停止掃描"""
self._running = False
3. 應(yīng)用程序入口
def main():
"""應(yīng)用程序主函數(shù)"""
app = QApplication(sys.argv)
app.setApplicationName("文件掃描器")
app.setFont(QFont("Microsoft YaHei", 10))
window = FileScannerApp()
window.show()
sys.exit(app.exec_())
if __name__ == "__main__":
main()
代碼解析與實現(xiàn)細(xì)節(jié)
界面布局設(shè)計
界面采用 QVBoxLayout 和 QHBoxLayout 進(jìn)行垂直和水平布局，包含以下核心區(qū)域：
- 標(biāo)題區(qū)域：顯示應(yīng)用程序名稱
- 目錄選擇區(qū)：顯示當(dāng)前選擇的目錄路徑和瀏覽按鈕
- 控制按鈕區(qū)：開始掃描、停止、導(dǎo)出三個主要功能按鈕
- 進(jìn)度顯示區(qū)：顯示掃描進(jìn)度
- 文件樹展示區(qū)：以樹形結(jié)構(gòu)展示目錄和文件
- 狀態(tài)欄：顯示當(dāng)前狀態(tài)信息
樹形結(jié)構(gòu)實現(xiàn)原理
文件樹的構(gòu)建采用遞歸算法，但通過迭代方式實現(xiàn)以避免遞歸深度限制。對于每個文件的相對路徑，按路徑分隔符分割，逐級檢查并創(chuàng)建樹節(jié)點：
def add_to_tree(parent_item, file_path):
"""添加文件到樹中的算法實現(xiàn)"""
parts = file_path.split(os.sep) # 分割路徑
current_item = parent_item
for i, part in enumerate(parts):
# 檢查是否已存在該節(jié)點
found = False
for j in range(current_item.childCount()):
if current_item.child(j).text(0) == part:
current_item = current_item.child(j)
found = True
break
# 創(chuàng)建新節(jié)點
if not found:
is_file = (i == len(parts) - 1)
new_item = QTreeWidgetItem(current_item, [part, ""])
if is_file:
new_item.setForeground(0, QColor(0, 128, 0))
current_item = new_item
多線程處理機制
掃描過程在獨立線程中執(zhí)行，避免界面卡頓。使用 QThread 和 pyqtSignal 實現(xiàn)線程間通信：
- 進(jìn)度信號：實時更新掃描進(jìn)度
- 完成信號：掃描完成后傳輸文件列表
- 錯誤信號：傳遞掃描過程中的異常信息
線程安全的停止機制通過標(biāo)志變量控制：
def stop(self):
"""安全的線程停止方法"""
self._running = False
def run(self):
"""線程運行循環(huán)"""
while self._running and not_finished:
# 掃描邏輯...
文件導(dǎo)出格式
生成的 TXT 文件包含標(biāo)準(zhǔn)化格式：
目錄: /path/to/directory
掃描時間: 2024-01-24 10:30:00
文件總數(shù): 1234
==================================================
folder1/file1.txt
folder1/file2.py
folder2/subfolder/document.docx
...
擴展功能建議
1. 添加文件篩選功能
class FilterDialog(QDialog):
"""文件篩選對話框"""
def __init__(self, parent=None):
super().__init__(parent)
self.setWindowTitle("文件篩選")
layout = QVBoxLayout()
# 擴展名篩選
ext_layout = QHBoxLayout()
ext_label = QLabel("擴展名:")
self.ext_input = QLineEdit()
self.ext_input.setPlaceholderText("例如: txt,py,jpg (逗號分隔)")
ext_layout.addWidget(ext_label)
ext_layout.addWidget(self.ext_input, 1)
# 大小篩選
size_layout = QHBoxLayout()
size_label = QLabel("最小大小(KB):")
self.min_size = QSpinBox()
self.min_size.setRange(0, 999999)
size_layout.addWidget(size_label)
size_layout.addWidget(self.min_size)
layout.addLayout(ext_layout)
layout.addLayout(size_layout)
# 按鈕
btn_layout = QHBoxLayout()
ok_btn = QPushButton("確定")
cancel_btn = QPushButton("取消")
ok_btn.clicked.connect(self.accept)
cancel_btn.clicked.connect(self.reject)
btn_layout.addWidget(ok_btn)
btn_layout.addWidget(cancel_btn)
layout.addLayout(btn_layout)
self.setLayout(layout)
2. 添加右鍵菜單功能
class CustomTreeWidget(QTreeWidget):
"""自定義樹控件，添加右鍵菜單"""
def __init__(self, parent=None):
super().__init__(parent)
self.setContextMenuPolicy(Qt.CustomContextMenu)
self.customContextMenuRequested.connect(self.show_context_menu)
def show_context_menu(self, position):
"""顯示右鍵菜單"""
menu = QMenu()
open_action = QAction("打開文件", self)
open_folder_action = QAction("打開所在文件夾", self)
copy_path_action = QAction("復(fù)制路徑", self)
menu.addAction(open_action)
menu.addAction(open_folder_action)
menu.addSeparator()
menu.addAction(copy_path_action)
menu.exec_(self.viewport().mapToGlobal(position))
3. 添加統(tǒng)計信息面板
class StatsPanel(QWidget):
"""統(tǒng)計信息面板"""
def __init__(self, parent=None):
super().__init__(parent)
layout = QVBoxLayout()
# 文件類型統(tǒng)計
self.type_stats = {}
self.type_label = QLabel("文件類型: 0")
# 大小統(tǒng)計
self.total_size = 0
self.size_label = QLabel("總大小: 0 B")
# 時間統(tǒng)計
self.scan_time = 0
self.time_label = QLabel("掃描時間: 0s")
layout.addWidget(self.type_label)
layout.addWidget(self.size_label)
layout.addWidget(self.time_label)
self.setLayout(layout)
def update_stats(self, file_list, scan_time):
"""更新統(tǒng)計信息"""
# 計算文件類型分布
self.type_stats.clear()
for file in file_list:
ext = os.path.splitext(file)[1].lower()
self.type_stats[ext] = self.type_stats.get(ext, 0) + 1
# 計算總大小
self.total_size = 0
# 更新顯示
self.type_label.setText(f"文件類型: {len(self.type_stats)} 種")
self.time_label.setText(f"掃描時間: {scan_time:.2f}s")
運行說明
安裝依賴
pip install PyQt5
運行程序
python file_scanner.py
使用步驟
- 點擊"選擇目錄"按鈕，選擇要掃描的目錄
- 點擊"開始掃描"按鈕，開始掃描文件
- 在樹形結(jié)構(gòu)中瀏覽掃描結(jié)果
- 點擊"導(dǎo)出TXT"按鈕，保存文件列表
- 可隨時點擊"停止"按鈕中斷掃描
注意事項
- 權(quán)限問題：某些系統(tǒng)目錄可能需要管理員權(quán)限才能訪問
- 符號鏈接：當(dāng)前版本不處理符號鏈接，避免無限循環(huán)
- 大目錄處理：掃描非常大的目錄時可能需要較長時間
- 內(nèi)存使用：掃描結(jié)果完全存儲在內(nèi)存中，超大型目錄需注意內(nèi)存限制
- 編碼問題：確保系統(tǒng)支持文件的字符編碼
總結(jié)
本文實現(xiàn)了一個功能完整的目錄文件掃描器，具有以下特點：
- 直觀的圖形界面：基于 PyQt5 的現(xiàn)代化界面
- 高效的掃描機制：多線程后臺掃描，不阻塞界面
- 清晰的樹形展示：層次化的文件結(jié)構(gòu)展示
- 完整的導(dǎo)出功能：標(biāo)準(zhǔn)化的 TXT 文件輸出
- 良好的用戶體驗：進(jìn)度顯示、狀態(tài)反饋、錯誤處理
該工具適用于文件整理、項目分析、數(shù)據(jù)備份等多種場景，可有效提高文件管理效率。通過模塊化設(shè)計和清晰的代碼結(jié)構(gòu)，便于進(jìn)一步的功能擴展和維護(hù)。
以上就是Python結(jié)合PyQt5實現(xiàn)目錄文件掃描與導(dǎo)出工具的詳細(xì)內(nèi)容，更多關(guān)于Python目錄文件掃描與導(dǎo)出的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
和孩子一起學(xué)習(xí)python之變量命名規(guī)則
這篇文章我們給大家總結(jié)了關(guān)于兒童學(xué)習(xí)python中的變量命名規(guī)則相關(guān)知識點內(nèi)容，有興趣的朋友跟著參考學(xué)習(xí)下。2018-05-05
Python實現(xiàn)計算函數(shù)或程序執(zhí)行時間
在Python程序的開發(fā)過程中，一些程序需要獲取函數(shù)或程序的開始時間、結(jié)束時間和時間間隔等內(nèi)容用來分析和處理內(nèi)容。本文就來聊聊具體實現(xiàn)方法2023-02-02
python如何通過psutil獲取服務(wù)器cpu、內(nèi)存、磁盤使用率
這篇文章主要介紹了python通過psutil獲取服務(wù)器cpu，內(nèi)存，磁盤使用率,使用psutil，可以很方便地監(jiān)控系統(tǒng)的運行狀況，診斷問題和優(yōu)化性能，需要的朋友可以參考下2023-04-04
在本篇文章里小編給大家整理的是一篇關(guān)于python處理寫入數(shù)據(jù)代碼講解內(nèi)容，有興趣的朋友們可以學(xué)習(xí)下。2020-10-10
Python使用DPKT實現(xiàn)分析數(shù)據(jù)包
dpkt項目是一個Python模塊,主要用于對網(wǎng)絡(luò)數(shù)據(jù)包進(jìn)行解析和操作,z這篇文章主要為大家介紹了python如何利用DPKT實現(xiàn)分析數(shù)據(jù)包,有需要的可以參考下2023-10-10
這篇文章主要介紹了Python爬蟲工具requests-html使用解析,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-04-04
這篇文章主要介紹了python中的global關(guān)鍵字的使用方法，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-08-08
這篇文章主要介紹了用python批量下載apk的方法，幫助大家更好的理解和使用python，感興趣的朋友可以了解下2020-12-12
Python?Watchdog實現(xiàn)實時監(jiān)控文件系統(tǒng)
Python?Watchdog是一個優(yōu)秀的第三方庫,用于實現(xiàn)高效的文件系統(tǒng)監(jiān)控,本文將為大家詳細(xì)介紹一下Python如何使用Watchdog實現(xiàn)實時監(jiān)控文件,需要的可以參考下2023-11-11
Python標(biāo)準(zhǔn)庫中的logging模塊提供了日志記錄的功能,自定義 Logger 可以根據(jù)項目的需求定制化日志記錄,滿足特定的日志記錄格式、輸出目標(biāo)和日志級別等要求,本文給大家介紹了Python自定義logger模塊的實例代碼,需要的朋友可以參考下2024-02-02