基于Python开发日历记事本的完整教程
更新时间：2025年10月09日 08:37:30 作者：winfredzhang
这篇文章主要为大家详细介绍了如何基于Python和wxPython开发一个功能完整的日历记事本应用,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下
项目简介
本文将详细讲解如何使用Python的wxPython GUI框架开发一个功能完整的日历记事本应用。该应用支持选择年月、记录每日待办事项、美观预览、背景自定义以及PDF导出等功能。
特别说明：本教程使用自绘日历方式，完全不依赖 wx.calendar 模块，避免了安装问题，更加灵活可控。
技术栈
- wxPython: 跨平台GUI框架，用于构建用户界面
- ReportLab: PDF生成库
- PIL (Pillow): 图像处理库
- Python标准库: calendar、json、datetime等
一、项目架构设计
1.1 核心类结构
项目包含两个主要类：
CalendarDiary (主窗口类)
├── 数据管理 (JSON读写)
├── UI界面构建
├── 自绘日历实现
├── 事件处理
└── PDF导出功能
PreviewFrame (预览窗口类)
├── 日历图像生成
└── 可视化展示
1.2 数据存储设计
使用JSON格式存储数据，结构如下：
{
"2025-10-01": {
"morning": "晨跑 30分钟",
"noon": "团队会议",
"evening": "学习Python"
},
"2025-10-02": {
"morning": "",
"noon": "午餐约会",
"evening": "看电影"
}
}
二、主窗口类详解
2.1 初始化方法
def __init__(self):
super().__init__(None, title="美观日历记事本", size=(1200, 800))
self.data_file = "diary_data.json"
self.diary_data = self.load_data()
self.background_image = None
# 初始化日期
today = datetime.now()
self.current_year = today.year
self.current_month = today.month
self.selected_date = None
self.init_ui()
self.Centre()
关键点：
- 调用父类构造函数创建窗口框架
- 定义数据文件路径
- 加载历史数据
- 初始化当前年月和选中日期
- 构建UI并居中显示
2.2 UI界面构建
2.2.1 布局管理器
wxPython使用Sizer进行布局管理，主要类型：
- BoxSizer: 水平或垂直排列控件
- GridSizer: 网格布局
- FlexGridSizer: 灵活网格布局
本项目使用BoxSizer的嵌套结构：
main_sizer = wx.BoxSizer(wx.VERTICAL) # 主垂直布局
├── toolbar_sizer (wx.HORIZONTAL) # 顶部工具栏
├── content_sizer (wx.HORIZONTAL) # 主内容区
├── left_panel (自绘日历)
└── right_panel (记事区域)
2.2.2 工具栏设计
toolbar_sizer = wx.BoxSizer(wx.HORIZONTAL)
# 年份选择
self.year_choice = wx.Choice(panel, choices=[str(y) for y in range(2020, 2031)])
self.year_choice.SetSelection(self.current_year - 2020)
self.year_choice.Bind(wx.EVT_CHOICE, self.on_year_month_change)
# 月份选择
self.month_choice = wx.Choice(panel, choices=[f"{m}月" for m in range(1, 13)])
self.month_choice.SetSelection(self.current_month - 1)
self.month_choice.Bind(wx.EVT_CHOICE, self.on_year_month_change)
wx.Choice控件特点：
- 下拉选择框，占用空间小
SetSelection()设置默认选中项（索引从0开始）GetStringSelection()获取当前选中的文本Bind(wx.EVT_CHOICE, handler)绑定选择变化事件
三、自绘日历实现（核心技术）
3.1 创建日历面板
# 创建自定义日历 self.calendar_panel = wx.Panel(left_panel, size=(400, 400)) self.calendar_panel.SetBackgroundColour(wx.Colour(255, 255, 255)) self.calendar_panel.Bind(wx.EVT_PAINT, self.on_paint_calendar) self.calendar_panel.Bind(wx.EVT_LEFT_DOWN, self.on_calendar_click)
关键点：
- 使用
wx.Panel作为画布 - 绑定
wx.EVT_PAINT事件进行绘制 - 绑定
wx.EVT_LEFT_DOWN处理点击事件 - 设置白色背景色
3.2 绘制日历（核心算法）
def on_paint_calendar(self, event):
dc = wx.PaintDC(self.calendar_panel)
dc.Clear()
width, height = self.calendar_panel.GetSize()
# 1. 绘制标题
dc.SetFont(wx.Font(16, wx.FONTFAMILY_DEFAULT,
wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_BOLD))
title = f"{self.current_year}年{self.current_month}月"
tw, th = dc.GetTextExtent(title)
dc.DrawText(title, (width - tw) // 2, 10)
# 2. 获取日历数据
cal = calendar.monthcalendar(self.current_year, self.current_month)
# 3. 计算单元格大小
start_y = 50
cell_width = width // 7
cell_height = (height - start_y) // (len(cal) + 1)
# 4. 绘制星期标题
dc.SetFont(wx.Font(10, wx.FONTFAMILY_DEFAULT,
wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_BOLD))
weekdays = ['一', '二', '三', '四', '五', '六', '日']
for i, day in enumerate(weekdays):
x = i * cell_width + cell_width // 2
tw, th = dc.GetTextExtent(day)
dc.DrawText(day, x - tw // 2, start_y)
# 5. 绘制日期单元格
dc.SetFont(wx.Font(12, wx.FONTFAMILY_DEFAULT,
wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_NORMAL))
for week_idx, week in enumerate(cal):
for day_idx, day in enumerate(week):
if day != 0:
x = day_idx * cell_width
y = start_y + 30 + week_idx * cell_height
# 绘制单元格（见下节详解）
self.draw_calendar_cell(dc, x, y, cell_width,
cell_height, day)
wx.PaintDC 核心方法：
Clear(): 清空画布SetFont(): 设置字体SetBrush(): 设置填充画刷SetPen(): 设置边框画笔DrawText(): 绘制文本DrawRectangle(): 绘制矩形DrawCircle(): 绘制圆形GetTextExtent(): 获取文本尺寸
3.3 单元格样式绘制
def draw_calendar_cell(self, dc, x, y, cell_width, cell_height, day):
# 检查是否有记事
date_str = f"{self.current_year}-{self.current_month:02d}-{day:02d}"
has_events = (date_str in self.diary_data and
any(self.diary_data[date_str].values()))
# 检查是否是选中的日期
is_selected = (self.selected_date and
self.selected_date == date_str)
# 根据状态设置不同样式
if is_selected:
# 选中：蓝色背景 + 蓝色粗边框
dc.SetBrush(wx.Brush(wx.Colour(100, 149, 237)))
dc.SetPen(wx.Pen(wx.Colour(0, 0, 255), 2))
elif has_events:
# 有记事：黄色背景 + 橙色粗边框
dc.SetBrush(wx.Brush(wx.Colour(255, 250, 205)))
dc.SetPen(wx.Pen(wx.Colour(255, 165, 0), 2))
else:
# 普通：白色背景 + 灰色细边框
dc.SetBrush(wx.Brush(wx.Colour(255, 255, 255)))
dc.SetPen(wx.Pen(wx.Colour(200, 200, 200), 1))
# 绘制矩形
dc.DrawRectangle(x, y, cell_width - 2, cell_height - 2)
# 绘制日期数字
day_str = str(day)
tw, th = dc.GetTextExtent(day_str)
if is_selected:
dc.SetTextForeground(wx.Colour(255, 255, 255)) # 白色文字
else:
dc.SetTextForeground(wx.Colour(0, 0, 0)) # 黑色文字
dc.DrawText(day_str, x + 5, y + 5)
# 如果有记事，显示红色小圆点标记
if has_events and not is_selected:
dc.SetBrush(wx.Brush(wx.Colour(255, 0, 0)))
dc.DrawCircle(x + cell_width - 10, y + 10, 3)
颜色设计理念：
- 选中状态：蓝色（Cornflower Blue）突出当前操作
- 有记事：黄色（Light Goldenrod Yellow）醒目提醒
- 普通日期：白色（White）干净简洁
- 记事标记：红色小圆点（Red Dot）快速识别
3.4 处理点击事件
def on_calendar_click(self, event):
width, height = self.calendar_panel.GetSize()
x, y = event.GetPosition()
# 获取日历数据
cal = calendar.monthcalendar(self.current_year, self.current_month)
# 计算单元格尺寸（与绘制时一致）
start_y = 80
cell_width = width // 7
cell_height = (height - 80) // (len(cal) + 1)
if y < start_y:
return # 点击在标题区域，忽略
# 计算点击位置对应的周索引和天索引
week_idx = (y - start_y) // cell_height
day_idx = x // cell_width
# 验证索引有效性
if 0 <= week_idx < len(cal) and 0 <= day_idx < 7:
day = cal[week_idx][day_idx]
if day != 0: # 0表示非当月日期
# 构造日期字符串
self.selected_date = f"{self.current_year}-{self.current_month:02d}-{day:02d}"
self.date_label.SetLabel(f"日期: {self.selected_date}")
# 加载该日期的数据
if self.selected_date in self.diary_data:
data = self.diary_data[self.selected_date]
self.morning_text.SetValue(data.get("morning", ""))
self.noon_text.SetValue(data.get("noon", ""))
self.evening_text.SetValue(data.get("evening", ""))
else:
self.morning_text.SetValue("")
self.noon_text.SetValue("")
self.evening_text.SetValue("")
# 重绘日历以显示选中状态
self.calendar_panel.Refresh()
坐标计算原理：
点击坐标 (x, y)
↓
week_idx = (y - start_y) // cell_height # 第几周
day_idx = x // cell_width # 星期几
↓
day = cal[week_idx][day_idx] # 获取日期数字
3.5 年月切换处理
def on_year_month_change(self, event):
# 从下拉框获取新的年月
self.current_year = int(self.year_choice.GetStringSelection())
self.current_month = self.month_choice.GetSelection() + 1
# 触发重绘
self.calendar_panel.Refresh()
Refresh() 方法说明：
- 触发
wx.EVT_PAINT事件 - 自动调用
on_paint_calendar()方法 - 实现日历内容更新
四、核心功能实现
4.1 数据保存功能
def on_save(self, event):
if not self.selected_date:
wx.MessageBox("请先选择日期", "提示", wx.OK | wx.ICON_WARNING)
return
# 保存到字典
self.diary_data[self.selected_date] = {
"morning": self.morning_text.GetValue(),
"noon": self.noon_text.GetValue(),
"evening": self.evening_text.GetValue()
}
# 持久化到文件
self.save_data()
# 重绘日历（显示红点标记）
self.calendar_panel.Refresh()
wx.MessageBox("保存成功！", "提示", wx.OK | wx.ICON_INFORMATION)
4.2 数据持久化
def load_data(self):
if os.path.exists(self.data_file):
with open(self.data_file, 'r', encoding='utf-8') as f:
return json.load(f)
return {}
def save_data(self):
with open(self.data_file, 'w', encoding='utf-8') as f:
json.dump(self.diary_data, f, ensure_ascii=False, indent=2)
JSON参数解析：
ensure_ascii=False: 保存中文而非Unicode转义indent=2: 格式化输出，缩进2个空格
五、PDF导出功能
5.1 PDF生成基础
def export_to_pdf(self, filename, year, month):
c = pdf_canvas.Canvas(filename, pagesize=A4)
width, height = A4
# 尝试注册中文字体
try:
pdfmetrics.registerFont(TTFont('SimSun', 'simsun.ttc'))
font_name = 'SimSun'
except:
font_name = 'Helvetica'
# 标题
c.setFont(font_name, 20)
title = f"{year} Year {month} Month Calendar"
c.drawCentredString(width / 2, height - 50, title)
ReportLab核心概念：
Canvas: PDF画布对象pagesize: 页面尺寸（A4、Letter等）- 字体注册：支持中文需要TrueType字体
5.2 绘制PDF日历网格
# 获取日历
cal = calendar.monthcalendar(year, month)
# 绘制日历网格
start_x = 50
start_y = height - 100
cell_width = (width - 100) / 7
cell_height = 80
# 星期标题
c.setFont(font_name, 12)
weekdays = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
for i, day in enumerate(weekdays):
c.drawCentredString(start_x + i * cell_width + cell_width / 2,
start_y, day)
start_y -= 20
# 绘制日期和记事
c.setFont(font_name, 10)
for week_idx, week in enumerate(cal):
for day_idx, day in enumerate(week):
if day != 0:
x = start_x + day_idx * cell_width
y = start_y - week_idx * cell_height
# 绘制边框
c.rect(x, y - cell_height, cell_width, cell_height)
# 绘制日期
c.setFont(font_name, 14)
c.drawString(x + 5, y - 20, str(day))
# 获取当天记事并绘制
date_str = f"{year}-{month:02d}-{day:02d}"
if date_str in self.diary_data:
data = self.diary_data[date_str]
c.setFont(font_name, 8)
y_offset = 35
if data.get("morning"):
text = data["morning"][:20] + "..." if len(data["morning"]) > 20 else data["morning"]
c.drawString(x + 5, y - y_offset, f"M: {text}")
y_offset += 12
if data.get("noon"):
text = data["noon"][:20] + "..." if len(data["noon"]) > 20 else data["noon"]
c.drawString(x + 5, y - y_offset, f"N: {text}")
y_offset += 12
if data.get("evening"):
text = data["evening"][:20] + "..." if len(data["evening"]) > 20 else data["evening"]
c.drawString(x + 5, y - y_offset, f"E: {text}")
c.save()
ReportLab坐标系统：
- 原点(0,0)在左下角
- Y轴向上增长
- 单位是点(point)，1英寸=72点
六、预览功能实现
6.1 预览窗口架构
class PreviewFrame(wx.Frame):
def __init__(self, parent, year, month, diary_data, background_image):
super().__init__(parent, title=f"{year}年{month}月日历预览",
size=(1000, 800))
# 创建日历图像
img = self.create_calendar_image()
# 转换为wx.Image
wx_img = wx.Image(io.BytesIO(img), wx.BITMAP_TYPE_PNG)
bitmap = wx.Bitmap(wx_img)
# 显示
img_ctrl = wx.StaticBitmap(panel, bitmap=bitmap)
图像处理流程：
PIL创建图像 → 2. 保存到内存(BytesIO) → 3. 转换为wx.Image → 4. 转换为wx.Bitmap → 5. 显示
6.2 使用PIL绘制日历
def create_calendar_image(self):
img_width, img_height = 1400, 1000
# 处理背景图片
if self.background_image and os.path.exists(self.background_image):
img = Image.open(self.background_image).convert('RGBA')
img = img.resize((img_width, img_height))
overlay = Image.new('RGBA', img.size, (255, 255, 255, 180))
img = Image.alpha_composite(img, overlay)
else:
img = Image.new('RGB', (img_width, img_height),
color=(240, 248, 255))
draw = ImageDraw.Draw(img)
PIL图像模式：
RGB: 红绿蓝三通道RGBA: 红绿蓝+Alpha透明通道alpha_composite(): 混合两个RGBA图像
6.3 字体处理
try:
title_font = ImageFont.truetype("msyh.ttc", 48)
date_font = ImageFont.truetype("msyh.ttc", 24)
text_font = ImageFont.truetype("msyh.ttc", 16)
except:
title_font = ImageFont.load_default()
date_font = ImageFont.load_default()
text_font = ImageFont.load_default()
常见中文字体文件：
- Windows:
msyh.ttc(微软雅黑),simsun.ttc(宋体) - macOS:
PingFang.ttc(苹方) - Linux:
WenQuanYi*.ttf(文泉驿)
6.4 绘制美观日历
# 标题
title = f"{self.year}年{self.month}月"
bbox = draw.textbbox((0, 0), title, font=title_font)
title_width = bbox[2] - bbox[0]
draw.text((img_width // 2 - title_width // 2, 30), title,
fill=(50, 50, 150), font=title_font)
# 获取日历
cal = calendar.monthcalendar(self.year, self.month)
# 绘制日历网格
start_x = 50
start_y = 120
cell_width = (img_width - 100) // 7
cell_height = (img_height - 200) // len(cal)
# 星期标题
weekdays = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
for i, day in enumerate(weekdays):
x = start_x + i * cell_width + cell_width // 2
bbox = draw.textbbox((0, 0), day, font=date_font)
text_width = bbox[2] - bbox[0]
draw.text((x - text_width // 2, start_y), day,
fill=(100, 100, 100), font=date_font)
start_y += 50
# 绘制日期单元格
for week_idx, week in enumerate(cal):
for day_idx, day in enumerate(week):
if day != 0:
x = start_x + day_idx * cell_width
y = start_y + week_idx * cell_height
# 判断是否有记事
date_str = f"{self.year}-{self.month:02d}-{day:02d}"
has_events = (date_str in self.diary_data and
any(self.diary_data[date_str].values()))
# 不同样式绘制
if has_events:
draw.rectangle([x, y, x + cell_width - 5, y + cell_height - 5],
fill=(255, 250, 205), # 浅黄色填充
outline=(255, 165, 0), # 橙色边框
width=2)
else:
draw.rectangle([x, y, x + cell_width - 5, y + cell_height - 5],
outline=(200, 200, 200),
width=1)
# 绘制日期
draw.text((x + 10, y + 10), str(day), fill=(0, 0, 0), font=date_font)
# 显示记事预览
if has_events:
data = self.diary_data[date_str]
y_offset = 45
if data.get("morning"):
text = "🌅" + (data["morning"][:8] + "..."
if len(data["morning"]) > 8
else data["morning"])
draw.text((x + 10, y + y_offset), text,
fill=(255, 100, 0), font=text_font)
y_offset += 25
if data.get("noon"):
text = "☀️" + (data["noon"][:8] + "..."
if len(data["noon"]) > 8
else data["noon"])
draw.text((x + 10, y + y_offset), text,
fill=(255, 165, 0), font=text_font)
y_offset += 25
if data.get("evening"):
text = "🌙" + (data["evening"][:8] + "..."
if len(data["evening"]) > 8
else data["evening"])
draw.text((x + 10, y + y_offset), text,
fill=(0, 0, 255), font=text_font)
# 保存到内存
buffer = io.BytesIO()
img.save(buffer, format='PNG')
buffer.seek(0)
return buffer.read()
效果图
以上就是基于Python开发日历记事本的完整教程的详细内容，更多关于Python日历记事本的资料请关注脚本之家其它相关文章！
相关文章
这篇文章主要介绍了git进行版本控制的心得和经验，给并大家总结了作者的技巧，需要的朋友们参考一下吧。2017-12-12
在 Python 编程中,我们经常需有时候,我们可能需要将多个文本文件合并成一个文件,要处理文本文件,本文就来介绍下如何使用 wxPython 模块编写一个简单的程序,能够让用户选择多个文本文件,感兴趣的可以了解下2023-08-08
这篇文章主要介绍了Python图片批量自动抠图去背景,只要上传图片，就可以自动把背景去掉把目标对象抠出来，非常方便，对Python图片批量自动抠图去背景的代码感兴趣的朋友一起看看吧2022-03-03
这篇文章主要给大家介绍了关于利用Python实现网络测试的方法，文中给出了详细的示例代码供大家参考学习，对大家具有一定的参考学习价值，需要的朋友们下面来一起看看吧。2017-05-05
Python VisPy库高性能科学可视化图形处理用法实例探究
VisPy是一个用于高性能科学可视化的Python库，它建立在现代图形处理单元（GPU）上，旨在提供流畅、交互式的数据可视化体验，本文将深入探讨VisPy的基本概念、核心特性以及实际应用场景，并通过丰富的示例代码演示其强大的可视化能力2023-12-12
这篇文章主要介绍了Python GIL全局解释器锁的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教2025-04-04
异常是一个事件，该事件会在程序执行过程中发生，影响了程序的正常执行。 运算符重载，意味着在某个类的方法中拦截内置的操作，当类的实例出现在内置操作中，Python会调用你的方法，并且方法的返回值会作为相应操作的结果。本文主要介绍了python的高级异常和运算符重载2021-06-06
这篇文章主要介绍了python aeon库进行时间序列算法预测分类实例探索,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2024-02-02
python 使用 with open() as 读写文件的操作方法
这篇文章主要介绍了python 使用 with open()as 读写文件的操作代码，写文件和读文件是一样的，唯一区别是调用open()函数时，传入标识符'w'或者'wb'表示写文本文件或写二进制文件,需要的朋友可以参考下2022-11-11
这篇文章主要为大家介绍了python生成器和匿名函数，具有一定的参考价值，感兴趣的小伙伴们可以参考一下，希望能够给你带来帮助2022-01-01
最新评论