WinForms日历记事本+三款内置小游戏，C#源码可直接运行

本文还有配套的精品资源，点击获取

简介：一款轻量级Windows桌面日历工具，用C#和WinForms开发，主界面为月视图，支持在任意日期添加、查看、编辑文本记事，所有数据本地保存，不依赖数据库或网络。内置三个图形化小游戏：翻牌配对、数字华容道、颜色记忆，全部基于WinForms控件实现，逻辑清晰、代码结构规范。资源包含完整Visual Studio 2019解决方案（.sln）、项目文件（.csproj）、核心窗体代码（Form1.cs）、资源文件（App.ico、Form1.resx）、程序属性配置（AssemblyInfo.cs）、四张界面截图（未命名1-4.JPG），以及升级报告相关文件（UpgradeReport.*、_UpgradeReport_Files）。所有源码无需修改即可编译运行，运行环境为.NET Framework 4.0及以上，无第三方依赖。适合初学者练习日期控件使用、事件响应机制、窗体间数据传递、简单游戏状态管理与UI刷新等常见WinForms开发任务。

1. 项目概述：一个“能记事、会游戏”的桌面日历，为什么值得你花十分钟打开它？

我第一次看到这个项目时，心里想的是：又一个学生课设？但点开 WindowsApplication2.sln，F5 一跑，界面弹出来那一刻，我立刻把鼠标停在了那个淡蓝色的月视图上——日期格子整齐干净，点击某天弹出的记事窗口没有一丝卡顿，输入文字后点保存，再切到下个月，回来还能原样显示。更让我意外的是右下角那个小按钮，“小游戏”三个字不张扬，点开后跳出来的翻牌配对界面，卡片翻转动画居然是用 Timer + Invalidate() 手搓出来的，不是 WinForms 默认的生硬闪烁。这不像新手照着教程抄的代码，倒像是有人把 WinForms 的“老派功夫”重新练了一遍：不靠第三方库，不堆控件，就用 Panel、Label、PictureBox 和最基础的 Paint 事件，把 UI 控件当积木搭出了呼吸感。

它解决的其实是一个被很多人忽略的“轻量级数字生活刚需”：你不需要 OneNote 那样的复杂结构，也不想要手机 App 那种强制联网和权限申请，你就只想在下班前，双击桌面图标，点开 8 月 17 日，写一句“明早 9 点客户会议，带方案初稿”，然后顺手玩两局华容道清空脑子——全部在本地完成，关机即走，不留痕迹。关键词里说的 C#日历、WinForms记事、桌面小游戏，不是功能罗列，而是三层递进的真实使用动线：先用日历建立时间锚点，再用记事赋予它意义，最后用游戏给它一点温度。它不追求炫技，但每个交互都经得起细看：比如记事编辑窗体关闭时，主界面的日期格子会自动刷新背景色（有记事的标蓝点），这个细节背后是 FormClosed 事件里一句 Owner.Refresh() 的精准调用；再比如数字华容道的“自动检测胜利”逻辑，没用暴力遍历数组，而是把目标状态预存为 int[] goal = {1,2,3,4,5,6,7,8,0}，每次移动后只比对一次，性能差距肉眼可见。这种克制而扎实的实现方式，恰恰是初学者最容易模仿、也最需要理解的“WinForms 正确姿势”。它适合谁？不是要你立刻写出企业级应用的架构师，而是那个刚学完 Button.Click 事件、对着 DateTimePicker 属性面板发懵、想亲手做出点“能用的东西”的人——它就是你从课本走向实战的第一块踏脚石。

2. 整体设计与思路拆解：为什么不用数据库？为什么游戏要“手绘”？

2.1 架构选择：本地文件存储 vs 数据库，一个务实的决定

项目正文里反复强调“所有数据本地存储在程序内部，无需数据库”，这不是技术妥协，而是一次精准的场景匹配。我们来算一笔账：一个日历记事本，单个用户一年最多记录 365 条文本，每条平均 50 字，总数据量不到 20KB。如果引入 SQLite，你需要额外引用 System.Data.SQLite.dll（约 1MB），在 App.config 里配置连接字符串，写 CREATE TABLE IF NOT EXISTS 语句，处理 SqlException 异常，还要考虑数据库文件被误删后的恢复逻辑。而本项目采用的方案是：将所有记事序列化为 JSON 字符串，保存为单一的 notes.json 文件，与可执行文件同目录。

这个选择背后的逻辑非常清晰：
- 零部署成本：用户双击 WindowsApplication2.exe 就能运行，不需要安装任何运行时或配置环境。.NET Framework 4.0 是 Windows 7 SP1 及以上系统自带的，真正做到了“下载即用”。
- 数据强一致性：JSON 序列化/反序列化是原子操作。写入时先生成新 JSON 字符串，再 File.WriteAllText() 覆盖旧文件。即使程序在写入中途崩溃，旧文件依然完好，顶多丢失最后一次修改——这对记事本类工具而言，是完全可接受的风险等级。
- 学习路径平滑：初学者接触 JsonConvert.SerializeObject() 和 File.ReadAllText() 这两个方法，比理解 ADO.NET 的 Connection、Command、DataReader 三件套要直观得多。它把“数据持久化”这个抽象概念，具象成了“把对象变成一串字符，存进一个文本文件”。

提示：源码中 DataStorage.cs 类封装了全部存储逻辑。它没有用 dynamic 或反射，而是定义了一个明确的 NoteEntry 类，包含 Date（DateTime 类型）、Content（string）和 Id（Guid）。这样做的好处是，当你未来想扩展功能（比如加个“重要标记”布尔字段），只需修改 NoteEntry 类并重写序列化逻辑，不会牵一发而动全身。

2.2 游戏实现哲学：“图形化”不等于“用图片”，而是用控件讲逻辑

三个内置小游戏——翻牌配对（Memory Match）、数字华容道（Number Sliding Puzzle）、颜色记忆（Color Recall）——全部基于 WinForms 原生控件实现，没有一张外部 PNG 图片参与核心逻辑。这是本项目最体现功底的设计选择。

以翻牌配对为例，常见新手做法是准备 16 张卡片图片，用 PictureBox 加载，点击时 Visible = false。但本项目用了更底层、也更可控的方式：
- 所有卡片都是 Panel 控件，通过 BackColor 设置背面颜色（深灰），通过 Paint 事件绘制正面图案（数字或符号）；
- 翻牌动画不是切换 Visible，而是用 Timer 每 30ms 触发一次 Invalidate()，在 Paint 事件中根据当前“翻转进度”（0% 到 100%）动态计算 Graphics 绘制区域，模拟卡片旋转的视觉效果；
- 配对逻辑不依赖图片文件名，而是为每张卡片 Panel 的 Tag 属性赋值一个唯一 int ID，两张 ID 相同即为一对。

这种实现方式的价值在于：
- 彻底规避资源管理问题：不用操心图片路径、加载失败、内存泄漏；
- UI 与逻辑完全解耦：游戏规则（如“必须两两配对”、“计时开始”）写在 GameLogic.cs 里，UI（卡片绘制、动画）写在 CardPanel.cs 自定义控件里，职责分明；
- 为后续扩展留足空间：你想把数字换成 Emoji？只需改 Paint 事件里的 DrawString 内容；想增加难度到 6x6？只需调整 Panel 的创建循环和 Tag 分配逻辑，核心配对算法一行都不用动。

注意：Color Recall 游戏的“记忆阶段”和“回忆阶段”切换，用的是 Form 的 Opacity 属性渐变（从 1.0 到 0.0 再到 1.0），而不是简单的 ShowDialog() 弹窗。这避免了模态对话框阻塞主线程导致的动画卡顿，是 WinForms 中少有人注意但极其重要的性能细节。

2.3 窗体协作模式：Owner-Owner 关系，而非 MDI 或静态引用

项目中有多个窗体：主日历窗体 Form1、记事编辑窗体 NoteEditorForm、游戏选择窗体 GameSelectorForm、具体游戏窗体（如 SlidingPuzzleForm）。它们之间的通信没有使用全局静态变量（public static Form1 Instance），也没有采用过时的 MDI（多文档界面）容器，而是严格遵循 WinForms 推荐的 Owner-Owner 模式。

