javafx中datepicker不支持自定义月视图，需用gridpane手绘日历网格；通过yearmonth计算首日偏移与天数；事件用observablelist+vbox渲染并绑定；切换月份前清理旧节点、严格设置行列约束；jdk 11+须显式配置javafx模块。
JavaFX中用DatePicker做日历选择但无法自定义月视图？
DatePicker默认只提供下拉式日历面板，不支持嵌入式月视图或拖拽选范围——它本质是个“单日输入控件”，不是日历组件。真要做个人日历（带事件标记、多日选择、滚动翻月），得绕过它，直接用GridPane + Label/Button手绘月网格，再配合LocalDate计算当月第一天星期几、天数等。
常见错误是强行把DatePicker的弹出面板扒出来重用，结果发现DatePickerSkin是内部类、无公开API，且JavaFX 17+已移除对com.sun.*包的支持。
- 用
YearMonth.of(year, month)获取指定年月 - 用
yearMonth.lengthOfMonth()和yearMonth.atDay(1).getDayOfWeek().getValue()算出首日偏移（周一=1，周日=7） - 每个日期格子用
Button而非Label，方便后续绑定点击事件和样式状态（如当天/已添加事件/周末）
如何让日历支持添加和显示事件（比如会议、待办）？
别用ObservableList<string></string>硬塞文字到按钮上——会撑破格子、无法交互、样式难统一。正确做法是为每个日期维护一个ObservableList<event></event>，其中Event至少含title、time、color字段；渲染时用VBox包裹多个小Label，并限制最大显示3条，超出用“+2”提示。
关键点在于数据绑定：用Bindings.bindContentBidirectional同步内存事件列表与UI节点，避免手动getChildren().clear()再重建——否则滚动切换月份时会闪屏或丢失状态。
立即学习“Java免费学习笔记（深入）”；
- 事件存储建议用
Map<localdate observablelist>></localdate>，而不是数据库或文件，先保证GUI响应速度 - 给事件
Button加setOnAction前，先用button.setId("event-" + date.toString())标记来源日期，避免闭包引用错乱 - 颜色区分用
-fx-background-color内联样式，别用setStyle()反复调用（性能差）
切换月份时如何避免NullPointerException或空白面板？
典型错误是直接在changeMonth(int delta)里更新GridPane子节点，却没清空旧节点，或忘了重新设置GridPane.setConstraints()——导致新日期挤在左上角、旧节点残留、甚至GridPane.getRowIndex(node)返回null引发NPE。
安全做法是：每次重绘前，先调用gridPane.getChildren().removeIf(node -> node.getId() != null && node.getId().startsWith("date-"))，只删自己画的日期格子；然后用GridPane.setColumnIndex()和GridPane.setRowIndex()严格按行列坐标插入，不要依赖自动布局。
- 月份切换逻辑必须校验边界：
if (currentMonth.isBefore(YearMonth.of(1970, 1))) return;，防止用户狂点回到远古时间 - 用
Platform.runLater()包裹UI更新，尤其从后台线程加载事件数据后 - 首次加载别用
new LocalDate()（已废弃），改用LocalDate.now()
打包后运行报NoClassDefFoundError: javafx/scene/control/Button？
这是Java 11+移除了JavaFX内置支持的直接后果。JDK 11起，JavaFX不再是JRE一部分，必须显式声明模块依赖。
如果你用Maven，除了javafx-controls，还得加javafx-fxml（哪怕不用FXML）、javafx-base和javafx-graphics，版本必须和你的JDK匹配（如JDK 17对应JavaFX 17.0.2）。更麻烦的是，运行时要加--module-path和--add-modules参数，IDE里容易漏配。
- IntelliJ：Run → Edit Configurations → VM Options填
--module-path /path/to/javafx-sdk/lib --add-modules javafx.controls,javafx.fxml - Gradle构建jar时，用
jlink或jpackage打包，别用普通jar命令 - 如果用GraalVM native-image，JavaFX目前不支持，直接放弃
日历应用看着简单，但日期计算、事件状态管理、模块化部署这三块最容易卡住人——尤其是跨JDK版本迁移时，LocalDate行为一致，DatePicker API却可能突然消失。
