.NET 5+全球化API的重大变更：从NLS转向ICU库

.NET 5+全球化API的重大变更：从NLS转向ICU库

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

引言

在跨平台开发中，全球化支持是一个关键特性。本文将深入探讨.NET 5及更高版本中一个重要的变更：在Windows 10系统上，全球化API从传统的NLS（国家语言支持）转向了ICU（Unicode国际组件）库。

变更背景

在.NET Core 1.0-3.1和.NET Framework 4+版本中，.NET库在Windows平台上使用NLS API来实现全球化功能。这包括字符串比较、文化信息获取以及特定文化环境下的字符串大小写转换等操作。

从.NET 5开始，当应用程序运行在Windows 10 2019年5月更新（版本1903）或更高版本上时，默认会使用ICU全球化API。这一变更带来了更一致的跨平台行为，并允许应用程序自带全球化库，而不必依赖操作系统的内置库。

技术细节对比

底层库差异

• NLS (National Language Support)：

  • Windows原生API
  • 深度集成于Windows操作系统
  • 更新依赖Windows系统更新

• ICU (International Components for Unicode)：

  • 跨平台Unicode库
  • 独立于操作系统更新
  • 提供更一致的Unicode标准实现

运行时行为

当.NET 5+应用在Windows 10 1903+上运行时：

1. 首先尝试加载ICU库（Windows 10自带）
2. 如果ICU不可用，则回退到NLS
3. 在非Windows平台上，始终使用ICU

实际影响示例

字符串索引查找

考虑以下查找换行符位置的代码：

string s = "Hello\r\nworld!";
int idx = s.IndexOf("\n");

• NLS行为：返回6（将"\r\n"视为一个整体）
• ICU行为：返回-1（严格匹配单个"\n"）

解决方案：明确指定字符串比较方式

int idx = s.IndexOf("\n", StringComparison.Ordinal);

货币符号显示

当设置仅包含语言（不含国家/地区）的文化时：

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

• NLS：显示"100,00 €"（默认关联德国）
• ICU：显示"100,00 ¤"（通用货币符号）

星期缩写

GetShortestDayName方法返回的缩写：

• NLS：双字符（如"Su"）
• ICU：单字符（如"S"）

兼容性考虑

影响范围

此变更会影响以下API的行为：

• 字符串操作（Span、String）
• 全球化相关类型（System.Globalization命名空间）
• 集合排序（当元素为字符串时）
• 排序字典/集合（当键为字符串时）

版本信息

• 引入版本：.NET 5.0
• 影响平台：Windows 10 1903+

迁移建议

1. 代码审查：检查所有文化相关的字符串操作
2. 显式指定比较规则：使用StringComparison参数
3. 测试验证：特别关注排序和格式化逻辑

如需保持旧行为，可通过运行时配置切换回NLS：

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

最佳实践

1. 文化敏感操作：始终明确指定比较规则
2. 单元测试：增加跨文化测试用例
3. 依赖分析：使用代码分析规则CA1307和CA1309检测潜在问题

结论

.NET 5+向ICU的转变为跨平台开发带来了更一致的全球化行为。虽然这可能导致一些细微的行为变化，但通过理解这些差异并遵循最佳实践，开发者可以确保应用程序在全球各地都能正确运行。对于需要保持向后兼容的场景，运行时开关提供了灵活的解决方案。

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