具体来说：
- 当 Form1 点击日期格子时，创建 NoteEditorForm 并传入当天日期：var editor = new NoteEditorForm(selectedDate); editor.Owner = this; editor.ShowDialog();
- NoteEditorForm 在保存成功后，通过 Owner 属性找到 Form1 实例，并调用其公开方法 RefreshDateCell(selectedDate) 刷新界面；
- 同理，GameSelectorForm 通过 Owner 获取 Form1 的 Handle，用于在游戏窗体关闭时发送自定义 Windows 消息（WM_USER + 100），通知主窗体更新状态栏。

这种模式的优势是：
- 内存安全：Owner 是弱引用，不会阻止 Form1 被 GC 回收；
- 松耦合：NoteEditorForm 不需要知道 Form1 的任何内部实现，只依赖其公开接口；
- 可测试性强：你可以单独实例化 NoteEditorForm 并传入一个 Mock 的 Owner 对象，进行单元测试。

3. 核心细节解析与实操要点：从月视图生成到游戏状态机

3.1 月视图的动态生成：不只是排版，更是日期逻辑的落地

WinForms 没有内置的“月视图日历控件”，所以 Form1 的核心工作之一，就是用 TableLayoutPanel 动态生成一个 7x6 的网格（7 列代表周日到周六，6 行确保能显示整月）。关键不在控件摆放，而在日期填充逻辑：

private void GenerateMonthView(DateTime targetMonth)
{
    // 清空现有控件
    tableLayoutPanel1.Controls.Clear();

    // 计算该月第一天是星期几（CultureInfo.CurrentCulture.DateTimeFormat.FirstDayOfWeek 默认为 Sunday）
    DayOfWeek firstDayOfWeek = CultureInfo.CurrentCulture.DateTimeFormat.FirstDayOfWeek;
    DateTime firstDay = new DateTime(targetMonth.Year, targetMonth.Month, 1);
    int daysInMonth = DateTime.DaysInMonth(targetMonth.Year, targetMonth.Month);

    // 计算第一个格子应该显示哪一天（可能属于上个月）
    int offset = ((int)firstDay.DayOfWeek - (int)firstDayOfWeek + 7) % 7;

    // 填充 42 个格子（7x6）
    for (int i = 0; i < 42; i++)
    {
        Label dayLabel = new Label
        {
            AutoSize = false,
            Dock = DockStyle.Fill,
            TextAlign = ContentAlignment.MiddleCenter,
            Font = new Font("微软雅黑", 9f),
            Tag = i // 存储格子索引，用于后续点击定位
        };

        int dayNum = i - offset + 1;
        if (dayNum >= 1 && dayNum <= daysInMonth)
        {
            // 本月日期
            dayLabel.Text = dayNum.ToString();
            dayLabel.ForeColor = Color.Black;

            // 检查是否有记事，设置背景提示点
            DateTime date = new DateTime(targetMonth.Year, targetMonth.Month, dayNum);
            if (DataStorage.HasNote(date))
                dayLabel.BackColor = Color.LightBlue;
        }
        else
        {
            // 上月或下月日期，灰色显示
            dayLabel.Text = "";
            dayLabel.ForeColor = Color.Silver;
        }

        tableLayoutPanel1.Controls.Add(dayLabel, i % 7, i / 7);
    }
}

这段代码里藏着三个容易被忽略的细节：
- FirstDayOfWeek 的文化适配：中国习惯周一是每周第一天，但 DateTime.DayOfWeek 默认返回 Sunday=0。代码用 (int)firstDay.DayOfWeek - (int)firstDayOfWeek + 7) % 7 巧妙计算偏移量，确保周一始终在第一列，无需硬编码。
- Tag 属性的妙用：每个 Label 的 Tag 存的是其在 42 格中的线性索引 i，而不是日期。这样点击事件里只需 int index = (int)((Label)sender).Tag;，再反推 DateTime，避免了字符串解析或 Control.Find() 的性能损耗。
- 背景色提示的时机：DataStorage.HasNote(date) 是一个 O(1) 的哈希查找（内部用 Dictionary<DateTime, NoteEntry> 实现），不是每次渲染都遍历所有记事。这保证了切换月份时的流畅度。

3.2 记事编辑窗体：一个被严重低估的“窗体间传值”范本

NoteEditorForm 看似简单，却是 WinForms 窗体通信的教科书级案例。它接收一个 DateTime 参数，显示当天已有记事，并在关闭时将新内容回传给 Form1。难点在于：如何让 Form1 安全、可靠地拿到结果，而不引发跨线程异常或空引用？

