PyQt学习系列11-综合项目:多语言文件管理器

PyQt学习系列笔记（Python Qt框架）

第十一课：综合项目 - 多语言文件管理器
（原课程规划中的第十五课，按用户要求调整为第十一课）

课程目标

综合运用PyQt框架开发一个支持多语言的文件管理器
实现以下核心功能：
- 文件浏览与目录导航
- 多线程文件搜索
- 剪切板历史记录
- 多语言切换（中/英）
- 资源文件管理（图标、样式表）
掌握**国际化（i18n）与本地化（l10n）**的完整实现流程

一、项目需求分析

1.1 功能需求

模块	功能描述
文件浏览	显示当前目录下的文件和文件夹，支持双击进入子目录
搜索功能	支持关键字搜索文件名，支持多线程加速
剪切板历史	记录最近10条剪切/复制内容，支持回溯
多语言切换	支持中/英文切换，界面文本自动更新
资源管理	使用.qrc文件管理图标和样式表

二、项目结构设计

multi_language_file_manager/
├── main.py                  # 主程序入口
├── ui/
│   └── main_window.ui       # Qt Designer设计的UI文件
├── resources/
│   ├── icons/               # 图标资源
│   └── styles.qss           # 样式表文件
├── i18n/
│   ├── en.ts                # 英文翻译文件
│   └── zh.ts                # 中文翻译文件
└── qrc/└── resources.qrc        # Qt资源文件

三、核心功能实现

3.1 使用Qt Designer设计界面

打开Qt Designer，创建main_window.ui文件：
- 添加QTreeView用于显示文件目录
- 添加QLineEdit作为搜索输入框
- 添加QPushButton用于切换语言
- 添加QListWidget显示剪切板历史
保存UI文件后，使用pyuic5生成Python代码：
```
pyuic5 ui/main_window.ui -o ui/main_window.py
```

3.2 多语言支持实现

3.2.1 标记可翻译文本

在代码中使用tr()函数包裹所有需要翻译的文本：

from PyQt5.QtCore import QCoreApplicationclass MainWindow(QMainWindow):def __init__(self):super().__init__()self.setWindowTitle(self.tr("多语言文件管理器"))  # 可翻译标题self.search_button.setText(self.tr("搜索"))         # 可翻译按钮文本

3.2.2 生成翻译文件

创建.ts文件：

pylupdate5 -noobsolete main.py -ts i18n/en.ts i18n/zh.ts

使用Qt Linguist编辑翻译：
- 双击打开.ts文件，输入对应语言的翻译内容
- 保存后生成.qm文件：
```
lrelease i18n/en.ts i18n/zh.ts
```

3.2.3 动态加载语言包

from PyQt5.QtCore import QTranslator, QLocaledef load_language(language_code):translator = QTranslator()if translator.load(f"i18n/{language_code}.qm"):QCoreApplication.installTranslator(translator)# 重新加载UI以更新文本self.retranslateUi()

3.3 多线程文件搜索

使用QThread实现后台搜索：

from PyQt5.QtCore import QThread, pyqtSignal
import osclass SearchWorker(QThread):result_ready = pyqtSignal(str)def __init__(self, directory, keyword):super().__init__()self.directory = directoryself.keyword = keyworddef run(self):for root, dirs, files in os.walk(self.directory):for file in files:if self.keyword.lower() in file.lower():self.result_ready.emit(os.path.join(root, file))

主线程连接信号：

worker = SearchWorker(current_dir, search_keyword)
worker.result_ready.connect(self.update_search_results)
worker.start()

3.4 剪切板历史记录

监听剪切板变化：

from PyQt5.QtGui import QClipboardclass ClipboardMonitor(QObject):clipboard_changed = pyqtSignal(str)def __init__(self):super().__init__()self.clipboard = QApplication.clipboard()self.clipboard.dataChanged.connect(self.on_clipboard_change)self.history = []def on_clipboard_change(self):text = self.clipboard.text()if text not in self.history:self.history.append(text)self.clipboard_changed.emit(text)

限制历史记录数量：

if len(self.history) > 10:self.history.pop(0)

3.5 资源文件管理

创建resources.qrc文件：

<RCC><qresource prefix="/"><file>icons/folder.png</file><file>icons/file.png</file><file>styles.qss</file></qresource>
</RCC>

编译资源文件：

pyrcc5 qrc/resources.qrc -o resources_rc.py

加载资源文件：

import resources_rc  # 导入编译后的资源
QFile(":/styles.qss").open(QFile.ReadOnly)
stylesheet = QFile.readAll()
self.setStyleSheet(stylesheet)

四、完整代码示例

4.1 主程序入口（main.py）

import sys
from PyQt5.QtWidgets import QApplication
from ui.main_window import Ui_MainWindow
from i18n.translator import load_languageclass MainWindow(Ui_MainWindow, QMainWindow):def __init__(self):super().__init__()self.setupUi(self)self.init_ui()self.init_translator()def init_ui(self):# 初始化UI逻辑self.search_button.clicked.connect(self.start_search)def init_translator(self):self.translator = QTranslator()self.current_language = "en"self.load_language(self.current_language)def load_language(self, code):if self.translator.load(f"i18n/{code}.qm"):QCoreApplication.installTranslator(self.translator)self.retranslateUi()  # 更新UI文本def start_search(self):keyword = self.search_input.text()worker = SearchWorker(self.current_dir, keyword)worker.result_ready.connect(self.update_search_results)worker.start()if __name__ == "__main__":app = QApplication(sys.argv)window = MainWindow()window.show()sys.exit(app.exec_())

五、项目打包与部署

5.1 使用PyInstaller打包

安装依赖：
```
pip install pyinstaller
```

打包命令：

pyinstaller -F -w --add-data "resources/*;resources" --icon=resources/icons/app_icon.ico main.py

处理资源路径问题：

def resource_path(relative_path):if hasattr(sys, '_MEIPASS'):return os.path.join(sys._MEIPASS, relative_path)return os.path.join(os.path.abspath("."), relative_path)