在Linux Docker的.NET 6中添加en-JP自定义区域性的问题

为什么原.NET Framework代码无法生效 #

.NET Framework的CultureAndRegionInfoBuilder.Register()是Windows平台特有的API，依赖Windows系统的区域设置注册表和文件系统。而.NET 6+在Linux环境下采用ICU（International Components for Unicode）库提供全球化支持，不兼容该API，因此直接迁移代码会失效。

可行解决方案 #

1. 利用.NET自定义区域性文件（.nlp）

.NET支持加载自定义的.nlp区域性文件，步骤如下：

• 生成.nlp文件：在Windows机器上运行原.NET Framework代码，注册en-JP区域性后，在C:\Windows\Globalization\Locales目录下找到en-JP.nlp文件。
• 在Docker中部署文件：将en-JP.nlp复制到容器内的指定目录，通过环境变量让.NET加载该自定义区域性：

  FROM mcr.microsoft.com/dotnet/aspnet:6.0
  # 创建存放自定义区域性文件的目录
  RUN mkdir -p /app/custom-cultures
  # 复制本地生成的en-JP.nlp到容器
  COPY ./en-JP.nlp /app/custom-cultures/
  # 设置环境变量，指定自定义区域性文件路径
  ENV DOTNET_SYSTEM_GLOBALIZATION_CUSTOM_CULTURES=/app/custom-cultures
  

• 验证：在代码中通过CultureInfo.GetCultureInfo("en-JP")即可获取自定义区域性。

2. 手动模拟自定义区域性行为

如果不想依赖.nlp文件，可以通过继承CultureInfo手动实现所需的区域性规则，示例代码：

public class EnJpCultureInfo : CultureInfo
{
    public EnJpCultureInfo() : base("en-US")
    {
        // 配置日本区域的日期格式
        DateTimeFormat.ShortDatePattern = "yyyy/MM/dd";
        DateTimeFormat.LongDatePattern = "yyyy'年'M'月'd'日'";
        DateTimeFormat.FirstDayOfWeek = DayOfWeek.Monday;

        // 配置日本货币/数字格式
        NumberFormat.CurrencySymbol = "¥";
        NumberFormat.CurrencyDecimalDigits = 0;
        NumberFormat.NumberGroupSeparator = ",";

        // 设置区域性名称
        DisplayName = "English (Japan)";
        NativeName = "English (Japan)";
    }
}

在业务代码中直接实例化EnJpCultureInfo使用，无需依赖系统注册的区域性。

3. 使用预配置ICU的自定义镜像

如果需要频繁使用自定义区域性，可以构建包含ICU自定义配置的镜像：

• 基于官方.NET 6镜像，替换或扩展ICU的区域数据文件（需熟悉ICU数据编译），但这种方式复杂度较高，仅适合有特殊需求的场景。

内容的提问来源于stack exchange，提问作者Carrie Kaski