.NET 7全球化API变更：Windows Server 2019默认使用ICU库

.NET 7全球化API变更：Windows Server 2019默认使用ICU库

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

引言

在全球化应用开发中，正确处理不同语言和区域设置的数据至关重要。.NET框架提供了强大的全球化支持，而这一支持在.NET 7中迎来了重要变化。本文将深入探讨.NET 7在Windows Server 2019及早期Windows 10版本上默认使用ICU库这一变更，帮助开发者理解其影响并做好应对准备。

背景知识

什么是全球化API？

全球化API是.NET框架中处理多语言和区域相关功能的一组接口，包括但不限于：

• 字符串比较和排序
• 日期时间格式化
• 数字和货币格式化
• 字符大小写转换

NLS与ICU的区别

在Windows平台上，.NET传统上使用两种全球化实现方式：

1. NLS (National Language Support)：Windows原生提供的语言支持功能
2. ICU (International Components for Unicode)：跨平台的Unicode支持库

ICU相比NLS具有以下优势：

• 更符合Unicode标准
• 跨平台行为一致性
• 更丰富的国际化功能支持

变更内容

历史行为

在.NET 5和6中：

• 非服务器版Windows：默认使用ICU
• Windows Server 2019及早期Windows 10版本：仍使用NLS

.NET 7新行为

从.NET 7开始：

• 所有Windows版本（包括Server 2019及Windows 10 1703-1809）默认使用ICU
• 这一变更确保了跨Windows版本的行为一致性

实际影响示例

货币符号格式化差异

考虑以下代码示例：

System.Threading.Thread.CurrentThread.CurrentCulture = new System.Globalization.CultureInfo("de");
string text = string.Format("{0:C}", 100);

不同环境下输出结果对比：

| .NET版本 | 环境 | 输出结果 | |---------|------|---------| | .NET 5/6 | Windows Server 2019 | "100,00 €" | | .NET 7 | Windows Server 2019 | "100,00 ¤" |

变化原因：ICU认为货币是国家/地区属性而非语言属性，当只指定语言(de)而未指定国家/地区时，使用国际货币符号(¤)而非具体货币符号(€)。

变更原因深度解析

1. API一致性需求：.NET引入了一些依赖ICU的API（如时区转换），需要统一的基础支持
2. 部署简化：避免每个服务单独部署ICU库
3. 云环境适配：在自动配置的云服务器上，服务可能无法预知运行环境
4. 标准符合性：ICU更严格遵循Unicode标准

受影响API范围

此次变更影响广泛的全球化相关API，主要包括：

• 字符串处理：String、Span<char>
• 集合排序：Array.Sort、List<T>.Sort
• 排序集合：SortedDictionary、SortedList、SortedSet
• 全球化命名空间：System.Globalization下大多数类型

应对策略

测试建议

1. 在目标环境上全面测试应用的全球化功能
2. 特别注意：
   • 字符串比较和排序
   • 格式化输出
   • 文化特性相关功能

回退选项

如需保持原有NLS行为，可通过以下方式配置：

1. 项目文件配置：

<ItemGroup>
  <RuntimeHostConfigurationOption Include="System.Globalization.UseNls" Value="true" />
</ItemGroup>

2. 环境变量：

DOTNET_SYSTEM_GLOBALIZATION_USENLS=true

3. 运行时配置文件：

{
  "runtimeOptions": {
    "configProperties": {
      "System.Globalization.UseNls": true
    }
  }
}

最佳实践

1. 明确指定文化：避免仅使用语言代码，应包含国家/地区信息

   // 推荐
   new CultureInfo("de-DE");
   // 不推荐
   new CultureInfo("de");
   

2. 测试文化敏感操作：特别是涉及排序、格式化和比较的场景

3. 考虑跨平台需求：即使仅在Windows上运行，也应考虑ICU带来的行为变化

结论

.NET 7在Windows Server 2019及早期Windows 10版本上默认使用ICU库的变更，是.NET全球化支持演进的重要一步。这一变化带来了更符合标准的行为和更好的跨平台一致性，但也需要开发者注意可能的行为差异。通过充分测试和适当配置，开发者可以确保应用平滑过渡到新的全球化实现方式。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs