告别Hello World！用PySide6从零搭建一个简易桌面待办事项App（附完整源码）

用PySide6打造高颜值桌面待办事项应用从设计到打包的完整指南每次看到那些花哨的任务管理工具总觉得它们要么功能过剩要么界面复杂。作为开发者我们完全可以用PySide6亲手打造一个简约高效的待办事项应用。这不仅是掌握GUI开发的绝佳实践更能收获一个真正符合自己使用习惯的生产力工具。1. 项目规划与架构设计开发任何应用前明确需求边界都至关重要。我们的待办事项应用需要实现以下核心功能任务管理添加、删除、标记完成等基本操作数据持久化关闭应用后任务不丢失简洁交互键盘快捷键支持提升效率视觉反馈完成状态直观可见技术选型方面PySide6作为Qt的Python绑定相比Tkinter等库提供了更现代的UI组件和更强大的功能扩展性。项目结构采用MVC模式todo_app/ ├── models/ # 数据模型 │ └── task.py ├── views/ # 界面组件 │ ├── main_window.py │ └── styles.qss ├── controllers/ # 业务逻辑 │ └── manager.py └── app.py # 应用入口这种分层架构使代码更易维护比如要更换数据存储方式时只需修改models层而不影响其他部分。2. 构建现代化用户界面PySide6提供了丰富的UI组件我们先搭建主窗口框架# views/main_window.py from PySide6.QtWidgets import ( QMainWindow, QWidget, QVBoxLayout, QListWidget, QLineEdit, QPushButton ) class MainWindow(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle(极简待办) self.resize(400, 600) # 中央组件 central_widget QWidget() self.setCentralWidget(central_widget) # 主布局 layout QVBoxLayout() central_widget.setLayout(layout) # 任务输入框 self.task_input QLineEdit() self.task_input.setPlaceholderText(输入新任务...) layout.addWidget(self.task_input) # 添加按钮 add_btn QPushButton(添加任务) layout.addWidget(add_btn) # 任务列表 self.task_list QListWidget() layout.addWidget(self.task_list)为了让界面更美观我们可以使用Qt的样式表(QSS)/* views/styles.qss */ QMainWindow { background-color: #f5f5f5; } QListWidget { background: white; border: 1px solid #ddd; border-radius: 4px; padding: 5px; } QListWidget::item { padding: 8px; border-bottom: 1px solid #eee; } QListWidget::item:selected { background: #e3f2fd; } QPushButton { background: #42a5f5; color: white; border: none; padding: 8px; border-radius: 4px; }在代码中加载样式表# app.py from PySide6.QtCore import QFile from PySide6.QtWidgets import QApplication def load_stylesheet(): file QFile(views/styles.qss) file.open(QFile.ReadOnly | QFile.Text) stylesheet file.readAll() return str(stylesheet, encodingutf-8) app QApplication([]) app.setStyleSheet(load_stylesheet()) # ... 其余初始化代码3. 实现核心业务逻辑3.1 任务模型设计首先定义任务数据结构# models/task.py from dataclasses import dataclass from datetime import datetime dataclass class Task: description: str created_at: datetime datetime.now() completed: bool False def toggle(self): self.completed not self.completed3.2 控制器实现业务逻辑控制器负责协调模型和视图# controllers/manager.py import json from pathlib import Path from typing import List from models.task import Task class TaskManager: def __init__(self, data_filetasks.json): self.data_file Path(data_file) self.tasks: List[Task] [] self.load_tasks() def add_task(self, description: str): if not description.strip(): return self.tasks.append(Task(description)) self.save_tasks() def delete_task(self, index: int): if 0 index len(self.tasks): self.tasks.pop(index) self.save_tasks() def toggle_task(self, index: int): if 0 index len(self.tasks): self.tasks[index].toggle() self.save_tasks() def load_tasks(self): if self.data_file.exists(): with open(self.data_file, r) as f: data json.load(f) self.tasks [ Task( descriptionitem[description], created_atdatetime.fromisoformat(item[created_at]), completeditem[completed] ) for item in data ] def save_tasks(self): with open(self.data_file, w) as f: json.dump([ { description: task.description, created_at: task.created_at.isoformat(), completed: task.completed } for task in self.tasks ], f, indent2)3.3 连接界面与逻辑将UI组件与业务逻辑绑定# 在MainWindow类中添加方法 def connect_signals(self, manager): # 添加任务 self.add_btn.clicked.connect( lambda: self._add_task(manager) ) self.task_input.returnPressed.connect( lambda: self._add_task(manager) ) # 删除任务 self.task_list.itemDoubleClicked.connect( lambda item: manager.delete_task( self.task_list.row(item) ) ) # 标记完成/未完成 self.task_list.itemClicked.connect( lambda item: manager.toggle_task( self.task_list.row(item) ) ) def _add_task(self, manager): text self.task_input.text() manager.add_task(text) self.task_input.clear() self.update_task_list(manager.tasks) def update_task_list(self, tasks): self.task_list.clear() for task in tasks: item QListWidgetItem(task.description) item.setFlags(item.flags() | Qt.ItemIsUserCheckable) item.setCheckState( Qt.Checked if task.completed else Qt.Unchecked ) if task.completed: font item.font() font.setStrikeOut(True) item.setFont(font) item.setForeground(QColor(#999)) self.task_list.addItem(item)4. 增强用户体验的实用功能4.1 键盘快捷键支持提升操作效率的关键是良好的键盘支持# 在MainWindow.__init__中添加 self.setup_shortcuts() def setup_shortcuts(self): # 删除当前选中项 del_shortcut QShortcut(QKeySequence.Delete, self) del_shortcut.activated.connect( lambda: self.manager.delete_task( self.task_list.currentRow() ) ) # 标记完成/未完成 space_shortcut QShortcut(QKeySequence(Space), self) space_shortcut.activated.connect( lambda: self.manager.toggle_task( self.task_list.currentRow() ) )4.2 任务搜索过滤当任务较多时搜索功能非常实用# 在MainWindow.__init__中添加 self.search_input QLineEdit() self.search_input.setPlaceholderText(搜索任务...) layout.insertWidget(0, self.search_input) self.search_input.textChanged.connect( lambda text: self.filter_tasks(text) ) def filter_tasks(self, text): for i in range(self.task_list.count()): item self.task_list.item(i) item.setHidden( text.lower() not in item.text().lower() )4.3 任务分类标签通过标签组织任务# 修改Task模型 dataclass class Task: description: str tags: List[str] field(default_factorylist) # ... 其他字段 # 在MainWindow中添加标签选择器 self.tag_filter QComboBox() self.tag_filter.addItem(所有标签) layout.insertWidget(1, self.tag_filter) self.tag_filter.currentTextChanged.connect( lambda tag: self.filter_by_tag(tag) ) def update_tag_filter(self, tasks): tags set() for task in tasks: tags.update(task.tags) self.tag_filter.clear() self.tag_filter.addItem(所有标签) self.tag_filter.addItems(sorted(tags))5. 应用打包与分发5.1 使用PyInstaller打包将Python应用转换为独立可执行文件pip install pyinstaller pyinstaller --onefile --windowed --iconassets/icon.ico app.py关键参数说明--onefile生成单个可执行文件--windowed不显示控制台窗口--icon设置应用图标5.2 创建安装程序使用Inno Setup制作Windows安装包编写安装脚本setup.iss[Setup] AppName极简待办 AppVersion1.0 DefaultDirName{pf}\MyTodoApp DefaultGroupNameMyTodoApp OutputDiroutput OutputBaseFilenameMyTodoApp_Setup Compressionlzma SolidCompressionyes [Files] Source: dist\app.exe; DestDir: {app}; Flags: ignoreversion Source: views\styles.qss; DestDir: {app}; Flags: ignoreversion Source: assets\*; DestDir: {app}\assets; Flags: ignoreversion recursesubdirs [Icons] Name: {group}\极简待办; Filename: {app}\app.exe Name: {commondesktop}\极简待办; Filename: {app}\app.exe使用Inno Setup编译器生成安装程序5.3 跨平台注意事项确保应用在不同操作系统上表现一致路径处理使用pathlib.Path代替字符串拼接配置文件存储遵循各平台规范Windows:%APPDATA%/MyTodoAppmacOS:~/Library/Application Support/MyTodoAppLinux:~/.config/MyTodoAppfrom pathlib import Path import platform def get_data_dir(): system platform.system() if system Windows: return Path.home() / AppData/Roaming/MyTodoApp elif system Darwin: return Path.home() / Library/Application Support/MyTodoApp else: # Linux及其他Unix-like系统 return Path.home() / .config/MyTodoApp DATA_DIR get_data_dir() DATA_DIR.mkdir(parentsTrue, exist_okTrue)6. 性能优化与调试技巧6.1 减少UI卡顿处理大量任务时优化列表更新def update_task_list(self, tasks): # 先禁用UI更新 self.task_list.setUpdatesEnabled(False) self.task_list.clear() try: for task in tasks: item QListWidgetItem(task.description) # ... 设置item属性 self.task_list.addItem(item) finally: # 确保重新启用UI更新 self.task_list.setUpdatesEnabled(True)6.2 使用QThread处理耗时操作避免主线程阻塞class TaskSaver(QThread): finished_signal Signal() def __init__(self, tasks, filepath): super().__init__() self.tasks tasks self.filepath filepath def run(self): # 模拟耗时操作 time.sleep(1) with open(self.filepath, w) as f: json.dump([task.to_dict() for task in self.tasks], f) self.finished_signal.emit() # 在Manager中使用 def save_tasks(self): thread TaskSaver(self.tasks, self.data_file) thread.finished_signal.connect(self.on_save_complete) thread.start() def on_save_complete(self): print(任务保存完成)6.3 日志记录添加日志功能便于调试import logging from logging.handlers import RotatingFileHandler def setup_logging(): log_dir DATA_DIR / logs log_dir.mkdir(exist_okTrue) logger logging.getLogger() logger.setLevel(logging.DEBUG) # 文件日志(最大1MB保留3个备份) file_handler RotatingFileHandler( log_dir / app.log, maxBytes1024*1024, backupCount3 ) file_handler.setFormatter(logging.Formatter( %(asctime)s - %(levelname)s - %(message)s )) logger.addHandler(file_handler) # 控制台日志 console_handler logging.StreamHandler() console_handler.setLevel(logging.INFO) logger.addHandler(console_handler)7. 扩展功能思路7.1 云同步使用Dropbox API实现多设备同步import dropbox class CloudSync: def __init__(self, access_token): self.dbx dropbox.Dropbox(access_token) def upload(self, local_path, remote_path): with open(local_path, rb) as f: self.dbx.files_upload( f.read(), remote_path, modedropbox.files.WriteMode.overwrite ) def download(self, remote_path, local_path): self.dbx.files_download_to_file(local_path, remote_path) # 在Manager中集成 def sync_with_cloud(self): sync CloudSync(ACCESS_TOKEN) remote_path /MyTodoApp/tasks.json local_path str(self.data_file) try: sync.download(remote_path, local_path) self.load_tasks() except Exception as e: logging.error(f同步失败: {e})7.2 数据统计与分析使用matplotlib生成任务完成情况图表from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg from matplotlib.figure import Figure class StatsWidget(QWidget): def __init__(self, tasks): super().__init__() self.figure Figure() self.canvas FigureCanvasQTAgg(self.figure) layout QVBoxLayout() layout.addWidget(self.canvas) self.setLayout(layout) self.plot_stats(tasks) def plot_stats(self, tasks): ax self.figure.add_subplot(111) completed sum(1 for t in tasks if t.completed) pending len(tasks) - completed ax.bar([已完成, 待完成], [completed, pending], color[#4CAF50, #F44336]) ax.set_title(任务完成情况) self.canvas.draw()7.3 系统托盘支持让应用常驻系统托盘from PySide6.QtGui import QIcon, QAction class TrayIcon(QSystemTrayIcon): def __init__(self, parentNone): super().__init__(parent) self.setIcon(QIcon(assets/icon.png)) menu QMenu() show_action QAction(显示主窗口, self) show_action.triggered.connect(parent.show) menu.addAction(show_action) quit_action QAction(退出, self) quit_action.triggered.connect(parent.close) menu.addAction(quit_action) self.setContextMenu(menu) self.activated.connect(self.on_tray_activate) def on_tray_activate(self, reason): if reason QSystemTrayIcon.Trigger: self.parent().show() # 在主窗口初始化中添加 self.tray TrayIcon(self) self.tray.show()8. 测试与质量保证8.1 单元测试使用pytest测试核心逻辑# tests/test_manager.py import pytest from datetime import datetime from controllers.manager import TaskManager from models.task import Task pytest.fixture def manager(tmp_path): data_file tmp_path / test_tasks.json return TaskManager(data_file) def test_add_task(manager): manager.add_task(测试任务) assert len(manager.tasks) 1 assert manager.tasks[0].description 测试任务 def test_delete_task(manager): manager.add_task(任务1) manager.add_task(任务2) manager.delete_task(0) assert len(manager.tasks) 1 assert manager.tasks[0].description 任务2 def test_toggle_task(manager): manager.add_task(任务) assert not manager.tasks[0].completed manager.toggle_task(0) assert manager.tasks[0].completed8.2 UI自动化测试使用PySide6内置的测试工具from PySide6.QtTest import QTest def test_add_task_ui(qtbot): window MainWindow() qtbot.addWidget(window) # 模拟用户输入 qtbot.keyClicks(window.task_input, 新任务) qtbot.mouseClick(window.add_btn, Qt.LeftButton) assert window.task_list.count() 1 assert window.task_list.item(0).text() 新任务8.3 性能测试确保应用响应迅速import timeit def test_performance(): setup from controllers.manager import TaskManager manager TaskManager(:memory:) stmt for i in range(100): manager.add_task(f任务{i}) time timeit.timeit(stmt, setup, number10) assert time 1.0 # 10次循环应在1秒内完成