本文旨在解决javafx应用程序在使用`jpackage`打包成独立可执行文件后，日期和时间格式化（特别是星期几的名称）无法正确显示指定语言的问题。核心原因在于`jpackage`默认不会包含所有语言环境数据模块。我们将详细介绍如何通过在`jpackage`命令中添加`jdk.localedata`模块来确保应用程序在运行时能够正确加载并显示多语言日期信息。
JavaFX应用打包后日期语言显示异常的根源
在JavaFX应用程序开发中，我们经常需要处理日期和时间的国际化显示。Java提供了java.util.Locale和java.time.format.DateTimeFormatter等类来支持这一功能。开发者通常会在代码中显式指定所需的语言环境（Locale），以确保日期、时间、货币等信息以用户期望的格式呈现。
例如，以下代码片段展示了如何在JavaFX的TableCell中将LocalDate对象格式化为西班牙语的日期和星期几：
public void Formato_fecha_y_hora(){
Locale locale = new Locale("es", "ES"); // 显式设置西班牙语区域
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy E").withLocale(locale);
Col_FEentrega.setCellFactory(tc -> new TableCell<>() {
@Override
protected void updateItem(LocalDate date, boolean empty) {
super.updateItem(date, empty);
if (empty) {
setText(null);
} else {
setText(formatter.format(date)); // 使用指定区域格式化日期
}
}
});
// 同样，小时的格式化
DateTimeFormatter formato_hora = DateTimeFormatter.ofPattern("h:mm a");
Col_Hora_entrega.setCellFactory(tc -> new TableCell<>() {
@Override
protected void updateItem(LocalTime Time, boolean empty) {
super.updateItem(Time, empty);
if (empty) {
setText(null);
} else {
setText(formato_hora.format(Time));
}
}
});
}在IDE中直接运行此代码时，它通常会按预期工作，即星期几的名称会显示为西班牙语。然而，当使用jpackage工具将应用程序打包成独立的.exe可执行文件后，运行时可能会发现星期几的名称变回了英文，而非代码中指定的西班牙语。
出现这种现象的核心原因在于jpackage（及其底层使用的jlink）在创建运行时镜像时，为了减小最终包的大小，默认情况下不会包含所有语言环境的数据。Java的国际化数据，特别是像日期、时间、货币、数字等格式的本地化信息，都存储在特定的模块中。当这些模块未被显式包含时，即使代码中设置了Locale，运行时也无法找到对应语言的本地化数据，从而回退到默认的英文显示。
立即学习“Java免费学习笔记（深入）”；
解决方案：添加 jdk.localedata 模块
解决此问题的关键是确保在jpackage打包过程中，将包含所有语言环境数据的jdk.localedata模块也一并包含进运行时镜像中。
jdk.localedata模块是JDK中专门用于提供各种语言和区域设置相关数据的模块。通过将其添加到jpackage的--add-modules参数中，可以确保应用程序在运行时能够访问到所需的国际化数据。
以下是修改后的jpackage命令示例：
jpackage --type exe \
--input . \
--dest . \
--main-jar .\Dulceria.jar \
--main-class com.example.dulceria.HelloApplication \
--module-path "D:\Program Files\Java\javafx-jmods-18" \
--add-modules javafx.controls,javafx.fxml,java.sql,java.sql.rowset,jdk.localedata \
--win-shortcut \
--win-menu请注意，在--add-modules参数中，我们新增了,jdk.localedata。这将指示jpackage将此模块及其包含的所有语言环境数据打包到最终的可执行文件中。
注意事项与最佳实践
包大小影响： 包含jdk.localedata模块会显著增加最终可执行文件的大小，因为它包含了全球大部分语言的本地化数据。如果应用程序只需要支持少数几种特定语言，可以考虑使用jlink的--include-locales选项来只包含所需的特定语言环境，但这会使jpackage命令稍微复杂一些。对于大多数情况，直接添加jdk.localedata是最简单有效的解决方案。
测试多语言环境： 在部署应用程序之前，务必在不同的操作系统语言环境下进行测试，以确保所有本地化内容（包括日期、时间、数字、货币等）都能正确显示。
资源束（Resource Bundles）： 对于除了日期时间格式以外的文本内容（如UI标签、消息提示等），推荐使用Java的资源束（Resource Bundles）机制进行国际化。这与Locale和DateTimeFormatter结合使用，可以构建一个全面的多语言应用程序。
JavaFX版本兼容性： 确保--module-path指向的JavaFX JMODS版本与您的项目使用的JavaFX库版本以及JDK版本兼容。
总结
当JavaFX应用程序通过jpackage打包后出现日期语言显示异常时，通常是由于运行时环境中缺少jdk.localedata模块所致。通过在jpackage命令的--add-modules参数中明确添加jdk.localedata，可以有效地解决这一问题，确保应用程序能够正确地根据代码中指定的Locale显示本地化的日期和时间信息。虽然这会略微增加最终包的大小，但它提供了一个简单而可靠的解决方案，确保了应用程序的国际化能力。