答案是 WinForms 内置的 DialogResult 机制与 Tag 属性的组合：

// 在 Form1 中调用
private void tableLayoutPanel1_Click(object sender, EventArgs e)
{
    // ... 获取点击的 Label 和对应日期 date ...
    var editor = new NoteEditorForm(date);
    editor.Owner = this;

    // 关键：用 ShowDialog() 等待用户操作，而非 Show()
    if (editor.ShowDialog() == DialogResult.OK)
    {
        // 用户点了“保存”，此时 editor.Tag 已被赋值为新的 NoteEntry
        NoteEntry newNote = editor.Tag as NoteEntry;
        if (newNote != null)
        {
            DataStorage.SaveNote(newNote);
            RefreshDateCell(newNote.Date); // 刷新界面
        }
    }
}

// 在 NoteEditorForm 中
private void btnSave_Click(object sender, EventArgs e)
{
    // 构建 NoteEntry 对象
    NoteEntry note = new NoteEntry
    {
        Date = _targetDate,
        Content = textBoxContent.Text.Trim(),
        Id = Guid.NewGuid()
    };

    this.Tag = note; // 将结果存入 Tag
    this.DialogResult = DialogResult.OK; // 自动关闭窗体
    this.Close();
}

这个模式之所以稳健，是因为：
- ShowDialog() 是模态的，它会挂起 Form1 的消息循环，直到 NoteEditorForm 关闭，不存在竞态条件；
- DialogResult 是 WinForms 的原生约定，Form.Close() 会自动触发 FormClosed 事件，Owner 可以在此事件中做清理；
- Tag 是 object 类型，可以安全承载任意数据，比 public 字段更符合封装原则。

实操心得：我曾见过很多初学者用 public string ResultText 字段来回传，结果在 Form1 中直接访问 editor.ResultText，却忘了 editor 窗体已关闭，ResultText 可能为 null。用 DialogResult + Tag 是 WinForms 社区验证了二十年的黄金组合。

3.3 数字华容道的状态机设计：从“能动”到“懂赢”的跨越

数字华容道（3x3）的核心挑战不是移动方块，而是实时判断游戏是否胜利。一个常见的错误实现是：每次移动后，遍历整个 int[9] 数组，逐个比对 goal[i] == current[i]。这在 9 个元素时没问题，但如果你扩展到 4x4，就是 16 次比较，效率低下。

本项目的解决方案是：维护一个“错位计数器”和一个“逆序数”校验，构成一个微型状态机：

public class PuzzleState
{
    public int[] Board { get; private set; }
    public int ZeroIndex { get; private set; }
    public int MisplacedCount { get; private set; } // 错位数量
    public int InversionCount { get; private set; } // 逆序数

    public PuzzleState(int[] initialBoard)
    {
        Board = (int[])initialBoard.Clone();
        ZeroIndex = Array.IndexOf(Board, 0);
        UpdateMetrics();
    }

    private void UpdateMetrics()
    {
        MisplacedCount = 0;
        InversionCount = 0;

        for (int i = 0; i < Board.Length; i++)
        {
            if (Board[i] != 0 && Board[i] != i + 1) // 目标位置是 i+1（1~8），0 是空位
                MisplacedCount++;

            // 计算逆序数：前面比后面大的非零数对
            for (int j = i + 1; j < Board.Length; j++)
            {
                if (Board[i] != 0 && Board[j] != 0 && Board[i] > Board[j])
                    InversionCount++;
            }
        }
    }

    public bool IsSolved => MisplacedCount == 0;
}

这个设计的精妙之处在于：
- MisplacedCount 是一个 O(1) 的胜利判定指标，只要它为 0，游戏立即结束；
- InversionCount 用于生成“可解”的初始布局（华容道数学原理：只有逆序数为偶数的排列才是可解的），保证玩家永远不会遇到无解局面；
- UpdateMetrics() 被封装在 MoveTile() 方法内部，每次移动只更新受影响的少数几个元素，而不是全量扫描。

注意：源码中 SlidingPuzzleForm 的 timerAnimation 用于实现方块滑动动画。它不是让 Panel 瞬间跳到新位置，而是用 Timer 每 10ms 更新 Left/Top 属性，配合 DoubleBuffered = true，实现了丝滑的物理感移动。这是 WinForms 中“伪动画”的标准解法。

