背景介绍
在日常学习和工作中，我们常常需要记录一些灵感、任务、会议纪要或学习笔记。虽然有许多成熟的笔记软件，但对于开发者而言，亲手实现一个本地运行的笔记管理器，不仅能提升对Python GUI开发的理解，还能锻炼文件读写与数据管理的能力。
本文将介绍如何使用 PyQt5 开发一个图形界面的本地笔记管理器，实现笔记的添加、编辑、删除、保存和加载功能。项目完全在本地运行，不依赖网络服务，适合Python初学者或对GUI开发感兴趣的开发者学习和实践。
思路分析
项目目标
本项目的目标是构建一个简单但功能完整的本地笔记管理器，具备以下功能：
- 提供图形界面，支持用户输入笔记标题和内容；
- 支持添加、编辑、删除笔记；
- 支持将笔记保存到本地文件（如
.json）； - 支持从本地加载已保存的笔记；
- 显示当前笔记列表，支持点击查看详细内容；
- 所有操作在本地完成，无需网络连接。
技术核心点
- GUI设计与事件响应机制：使用PyQt5构建界面，处理按钮点击、输入框事件等；
- 文件读写与数据处理：使用Python标准库实现笔记的保存与加载；
- 数据结构与对象管理：使用类和列表管理笔记数据；
- 用户交互设计：提供清晰的界面布局与操作反馈。
项目结构
note_manager/
│
├── main.py # 主程序入口
├── note_manager_ui.py # GUI界面设计（可选）
├── requirements.txt # 依赖库清单
├── notes.json # 保存笔记数据的文件
└── README.md # 项目说明
代码实现
1. 安装依赖
首先，确保你已经安装了 PyQt5。可以通过以下命令安装：
pip install PyQt5
2. 示例代码（main.py）
import sys
import json
from PyQt5.QtWidgets import (QApplication, QWidget, QLabel, QLineEdit, QTextEdit, QPushButton, QListWidget, QVBoxLayout, QHBoxLayout, QFileDialog, QMessageBox)
from PyQt5.QtCore import Qt
class NoteManagerApp(QWidget):
def __init__(self):
super().__init__()
self.setWindowTitle("简易笔记管理器")
self.setGeometry(100, 100, 600, 400)
self.notes = [] # 用于保存笔记数据
self.current_note = None # 当前选中的笔记索引
self.init_ui()
def init_ui(self):
"""初始化界面"""
# 标题和内容输入框
self.title_input = QLineEdit(self)
self.title_input.setPlaceholderText("输入笔记标题")
self.content_input = QTextEdit(self)
self.content_input.setPlaceholderText("输入笔记内容")
# 操作按钮
self.save_btn = QPushButton("保存笔记")
self.save_btn.clicked.connect(self.save_note)
self.load_btn = QPushButton("加载笔记")
self.load_btn.clicked.connect(self.load_notes)
self.delete_btn = QPushButton("删除笔记")
self.delete_btn.clicked.connect(self.delete_note)
self.view_btn = QPushButton("查看笔记")
self.view_btn.clicked.connect(self.show_notes)
# 笔记列表
self.note_list = QListWidget(self)
self.note_list.itemClicked.connect(self.select_note)
# 布局
layout = QVBoxLayout()
layout.addWidget(QLabel("笔记标题:"))
layout.addWidget(self.title_input)
layout.addWidget(QLabel("笔记内容:"))
layout.addWidget(self.content_input)
button_layout = QHBoxLayout()
button_layout.addWidget(self.save_btn)
button_layout.addWidget(self.load_btn)
button_layout.addWidget(self.delete_btn)
button_layout.addWidget(self.view_btn)
layout.addLayout(button_layout)
layout.addWidget(QLabel("笔记列表:"))
layout.addWidget(self.note_list)
self.setLayout(layout)
def save_note(self):
"""保存当前笔记到列表并保存到文件"""
title = self.title_input.text()
content = self.content_input.toPlainText()
if not title or not content:
QMessageBox.warning(self, "错误", "标题和内容不能为空！")
return
note = {"title": title, "content": content}
self.notes.append(note)
self.save_to_file("notes.json")
self.update_note_list()
def update_note_list(self):
"""更新笔记列表显示"""
self.note_list.clear()
for note in self.notes:
self.note_list.addItem(note["title"])
def load_notes(self):
"""从文件加载笔记"""
file_path, _ = QFileDialog.getOpenFileName(self, "打开笔记文件", "", "JSON 文件 (*.json)")
if file_path:
try:
with open(file_path, "r", encoding="utf-8") as f:
self.notes = json.load(f)
self.update_note_list()
except Exception as e:
QMessageBox.critical(self, "错误", f"加载笔记失败：{e}")
def save_to_file(self, filename):
"""将笔记保存到指定文件"""
try:
with open(filename, "w", encoding="utf-8") as f:
json.dump(self.notes, f, ensure_ascii=False, indent=4)
except Exception as e:
QMessageBox.critical(self, "错误", f"保存笔记失败：{e}")
def delete_note(self):
"""删除当前选中的笔记"""
if self.current_note is not None:
self.notes.pop(self.current_note)
self.save_to_file("notes.json")
self.update_note_list()
self.title_input.clear()
self.content_input.clear()
self.current_note = None
def select_note(self, item):
"""选中笔记时更新输入框内容"""
index = self.note_list.row(item)
self.current_note = index
note = self.notes[index]
self.title_input.setText(note["title"])
self.content_input.setPlainText(note["content"])
def show_notes(self):
"""显示当前所有笔记标题"""
if not self.notes:
QMessageBox.information(self, "提示", "当前没有笔记。")
return
note_list_str = "\n".join([f"{i+1}. {note['title']}" for i, note in enumerate(self.notes)])
QMessageBox.information(self, "当前笔记列表", note_list_str)
if __name__ == "__main__":
app = QApplication(sys.argv)
window = NoteManagerApp()
window.show()
sys.exit(app.exec_())
功能说明
1. 界面布局
- 使用
QLineEdit和QTextEdit分别输入标题和内容； - 使用
QListWidget显示所有笔记标题； - 使用
QHBoxLayout和QVBoxLayout组织按钮和输入框的布局。
2. 事件响应机制
- 保存按钮：点击后将输入内容保存为字典，并写入
notes.json； - 加载按钮：弹出文件选择对话框，加载
.json文件中的笔记； - 删除按钮：删除当前选中的笔记；
- 查看按钮：弹出消息框显示所有笔记标题；
- 笔记列表点击事件：点击列表项时，更新输入框内容为该笔记。
3. 文件操作
- 使用
json.dump()将笔记数据写入文件； - 使用
json.load()从文件读取笔记数据。
学习价值
本项目是一个非常适合初学者学习的 PyQt5 GUI 应用开发 实例，具有以下学习价值：
- GUI设计：掌握
QLineEdit、QTextEdit、QListWidget等常用组件的使用； - 事件响应机制：学习如何绑定按钮点击、列表项点击等事件；
- 文件读写：理解如何将数据保存到本地文件并读取；
- 数据结构：使用列表和字典管理笔记数据；
- 模块化设计：将功能模块化，提升代码的可维护性。
扩展建议（可选）
- 支持多格式保存：如支持
.txt、.md等文本格式； - 添加搜索功能：允许用户根据标题或内容搜索笔记；
- 添加标签分类：为笔记添加标签，实现分类管理；
- 支持Markdown格式：使用
markdown库渲染富文本； - 增加本地数据库支持：使用
sqlite3存储笔记数据。
预计开发时间
- 核心功能：1~2天
- 优化与扩展：1~2天（根据需求）
总结
通过本项目，开发者可以深入理解 PyQt5 的基本用法，掌握图形界面开发与事件响应机制的核心概念。同时，通过实现本地笔记的增删改查功能，进一步巩固 Python文件操作 和 数据结构管理 的能力。
该项目不仅适合初学者作为学习项目，也适合作为教学示例或日常使用的小工具。希望读者通过本项目，能够激发对GUI开发的兴趣，并为开发更复杂的桌面应用打下坚实基础。