PowerShell 7.5预览版中ConvertTo-Json对枚举类型的序列化行为变更解析

在PowerShell 7.5预览版5中，微软对ConvertTo-Json命令的枚举类型序列化逻辑进行了重要调整。这一变更主要影响Int64和UInt64基础类型的枚举值序列化行为，使其与其他整数类型枚举的序列化逻辑保持一致。

传统上，PowerShell在处理Int64/UInt64基础类型的枚举时，无论是否指定-EnumsAsStrings参数，都会默认将枚举值序列化为字符串形式。而从7.5预览版5开始，这类枚举将与其他类型枚举一样，默认序列化为对应的整数值，只有在显式指定-EnumsAsStrings参数时才会输出字符串形式的枚举名称。

这一变更源于PowerShell团队对JSON序列化一致性的优化。在之前的版本中，不同类型的枚举存在不一致的序列化行为：基于Int32等类型的枚举默认输出数值，而基于Int64/UInt64的枚举却默认输出字符串。这种不一致性可能导致开发者在处理不同基础类型的枚举时遇到意料之外的行为差异。

值得注意的是，这一变更目前是通过实验性功能PSSerializeJSONLongEnumAsNumber实现的。在预览版中所有实验性功能默认启用，但在正式发布版本中，用户需要显式启用该功能才能获得新的行为模式。这意味着从技术上讲，这不属于破坏性变更，因为用户可以选择是否启用新行为。

对于开发者而言，如果需要确保枚举值始终以字符串形式序列化，建议采取以下两种方式之一：

1. 在调用ConvertTo-Json时显式指定-EnumsAsStrings参数
2. 在序列化前对枚举值调用ToString()方法转换为字符串

这种处理方式能够确保代码在不同版本的PowerShell中保持一致的序列化结果，避免因版本升级导致的兼容性问题。

从工程实践角度看，这一变更体现了PowerShell团队对API一致性的重视。统一的序列化行为有助于开发者编写更可靠的脚本，减少因类型差异导致的边界情况。同时，通过实验性功能逐步引入变更的策略，也为开发者提供了充分的过渡期来适应新的行为模式。

对于需要处理枚举序列化的开发者，建议在升级到7.5预览版5或更高版本时，检查现有代码中对ConvertTo-Json的调用，特别是涉及Int64/UInt64枚举的场景，确保序列化结果符合预期。在关键业务逻辑中，显式指定-EnumsAsStrings参数是最稳妥的做法，可以避免潜在的兼容性问题。