PowerShell自定义对象属性顺序与fieldMap不符的原因及解决方法

问题原因 #

PowerShell默认的Hashtable（哈希表）是无序集合，在PowerShell 5.1及更早版本中，遍历Hashtable.Keys的顺序不保证与哈希表的定义顺序一致。你代码中使用的$fieldsMap是普通哈希表，所以循环处理属性时顺序会被打乱，导致最终对象的属性顺序和你定义的映射顺序不符。

解决方法 #

要保持属性顺序，需要使用有序哈希表，有两种实现方式：

1. 定义映射字典时使用有序哈希表 #

创建$fieldsMap时加上[Ordered]修饰符，确保键的顺序被保留：

$fieldsMap = [Ordered]@{
    "Id" = "InstrumentId"
    "Service" = "ServiceLayer"
    "Propertyx" = "MaturityDate"
    "Price" = "Gheimat"
}

2. 在函数内部转换为有序字典 #

如果无法修改映射字典的创建方式，可以在函数内部把传入的Hashtable转为OrderedDictionary，保证遍历顺序：

# 在函数开头添加
$orderedFieldMap = [System.Collections.Specialized.OrderedDictionary]::new()
foreach ($key in $fieldMap.Keys) {
    $orderedFieldMap[$key] = $fieldMap[$key]
}
# 后续循环使用$orderedFieldMap.Keys

函数效率优化建议 #

你的函数可以从以下几点优化：

• 用ArrayList替代数组+=操作：数组+=会每次创建新数组，大数据量下效率极低，ArrayList的Add操作是O(1)时间复杂度。
• 直接通过属性名查找，避免遍历所有属性：利用PSObject.Properties的索引器结合忽略大小写的字符串比较，比Where-Object遍历更快。

优化后的完整函数代码：

function Convert-APIObjectToCustomObject {
    param (
        [Array]$dataFromAPI,
        [Hashtable]$fieldMap
    )

    # 转换为有序字典，确保属性顺序
    $orderedFieldMap = [System.Collections.Specialized.OrderedDictionary]::new()
    foreach ($key in $fieldMap.Keys) {
        $orderedFieldMap[$key] = $fieldMap[$key]
    }

    # 使用ArrayList提升添加效率
    $resultData = [System.Collections.ArrayList]::new()    

    foreach ($item in $dataFromAPI) {
        $newObject = [PSCustomObject]$orderedFieldMap # 直接基于有序字典创建对象，自动保留顺序
        foreach ($key in $orderedFieldMap.Keys) {
            $sourcePropName = $orderedFieldMap[$key]
            # 忽略大小写查找属性
            $matchedProperty = $item.PSObject.Properties[$sourcePropName, [StringComparer]::OrdinalIgnoreCase]
            if ($matchedProperty) {
                $newObject.$key = $matchedProperty.Value
            } else {
                Write-Warning "Property '$sourcePropName' not found on the input object. Setting default value."
                $newObject.$key = $null
            }
        }
        [void]$resultData.Add($newObject)
    }
    return $resultData
}

# 示例用法（映射字典可以用普通哈希表，函数内部会转有序）
$dataFromAPI = @(
    [PSCustomObject]@{ InstrumentId='1'; ServiceLayer='Service1'; MaturityDate=1; Gheimat='5' ; ExtraCol = '45' },
    [PSCustomObject]@{ InstrumentId='2'; ServiceLayer='Service2'; MaturityDate=2; Gheimat='17'; ExtraCol = '1000'},
    [PSCustomObject]@{ InstrumentId='3'; ServiceLayer='Service1'; MaturityDate=1; Gheimat='3' ; ExtraCol = 'Hi'},
    [PSCustomObject]@{ InstrumentId='4'; ServiceLayer='Service1'; MaturityDate=1; Gheimat='7' ; ExtraCol = 'Hello' }
)

$fieldsMap = @{
    "Id" = "InstrumentId"
    "Service" = "ServiceLayer"
    "Propertyx" = "MaturityDate"
    "Price" = "Gheimat"
}

$resultData2 = Convert-APIObjectToCustomObject -dataFromAPI $dataFromAPI -fieldMap $fieldsMap

注：直接用[PSCustomObject]$orderedFieldMap创建对象，会自动保留有序字典的键顺序，比逐个添加NoteProperty更简洁高效。

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