做Java图形界面，很多人第一反应是“这东西还有人在学吗？”——有，而且上手做一个可视化日历，几乎就是练手GUI最好的小项目。它不涉及数据库、不依赖网络，核心就两件事：把日期算清楚，把格子摆好看。对零基础的人来说，做完这个日历，Java基础语法、面向对象、Swing组件、事件监听这些最容易劝退的知识点，基本就都串起来了。而且它是个看得见摸得着的东西，点一下按钮月份就切换，双击日期还能跳到对应的那一天，这种即时反馈带来的成就感，比刷一百道基础练习题都管用。
这篇文章我会直接用一套能运行的代码带你走完整个流程。从最基础的界面搭建讲起，一步一步把年月切换、日期填充、选中高亮这些功能加进去。你不用提前学过Swing，只要看得懂最基本的if、for循环，就能跟着把代码敲出来。文章里所有代码都是完整的，直接复制到IDE里就能跑，碰到报错也能在这篇文章里找到对应的排查办法。
1. 项目拆解：可视化日历到底在做什么
1.1 先读懂需求，再写代码
做任何项目的第一步都不是打开IDE写代码，而是先把需求想明白。可视化日历，拆开看就是“可视化”加“日历”两个词。日历要做的事很简单：展示某年某月的所有日期，并按照星期一到星期日排好顺序。可视化要做的事更简单：把这些日期画在窗口上，让用户看得见、点得着。
那这个项目具体就是这样一个东西：一个窗口，顶部显示当前的年月，中间是排好序的日期格子，底部可以展示一些附加信息，比如当前选中的日期。用户点击左右箭头可以切换月份，点具体的日期格子可以把那一天“选中”，状态一眼就能看出来。
很多新手容易犯一个错误：一开始就想着把功能做“全”。什么农历、节假日、备忘提醒，统统都要加上。我的建议是，第一版先把最核心的骨架搭出来——能显示、能切换、能选中，这三个功能做好之后再谈其他。你想想，房子都没盖好，你急着装修客厅干什么？
1.2 技术选型：为什么用Swing而不是JavaFX
Java做图形界面主要有两条路：Swing和JavaFX。JavaFX更年轻，界面效果更现代，但这几年Oracle对它的更新节奏明显放缓，社区活跃度也在下降。Swing虽然老，但它有一个无可替代的优势：简单。
Swing的组件体系非常直白：窗口叫JFrame，按钮叫JButton，标签叫JLabel，它们之间的关系就是“把某个组件加到另一个组件里面”。这种设计对新手极其友好，你不需要理解复杂的布局引擎和渲染管线，只需要知道“我把这个标签放进了这个面板”就够了。
另外，Swing是JDK自带的，不需要额外引入任何依赖。这对于学习阶段来说太重要了，你省掉了配置Maven、下载依赖这一大堆前置工作。我现在带的几个学生，凡是JavaFX的项目，有一半的时间都花在环境搭建上；而Swing的项目，基本能做到“新建项目就能跑”。
那Swing的缺点是啥？外观老气，按钮长得像上个世纪的产物。这个问题其实也很好解决，后面我会讲怎么通过统一字体、配色和间距让它看起来不那么丑，甚至可以说，做完美化这一步，你对Swing布局和属性的理解会再上一个台阶。
1.3 功能清单与界面布局规划
动手之前，先把功能清单列出来，越具体越好：
- 显示当前年月，默认打开时定位到今天所在的月份
- 按周一到周日的顺序，把当月的所有日期显示在7列的表格里
- 月份切换按钮：上月、下月，跨年时要自动进位
- 点击某个日期，高亮显示选中状态
- 在底部显示当前选中的“某年某月某日”，如果没选中任何日期就显示当天
界面布局就按照从上到下的顺序分为三块：顶部控制栏放月份切换按钮和年月显示；中部日期表格放星期表头和日期格子；底部信息栏放选中日期的提示文字。
用Swing的术语来说，这三个区域分别是三个JPanel，通过BorderLayout布局管理器，以NORTH、CENTER、SOUTH三个方位放进JFrame这个主窗口里。这个结构现画个脑子里的草图：
+-----------------------------------------------+ | [<上月] 2025年7月 [下月>] | ← NORTH +-----------------------------------------------+ | 一 二 三 四 五 六 日 | | [ ] [ ] [ ] [ ] [ ] [ ] [ ] | ← CENTER | ... (日期格子) | +-----------------------------------------------+ | 选中日期：2025年7月15日 | ← SOUTH +-----------------------------------------------+2. 界面搭建：从零创建第一个Java窗口
2.1 环境准备与项目骨架
先说环境。JDK建议用8以上的版本，因为后面要用的LocalDate和YearMonth这两个日期API是Java 8才引入的，它们比老旧的java.util.Calendar好用太多。别再用Calendar了，那个类的月份从0开始数，你要处理12月得写成11，新手十个人里有八个会在这里栽跟头。LocalDate就没有这个问题，12月就是12，逻辑自然清晰。
IDE方面，IDEA社区版或者Eclipse都行，这一步不需要任何特殊插件。开发前先确认你的控制台能正常输出System.out.println("hello")，确保Java环境本身没问题。这一步看着简单，实际上能过滤掉一多半的问题，很多学员卡了好几天，最后发现是JDK没配好。
项目结构现在不需要搞那么复杂，一个类就够。后面要拆分代码的时候再说重构的事，学习阶段最忌讳的就是过度设计。你就创建一个包，比如com.calendar.demo，然后在里面新建一个类，叫CalendarFrame，继承JFrame。这一个类就是整个日历的主窗口。
2.2 JFrame主窗口与组件层级
JFrame是Swing里的顶层窗口，所有其他组件都要“放”到它里面或者放到它里面的面板上。我习惯用一个比喻：JFrame就是一张桌子，JPanel是桌上的托盘，按钮和标签这些就是托盘里的菜。你不能直接把菜撒在桌上，得先放在托盘里，再把托盘放上桌。
第一步先创建一个空窗口：
import javax.swing.*; import java.awt.*; public class CalendarFrame extends JFrame { public CalendarFrame() { setTitle("可视化日历"); setSize(480, 420); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); setResizable(false); setVisible(true); } public static void main(String[] args) { new CalendarFrame(); } }这些设置每行都有它的意义：setTitle设置窗口标题栏的文字；setSize决定窗口的宽高，单位是像素；setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE)让用户点关闭按钮时程序真正退出，如果不写，窗口关了程序还后台跑着；setLocationRelativeTo(null)让窗口居中显示；setResizable(false)禁止用户拖拽改变窗口大小。最后那一行setVisible(true)是最容易被漏掉的，很多人写完代码一点反应都没有，就是因为窗口创建了但没让它显示出来。
这里要提醒一个细节：组件的创建顺序和显示顺序是两回事。你可以在setVisible(true)之后继续往窗口里添加组件，但为了思路清晰，建议先在构造方法里把所有组件搭好，最后一口气显示窗口。
3. 日期计算：日历大脑的核心逻辑
3.1 日期与星期的基本概念
这个项目里最核心的算法问题就一个：已知某年某月，怎么知道这个月有多少天，以及这个月的第一天是星期几？
这两个问题都有现成的解决方案。天数用YearMonth类：YearMonth.of(year, month).lengthOfMonth()，它会自动处理大月小月，以及闰年2月29天的情况。第一天是星期几，用LocalDate.of(year, month, 1).getDayOfWeek().getValue()，这个方法返回1到7的整数，1表示周一，7表示周日。
很多教程喜欢在这一步玩花样，比如用Calendar类算偏移量，或者干脆写死一个闰年判断公式。我的建议是：能调用现成API就别自己造轮子。你想想，别人写好了、经过无数项目验证的代码，你非要自己重写一个，除了增加出错概率没有任何好处。等写下第一篇业务代码的时候，你会发现大部分日期逻辑其实都在跟这两个API打交道。
这个月的首日是星期几解决了，上个月残留的空白区域也就确定了。比如这个月1号是星期三，那表格第一行前两格就是空的，从第三格开始才是1号。这个“偏移量”是日历排布的核心，理解了它，整个项目的搭建思路就通了。
3.2 获取当月天数和首日星期偏移
我把这两个关键方法单独抽出来，方便你随时调用和理解：
// 获取某年某月的天数 public int getDaysInMonth(int year, int month) { return YearMonth.of(year, month).lengthOfMonth(); } // 获取某年某月第一天是星期几（1=周一，7=周日） public int getFirstDayOfWeek(int year, int month) { return LocalDate.of(year, month, 1).getDayOfWeek().getValue(); }再往下想一步，日历表格通常是以周一作为第一列的。那第一行开头的空格数量，就是getFirstDayOfWeek的返回值减1。比如1号正好是周一，偏移量就是0，第一格直接放1号；1号是周日，偏移量就是6，第一行前面6格全部留空。
这里有个容易绕晕的地方：getDayOfWeek().getValue()的返回值是1到7，但它不代表“实际占用的格子数”。你可以把偏移量理解为“前面空几个格子”，这两个概念虽然数值一样，但代表的含义完全不同——一个是星期几，一个是空格数量。写代码的时候脑子里一定要把这个转换捋清楚，不然排出来的日历永远错一位。
3.3 边界情况处理
边界情况是日期计算最容易翻车的地方。最常见的两个：一个是跨年，12月的下一个月不是13月，而是下一年的1月；另一个是闰年2月，平年28天，闰年29天。这两个问题用YearMonth.withMonth或直接手动判断都能解决，但我更推荐一种写法：利用LocalDate的plusMonths方法自动调整。
比如你要显示下个月的年月，可以这么算：
LocalDate currentDate = LocalDate.of(year, month, 1); LocalDate nextMonth = currentDate.plusMonths(1); int newYear = nextMonth.getYear(); int newMonth = nextMonth.getMonthValue();plusMonths(1)会自动处理跨年，你完全不关心12月加1个月应该是次年1月这类问题，代码的可读性也提高了不少。上个月同理，用minusMonths(1)。
这个思路还能延伸到日期格子的点击选中功能。你只需要一个LocalDate selectedDate变量记录当前选中日期，点击格子时把它赋值为对应的年月日即可。有了这个变量，跨年、跨月的边界问题自动消解了，因为LocalDate内部已经把一切都处理好了。
4. 核心代码：一格一格把日期摆上界面
4.1 动态刷新日历网格
窗口搭好了，日期也算明白了，接下来就是把日期填进格子。这里的关键问题是怎么处理“动态刷新”。
我的做法是：用一个JPanel作为日期区域，给它设置GridLayout(0, 7)，也就是7列、行数自动扩展的网格布局。每次要显示新月份时，先把这个面板里的所有旧组件清空，再重新计算日期，重新往里面添加标签。简单粗暴，但足够用。
private void refreshCalendar(int year, int month) { // 清空原有组件 datePanel.removeAll(); datePanel.setLayout(new GridLayout(0, 7)); int days = getDaysInMonth(year, month); int offset = getFirstDayOfWeek(year, month) - 1; // 填充偏移空格 for (int i = 0; i < offset; i++) { datePanel.add(new JLabel("")); } // 填充日期 for (int day = 1; day <= days; day++) { JLabel label = new JLabel(String.valueOf(day), SwingConstants.CENTER); datePanel.add(label); } // 重新绘制 datePanel.revalidate(); datePanel.repaint(); }注意最后两行，revalidate()和repaint()。前者告诉布局管理器重新计算组件的摆放位置，后者让界面重新画一遍。刚开始学的时候，我经常写了代码发现界面没变化，原因就是这个：你改动了组件的结构，但没让界面刷新。多写几遍之后你就会形成肌肉记忆，只要改了组件集合，立刻补上这两行。
网格的行数是自动计算的。如果一个月有30天、偏移量是0，总格子数就是30，不够铺满所有行，GridLayout会按照不换行前的容量自动生成行数。但如果你想要固定显示6行，让每个月的界面高度一致，可以在创建JPanel时就写成new GridLayout(6, 7)，这样每一行都会撑满，视觉效果更整齐。
4.2 事件监听：点击按钮切换月份
界面有了，接下来的灵魂是交互。所谓事件监听，用生活化的说法就是：给某个按钮设置一个“触发器”，用户点击它，程序就执行一段预先写好的代码。
Swing的按钮事件用ActionListener接口，它只有一个方法actionPerformed(ActionEvent e)。你就是把这个接口实现好，然后通过button.addActionListener(listener)把按钮和监听器绑起来。
JButton prevButton = new JButton("上月"); prevButton.addActionListener(e -> { // 如果当前是1月，上个月就是去年的12月 LocalDate firstDay = LocalDate.of(currentYear, currentMonth, 1); LocalDate prevMonth = firstDay.minusMonths(1); currentYear = prevMonth.getYear(); currentMonth = prevMonth.getMonthValue(); refreshCalendar(currentYear, currentMonth); updateTitle(); });这里用了lambda表达式，相比Java 7及之前的匿名内部类写法，代码精简了一倍多。如果你没接触过lambda也不用怕，它就是一个匿名函数的语法糖，把它理解成“传一段代码给按钮”就行。
lambda和匿名内部类在这个场景下还有一个细微差别：lambda不能访问外部变量的“局部变量副本”，只能访问“实际上不可变”的局部变量。Eclipse和IDEA的编译提示会明确告诉你哪里有问题，实际开发中我建议把年份和月份封装成一个YearMonth成员变量，而不是拆成两个int，这样既能避免局部变量捕获的问题，代码也更内聚。
4.3 完整代码整合演示
现在把上面的所有内容整合起来，给一个可以直接运行的完整版本。代码不算长，每个部分我在注释里都标明了作用。
import javax.swing.*; import java.awt.*; import java.time.LocalDate; import java.time.YearMonth; public class CalendarFrame extends JFrame { private int currentYear; private int currentMonth; private JLabel titleLabel; private JLabel selectedDateLabel; private JPanel datePanel; private LocalDate selectedDate; public CalendarFrame() { // 默认显示当前年月 LocalDate today = LocalDate.now(); currentYear = today.getYear(); currentMonth = today.getMonthValue(); selectedDate = today; setTitle("可视化日历"); setSize(560, 460); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); setResizable(false); // 顶部控制栏 JPanel topPanel = new JPanel(new BorderLayout()); JButton prevButton = new JButton("< 上月"); JButton nextButton = new JButton("下月 >"); titleLabel = new JLabel("", SwingConstants.CENTER); titleLabel.setFont(new Font("微软雅黑", Font.BOLD, 18)); topPanel.add(prevButton, BorderLayout.WEST); topPanel.add(nextButton, BorderLayout.EAST); topPanel.add(titleLabel, BorderLayout.CENTER); // 日期表格面板 datePanel = new JPanel(new GridLayout(6, 7)); // 底部信息栏 selectedDateLabel = new JLabel("", SwingConstants.CENTER); selectedDateLabel.setFont(new Font("微软雅黑", Font.PLAIN, 14)); // 组装窗口 setLayout(new BorderLayout()); add(topPanel, BorderLayout.NORTH); add(datePanel, BorderLayout.CENTER); add(selectedDateLabel, BorderLayout.SOUTH); // 绑定事件 prevButton.addActionListener(e -> changeMonth(-1)); nextButton.addActionListener(e -> changeMonth(1)); // 初始化显示 refreshCalendar(currentYear, currentMonth); updateSelectedLabel(); setVisible(true); } private void changeMonth(int offset) { LocalDate firstDay = LocalDate.of(currentYear, currentMonth, 1); LocalDate target = firstDay.plusMonths(offset); currentYear = target.getYear(); currentMonth = target.getMonthValue(); refreshCalendar(currentYear, currentMonth); } private void refreshCalendar(int year, int month) { datePanel.removeAll(); // 星期表头 String[] weekDays = {"周一", "周二", "周三", "周四", "周五", "周六", "周日"}; for (String weekDay : weekDays) { JLabel label = new JLabel(weekDay, SwingConstants.CENTER); label.setForeground(new Color(102, 102, 102)); label.setFont(new Font("微软雅黑", Font.BOLD, 14)); datePanel.add(label); } int days = YearMonth.of(year, month).lengthOfMonth(); int offset = LocalDate.of(year, month, 1).getDayOfWeek().getValue() - 1; for (int i = 0; i < offset; i++) { datePanel.add(new JLabel("")); } for (int day = 1; day <= days; day++) { JLabel label = new JLabel(String.valueOf(day), SwingConstants.CENTER); label.setFont(new Font("微软雅黑", Font.PLAIN, 16)); LocalDate thisDate = LocalDate.of(year, month, day); // 当天高亮 if (thisDate.equals(LocalDate.now())) { label.setForeground(Color.RED); label.setFont(new Font("微软雅黑", Font.BOLD, 16)); } // 选中日期高亮 if (thisDate.equals(selectedDate)) { label.setOpaque(true); label.setBackground(new Color(51, 153, 255)); label.setForeground(Color.WHITE); } // 点击选中 label.addMouseListener(new java.awt.event.MouseAdapter() { @Override public void mouseClicked(java.awt.event.MouseEvent e) { selectedDate = thisDate; refreshCalendar(year, month); updateSelectedLabel(); } }); datePanel.add(label); } titleLabel.setText(year + " 年 " + month + " 月"); datePanel.revalidate(); datePanel.repaint(); } private void updateSelectedLabel() { selectedDateLabel.setText("选中日期：" + selectedDate.getYear() + "年" + selectedDate.getMonthValue() + "月" + selectedDate.getDayOfMonth() + "日"); } public static void main(String[] args) { new CalendarFrame(); } }这段代码里有一段你可能不熟悉：label.addMouseListener。之前用的是ActionListener，那是给按钮用的；给JLabel加点击事件，就得用MouseListener。我这里用了MouseAdapter的匿名内部类，只重写了mouseClicked一个方法，这是“适配器模式”在Swing里的一个典型应用——把接口里用不到的方法先给出一套空实现，这样你在重写的时候只需要关注想处理的那一个事件。
如果你直接把MouseListener接在标签上，注意要监听的是“点击”而不是“按下”，这两者的区别在于，鼠标按下去又松开才算一次点击，而只按不松是mousePressed。在日历场景里这个区别影响不大，但如果你以后做拖拽功能，这两个事件就得分清楚了。
5. 界面美化与体验优化
5.1 字体、配色与组件微调
Swing默认的字体是"Dialog"，在Windows下显示出来又小又柴，总给人一种“没做完”的感觉。我的经验是，统一字体是最快提升界面质感的手段。在Windows中文环境下，微软雅黑是比较稳妥的选择，字号控制在14到16之间，标题大一些、日期小一些，形成层次。
配色方面也有讲究。表头用灰色文字，周末和节假日用红色，选中日期用蓝色背景加白色文字，今天的日期用加粗红色。这些颜色不要选择饱和度过高的，否则看久了刺眼。上面代码里用的new Color(51, 153, 255)就是一种比较柔和的蓝色，适合作为选中背景。
还有一个容易被忽略的点是组件间距。网格的格子之间默认没有间距，日期数字会挤在一起。给日期面板设置一个边框就能解决：
datePanel.setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10));EmptyBorder只负责撑开间距，不画线。你也可以用LineBorder画出格子分割线，但我个人觉得没有线的日历更清爽。
5.2 选中日期高亮与信息展示
选中高亮这个功能，本质上就是“刷新界面 + 改变某个标签的样式”。当前面那套动态刷新机制跑通之后，加这个功能只需要十几行代码。
核心思路在代码里已经很清楚了：每次点击日期，先把selectedDate更新为点击的那一天，然后重新调用refreshCalendar，在刷新过程中判断每一个日期是否等于selectedDate，是的话就设置背景色、文字色。因为刷新流程是清空重建，所以以前的高亮一定会被清除，不会出现多个日期同时高亮的情况。
这种“清空重画”的做法效率并不高——每次点击都要重建几十个组件。但这个项目规模小，完全感知不到性能差异。如果你以后要做的界面有两三百个组件，再考虑更优雅的增量更新方案也不迟。提前优化在你还没遇到瓶颈的时候，并不是加分项。
5.3 快捷键与鼠标交互
界面做出来了，还可以加一点交互细节让它更顺手。比如键盘左右方向键切换月份，这个操作在Swing里要用KeyListener绑定到主窗口上，这样无论焦点在哪里，按方向键都能生效。做法不复杂，在主窗口直接addKeyListener(new KeyAdapter(){...})就行，但要注意一个坑：JFrame本身默认没有焦点，你必须在setVisible(true)之后调用requestFocus()，否则按键事件根本不会触发。
鼠标交互也有细节可挖。当前代码里点击任意日期都能选中，但空白格子的点击实际上啥也没发生。如果要做到“点击空白格也把选中状态清空”，就要在空白格子的JLabel上也加一个MouseListener，在回调里把selectedDate置空。这个需求有没有必要？仁者见仁。我自己的习惯是把“点击空白 = 取消选中”做进去，因为用户总是会去点那些空白的区域的，与其让他们点了发现没反应，不如主动给一个反馈。
交互细节还有一个容易踩的坑：鼠标监听器和滚动。如果你以后把日历嵌到JScrollPane里，点击切页会导致滚动条跳动，这时候要把setUnitIncrement调大、setBlockIncrement调合理，或者干脆把日历固定在顶部。日历类应用里我建议不要让它滚动，保持一个固定视口最省心。
6. 常见问题与排错实录
6.1 中文乱码
最常见的问题就是中文显示成乱码。两种情况：一是IDE默认编码不是UTF-8，二是系统没有安装中文字体。IDE层面的问题最好解决，在IDEA里把File Encoding改成UTF-8，同时确保编译选项里的-encoding参数也是UTF-8。命令行跑的话，编译时手动指定：
javac -encoding UTF-8 CalendarFrame.java字体缺失的情况比较少见，Windows一般自带雅黑和宋体，但如果你的运行环境是精简版Windows或某些Linux发行版，界面上的“微软雅黑”会变成一个方框。这种情况的稳妥做法是，代码里不要写死字体，而是用Font.SERIF这类逻辑字体，系统会自动匹配可用字体。不过学习阶段无所谓，Windows用户直接用雅黑即可。
6.2 布局错位、格子数不对
初学者经常碰到的问题：日历第一行没对齐，或者日期和星期对不上。先说原因，大概率是偏移量算错了。getValue()周一返回值是1，那偏移量就是0，意味着第一格就是1号；周日返回值是7，偏移量就是6，意味着第一行有6格是空的，1号出现在最后一格。你只要把这两条规则捋清楚，问题就解决大半。
还有一个小细节，GridLayout的构造参数是“先写行再写列”，比如new GridLayout(6, 7)是6行7列。有些人记反了写成(7, 6)，界面就变成7行6列了，整个布局立刻乱掉。这个参数顺序我记了十年，每次写还是会在脑子里过一遍，建议你也当成固定规律去记。
6.3 日期计算差一天
日期计算差一天，大多数时候是月份索引问题。老代码里用Calendar，12月会算出13月，或者3月会算成4月，因为Calendar的月份从0开始。如果你用的是LocalDate和YearMonth，这个坑基本不存在。但如果你为了省事混合使用了两套API，那绝对会出问题。我的建议是：一个项目里只用一套日期API，不要混用。
还有一种差一天的场景出现在切换月份时。假如今天是7月31日，你点下月想显示8月，但代码里用的是LocalDate.of(2025, 8, 31).plusMonths(1)，那8月31日加一个月会是9月30日，因为你跳过了8月31日不存在的9月31日，它会自动调整到9月30日。这个行为其实符合ISO规范，但对日历这种场景来说，你在切换月份时最好始终用“当月1号”作为基准，比如LocalDate.of(year, month, 1)再加一个月，就不会遇到这种天数错位了。
6.4 监听失效与界面不刷新
监听失效是另一个高频问题。按钮添加了ActionListener，点了没反应。第一个要查的是按钮本身有没有被加到界面里，很无厘头，但确实会犯。第二个要查的是不是设置了setEnabled(false)把按钮禁用了，这种问题往往藏在代码的某个分支里。
界面不刷新这个坑，上文提过两次了。这里再强调一次排查顺序：先确认removeAll()把旧组件删干净了；再确认revalidate()重新计算了布局；最后确认repaint()触发了重绘。三个方法缺一不可。如果你在refreshCalendar之后立刻读取某个标签的值，发现还是旧的，那不是界面问题，是你代码执行顺序的问题——你还没刷新就去读了，当然读的是旧值。
排查这类布局问题有个小技巧：让窗口先setVisible(true)再往外加组件，每加一个就手动pack()一下看效果，它会自动调整窗口大小来适配内容。你肉眼判断哪一步乱了，就能快速定位。
7. 写在最后的个人经验
这个日历项目，我前后带过不少学生做过，自己也重新写过好几版。给我的最大感受是：它几乎能覆盖Java入门阶段所有核心知识点，但又不会让你迷失在庞大的业务逻辑里。你做完它之后，再回头去看那些“Java基础面试题”里的集合、异常、面向对象概念，会有一种豁然开朗的感觉——原来这些东西在真实代码里是这样用的。
我可以再给你一个后续的扩展方向，这几条路对于一个练手项目来说都能显著提升含金量，而且不会太难。第一优先级是加一个日程备忘功能：把某个日期和一段文字关联起来，有备忘的日期在界面上显示一个小圆点。这个需求会逼着你把HashMap<LocalDate, String>用起来，算是实际业务里很典型的“数据结构驱动界面”的案例。第二个可以尝试的是农历显示，这个算法本身有成熟的库（比如lunar-java），你不需要自己造轮子，但把它接进Swing的行业惯例值得学一下。第三个方向是导出功能，把当前月份的日期视图导出成图片，用BufferedImage加Graphics2D画一遍，既能深化AWT绘图的知识，又让这个工具真正“可用”。
我在实际教学里发现，那些真正把日历项目做透的人，后面学Spring MVC、学数据库、学前端都不会太费劲。不是因为他们聪明，而是因为他们已经建立起了“把一个问题拆成界面、数据、交互三块”的思维模式。这种拆解问题的能力，才是做这个项目最大的收获。
最后再给你一个通用的小技巧：写代码遇到报错，先读异常信息的第一行和Caused by之后的内容，那才是出错的根源。控制台里那十几行at com.calendar.demo.CalendarFrame...是调用栈，新手容易盯着它发懵，但实际上它只是在告诉你“错误发生在第几行的哪个方法里”，真正的信息在那两行里。学会了这个排查方法，你以后遇到的报错，能自己解决一大半。