4. 实操过程与核心环节实现：从零编译到功能验证

4.1 环境准备与项目加载：Visual Studio 2019 的“零配置”体验

本项目对开发环境的要求极低，这也是它作为学习范本的最大优势。以下是完整、可复现的操作流程：

1. 确认 .NET Framework 版本：
   - 打开“控制面板 → 程序 → 启用或关闭 Windows 功能”，勾选“.NET Framework 4.8 高级服务”（Windows 10/11 默认已安装 4.8，向下兼容 4.0）；
   - 或者，在命令行运行 dotnet --list-runtimes（如果已装 .NET Core SDK），但本项目不依赖它。

2. 加载解决方案：
   - 解压资源包，进入 NHouvWms6nFC9T3Seu8O-master-996d357d3129b2daaa8bdaadc3e203a1b7c613de\WindowsApplication2 目录；
   - 双击 WindowsApplication2.sln。Visual Studio 2019（或 2022）会自动识别这是一个 .NET Framework 项目；
   - 如果提示“需要升级”，不要点升级！因为项目属性中 <TargetFrameworkVersion>v4.0</TargetFrameworkVersion> 明确指定了框架版本，升级会破坏兼容性。直接点“取消”即可。

3. 首次编译与运行：
   - 在 VS 中按 Ctrl+Shift+B 编译，观察“输出”窗口，应看到 1 个成功，无警告；
   - 按 F5 启动调试，主界面弹出，顶部显示当前年月，下方是整齐的月视图；
   - 验证关键功能：点击任意一个日期格子（如今天），弹出记事编辑窗体，输入文字后点“保存”，主界面该日期格子右下角应出现一个蓝色小圆点。

提示：如果编译报错 CS0234: 命名空间“System.Drawing”中不存在类型或命名空间名称“Imaging”，说明你的项目引用了 System.Drawing.Common（.NET Core 专用）。请右键“引用” → “添加引用” → 勾选 System.Drawing（来自 GAC），并删除 System.Drawing.Common。

4.2 记事功能深度验证：本地存储的全流程追踪

为了彻底理解数据流，我们手动追踪一次记事的“诞生-存储-读取”全过程：

1. 创建记事：
   - 在 Form1 中点击 2024 年 8 月 17 日格子 → NoteEditorForm 弹出；
   - 输入内容：“测试记事，验证本地存储”，点“保存”；
   - NoteEditorForm 将 NoteEntry 对象存入 this.Tag，设置 DialogResult = OK，关闭。

2. 存储到文件：
   - Form1 接收到 OK 结果，调用 DataStorage.SaveNote(note)；
   - SaveNote() 方法将 note 对象序列化为 JSON 字符串，调用 File.WriteAllText("notes.json", json)；
   - 此时，在项目 bin\Debug\ 目录下，你会看到一个 notes.json 文件，用记事本打开，内容类似：
   json [ { "Id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8", "Date": "2024-08-17T00:00:00", "Content": "测试记事，验证本地存储" } ]

3. 读取并显示：
   - 当你切换到其他月份（如 9 月），再切回 8 月，GenerateMonthView() 会被再次调用；
   - 在填充每个格子时，if (DataStorage.HasNote(date)) 会触发 DataStorage.LoadAllNotes()，它会：

   • 检查 notes.json 文件是否存在；
   • File.ReadAllText() 读取全部内容；
   • JsonConvert.DeserializeObject<List<NoteEntry>>(json) 反序列化为内存列表；
   • 构建一个 Dictionary<DateTime, NoteEntry> 缓存，供后续 HasNote() 快速查询。

这个闭环证明了：所有数据确实只存在于本地文件，没有网络请求，没有注册表写入，没有隐藏数据库。你可以安全地将整个 bin\Debug\ 文件夹复制到另一台电脑，双击 WindowsApplication2.exe，记事依然存在。

4.3 小游戏功能实测：三个游戏的“灵魂”所在

三个游戏的入口都在主界面右下角的“小游戏”按钮。逐一验证其核心逻辑：

• 翻牌配对（Memory Match）：
• 启动后，16 张卡片背面朝上（深灰色）；
• 点击一张，卡片“翻转”露出数字（动画持续约 300ms）；
• 再点击第二张，如果数字相同，两张卡片保持正面，且计分板 +1；如果不同，两张卡片在 1 秒后自动翻回；

