PowerShell哈希表Add-Member与直接键赋值的差异及显示异常问题

问题原理说明 #

你的猜想完全正确：Add-Member 是给哈希表这个.NET对象本身添加扩展属性，而非添加哈希表的键值对，两者属于完全独立的存储维度，具体原理如下：

1. 两种赋值操作的本质差异 #

• 常规写法$HashTable.Something = 'Something'是PowerShell为哈希表设计的语法糖，本质是往哈希表内置的Key-Value集合中插入数据，属于哈希表的业务存储范畴。
• Add-Member 是PowerShell提供的通用对象扩展方法，给任意.NET对象附加的NoteProperty属性会存储在对象的PSObject扩展属性集合中，和哈希表自身的键值对存储空间完全隔离，互不干扰。

2. 直接输出不显示扩展属性的原因 #

PowerShell对Hashtable类型有默认的格式化输出规则：仅遍历输出哈希表自身键值对集合内的内容，不会主动读取并展示PSObject扩展的额外属性，因此直接打印哈希表时看不到Add-Member添加的字段。

3. 转JSON时字段正常出现的原因 #

ConvertTo-Json的序列化逻辑会遍历目标对象的所有公开属性，既包含对象原生属性、也包含PSObject扩展的NoteProperty，因此会将哈希表自带的键值对和Add-Member附加的属性一并序列化到JSON结果中。

补充注意事项 #

如果要给哈希表添加标准键值对，请勿使用Add-Member，推荐使用以下常规写法：

# 写法1：索引赋值
$HashTable['键名'] = '值'
# 写法2：属性赋值（语法糖）
$HashTable.键名 = '值'
# 写法3：调用Add方法
$HashTable.Add('键名', '值')

如果需要查看对象所有附加的扩展属性，可执行：

$HashTable | Get-Member -MemberType NoteProperty

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