PowerShell枚举同义词：如何控制其字符串表示？

问题重现 #

你定义了如下PowerShell枚举：

enum units {
    
    byte        = 1
    B           = 1
    
    Kilobyte    = 1KB
    KB          = 1KB
    
    megabyte    = 1MB
    MB          = 1MB
    
    gigabyte    = 1GB
    GB          = 1GB
}

调用[units].GetEnumNames()能返回所有定义的成员名称，但[units].GetEnumValues()的输出却使用了每个值的最后一个定义名称（仅gigabyte/GB例外）；调用ToString()时的表现也不一致，比如[units]::gb.ToString('g')返回gigabyte，而[units]::kb.ToString('g')返回KB。

原因 #

.NET枚举中，相同值的多个成员（同义词）的字符串表示行为由CLR内部逻辑决定：

• 当直接通过成员名称（如[units]::KB）获取枚举值时，ToString()默认返回该成员的名称；
• 当通过值转换得到枚举实例时，ToString()会返回第一个定义的匹配成员名称；
• PowerShell的GetEnumValues()输出显示的是枚举值对应的“首选”名称，这个逻辑和CLR的内部映射有关，无法直接通过枚举本身的方法控制。

解决方案 #

要自定义枚举同义词的字符串表示，可以通过构建值与名称的映射表，手动指定要使用的名称。

步骤1：构建枚举值与名称的映射 #

先创建一个哈希表，存储每个枚举值对应的所有成员名称：

$enumType = [units]
$valueToNamesMap = @{}
foreach ($name in $enumType::GetEnumNames()) {
    $value = $enumType::$name
    if (-not $valueToNamesMap.ContainsKey($value)) {
        $valueToNamesMap[$value] = @()
    }
    $valueToNamesMap[$value] += $name
}

这个映射表中，每个键是枚举的数值，值是该数值对应的所有成员名称数组（按定义顺序排列）。

步骤2：自定义获取指定名称的函数 #

写一个辅助函数，根据枚举值和偏好名称返回对应的字符串：

function Get-EnumPreferredName {
    param(
        [Parameter(Mandatory)]
        [Enum]$EnumValue,
        [Parameter(Mandatory)]
        [string]$PreferredName
    )
    
    $enumType = $EnumValue.GetType()
    # 获取当前值对应的所有成员名称
    $allNames = $enumType::GetEnumNames() | Where-Object { $enumType::$_ -eq $EnumValue }
    
    # 如果偏好名称存在，返回它；否则返回第一个定义的名称
    if ($allNames -contains $PreferredName) {
        return $PreferredName
    }
    return $allNames[0]
}

使用示例 #

# 获取[units]::GB的偏好名称"GB"
Get-EnumPreferredName -EnumValue [units]::GB -PreferredName "GB"
# 输出: GB

# 获取[units]::KB的偏好名称"Kilobyte"
Get-EnumPreferredName -EnumValue [units]::KB -PreferredName "Kilobyte"
# 输出: Kilobyte

# 从映射表中直接取第一个/最后一个名称
$valueToNamesMap[[units]::1KB][0]  # 输出 Kilobyte
$valueToNamesMap[[units]::1KB][1]  # 输出 KB

补充说明 #

如果需要在所有场景下统一枚举的字符串表示，也可以考虑：

• 避免使用枚举同义词，改用单个成员名称 + 别名映射的方式；
• 自定义一个类来封装单位逻辑，替代枚举，更灵活地控制字符串输出。

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