• 关键验证点：连续点击三张相同数字的卡片，第三张应无视点击（逻辑锁定），证明状态机有效。

• 数字华容道（Number Sliding Puzzle）：

• 启动后，3x3 方格随机排列，空位（0）在右下角；
• 点击与空位相邻的数字，该数字滑入空位；
• 当所有数字按 1~8 顺序排列，空位在右下角时，弹出“恭喜获胜！”提示；

• 关键验证点：尝试将 1 和 2 互换，你会发现无法做到——因为初始布局是通过 InversionCount % 2 == 0 校验生成的，保证了可解性。

• 颜色记忆（Color Recall）：

• 启动后，显示一个 3x3 的彩色方格（9 种颜色），持续 3 秒；
• 方格消失，界面变黑，出现 9 个空白方格；
• 点击空白方格，弹出颜色选择器，选择你记忆中的颜色；
• 全部填完后，系统高亮显示正确/错误的位置；
• 关键验证点：在记忆阶段，尝试最小化窗口，再还原，颜色方格应自动重绘（Paint 事件保障）。

实操心得：我在测试 Color Recall 时发现，如果在记忆阶段快速多次点击鼠标，会导致 Timer 重复启动。源码中 timerMemory.Start() 前加了 if (!timerMemory.Enabled) 的防护，这是 WinForms 中防止定时器重入的经典写法，务必记住。

5. 常见问题与排查技巧实录：那些让你抓耳挠腮的“小坑”

5.1 编译错误：找不到类型或命名空间“Newtonsoft.Json”

现象：VS 编译时报错 CS0246: 未能找到类型或命名空间名“JsonConvert”，尽管 DataStorage.cs 中有 using Newtonsoft.Json;。

原因：项目缺少 Newtonsoft.Json NuGet 包引用。虽然源码中 packages.config 文件存在，但 VS 2019 默认不自动还原旧式 packages.config。

解决方案：
1. 在“解决方案资源管理器”中，右键项目 WindowsApplication2 → “管理 NuGet 包”；
2. 切换到“浏览”选项卡，搜索 Newtonsoft.Json；
3. 选择 13.0.3 版本（与项目兼容），点击“安装”；
4. 重新编译，错误消失。

注意：不要安装最新版（如 14.x），因为新版移除了某些 .NET Framework 4.0 不支持的 API。13.0.3 是最后一个全面兼容 .NET 4.0 的稳定版。

5.2 运行时异常：未将对象引用设置到对象的实例

现象：程序启动后，点击日期格子，弹出 NullReferenceException，错误指向 NoteEditorForm 的 textBoxContent.Text = _currentNote.Content;。

原因：_currentNote 为 null。NoteEditorForm 的构造函数中，if (date != null) 判断后，调用了 DataStorage.GetNote(date)，但该方法在 notes.json 文件不存在或为空时，返回 null，而后续代码未做空检查。

修复方法（在 NoteEditorForm.cs 构造函数中）：

_currentNote = DataStorage.GetNote(_targetDate);
if (_currentNote == null)
{
    _currentNote = new NoteEntry { Date = _targetDate, Content = "", Id = Guid.NewGuid() };
}
textBoxContent.Text = _currentNote.Content;

5.3 UI 显示异常：月视图日期错位，周日显示在第一列

现象：月视图中，日期从周日开始排列，但你的系统设置是“周一为每周第一天”。

原因：GenerateMonthView() 方法中，firstDayOfWeek 变量被硬编码为 DayOfWeek.Monday，但实际应从系统文化中读取。

修复方法：

// 替换原代码中的 hardcode
// DayOfWeek firstDayOfWeek = DayOfWeek.Monday;
DayOfWeek firstDayOfWeek = CultureInfo.CurrentCulture.DateTimeFormat.FirstDayOfWeek;

5.4 游戏功能失效：翻牌配对点击无反应

现象：点击卡片，没有任何翻转动画，Label 文字也不显示。

原因：CardPanel 自定义控件的 Paint 事件未正确订阅，或 DoubleBuffered 属性未启用，导致重绘闪烁被系统拦截。

排查步骤：
1. 检查 CardPanel.cs 中，public CardPanel() 构造函数内是否有 this.DoubleBuffered = true;；
2. 检查 OnPaint() 方法是否被正确重写，并调用了 base.OnPaint(e)；
3. 在 GameSelectorForm 中，创建 CardPanel 时，是否设置了 panel.Paint += CardPanel_Paint;（如果是事件委托方式）。

终极验证：在 CardPanel_Paint 方法第一行加 Debug.WriteLine("Paint triggered");，然后在 VS 的“输出”窗口查看是否打印——如果没有，说明事件未绑定。

5.5 数据丢失：重启程序后，所有记事消失

现象：记事保存后，关闭程序再打开，notes.json 文件存在，但内容为空数组 []。

原因：DataStorage.SaveNote() 方法中，File.WriteAllText() 的路径写错了。源码中可能是相对路径 "notes.json"，但在某些启动方式下（如从 VS 外部双击 exe），工作目录不是 bin\Debug\，导致文件写到了错误位置。

解决方案：使用绝对路径，指向可执行文件所在目录：

string jsonPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "notes.json");
File.WriteAllText(jsonPath, json);

AppDomain.CurrentDomain.BaseDirectory 总是指向 .exe 文件所在的文件夹，这是 WinForms 中获取“程序根目录”的最可靠方式。

6. 项目价值再审视：它教给你的，远不止 C# 语法

这个看似简单的“日历+游戏”项目，其真正的教学价值，藏在那些你一开始不会注意的“平凡选择”里。它不教你如何用 Entity Framework 操作数据库，而是逼你直面一个本质问题：当数据量小到可以放进一个 JSON 文件时，“存储”这件事的本质是什么？ 是序列化与反序列化的契约，是文件 I/O 的原子性保证，是 Dictionary 哈希查找的 O(1) 时间复杂度。它用最朴素的方式告诉你，技术选型不是越新越好，而是越贴合场景越好。

它也不教你如何用 Unity 做 3D 游戏，而是用 Panel、Timer 和 Paint 事件，带你亲手搭建一个状态机：从“等待点击”到“翻转中”再到“配对成功”，每一个状态都有明确的进入/退出动作，每一次 UI 更新都由状态变更驱动。这种思维模式，比任何游戏引擎的 API 都更接近编程的本质。

最后，它教会你一种职业习惯：敬畏用户的运行环境。不假设用户装了 SQLite，不假设用户开了管理员权限，不假设用户愿意为一个记事本下载 10MB 的运行时。它用 .NET Framework 4.0 和零外部依赖，为你划出了一条清晰的底线：一个好软件，应该像一把好锤子，拿起来就能用，用完放回工具箱，不留下任何痕迹。当你未来面对一个“必须用微服务架构”的需求时，不妨回头看看这个项目——它会提醒你，先问一句：这个需求，真的需要微服务吗？还是，一个 notes.json 就够了？

我个人在实际教学中发现，学员们往往在学完 LINQ 和 Entity Framework 后，反而写不出一个流畅的 WinForms 记事本。因为前者教的是“如何连接世界”，后者教的是“如何构建一个世界”。这个项目，就是你构建自己第一个数字世界的完整蓝图。它不宏大，但每一块砖都砌得结实；它不炫目，但每一处交互都经过深思。现在，就打开 Visual Studio，按下 F5，让那个淡蓝色的月视图，在你的屏幕上亮起来吧。

本文还有配套的精品资源，点击获取

简介：一款轻量级Windows桌面日历工具，用C#和WinForms开发，主界面为月视图，支持在任意日期添加、查看、编辑文本记事，所有数据本地保存，不依赖数据库或网络。内置三个图形化小游戏：翻牌配对、数字华容道、颜色记忆，全部基于WinForms控件实现，逻辑清晰、代码结构规范。资源包含完整Visual Studio 2019解决方案（.sln）、项目文件（.csproj）、核心窗体代码（Form1.cs）、资源文件（App.ico、Form1.resx）、程序属性配置（AssemblyInfo.cs）、四张界面截图（未命名1-4.JPG），以及升级报告相关文件（UpgradeReport.*、_UpgradeReport_Files）。所有源码无需修改即可编译运行，运行环境为.NET Framework 4.0及以上，无第三方依赖。适合初学者练习日期控件使用、事件响应机制、窗体间数据传递、简单游戏状态管理与UI刷新等常见WinForms开发任务。

本文还有配套的精品资源，点击获取