PowerShell中OrderedDictionary按引用传参修改值不生效无报错问题

常见失效场景 #

你给出的最小可运行示例逻辑完全正常，业务代码中出现修改不生效且无报错的情况，基本属于以下几种场景：

• 操作的是只读集合包装：如果集合被[System.Collections.Specialized.OrderedDictionary]::ReadOnly()方法封装为只读实例，PowerShell调用索引器修改值时不会抛出异常，只会静默忽略所有修改操作。可以通过$Collection.IsReadOnly属性判断是否为只读集合。
• 键名不匹配：OrderedDictionary默认区分大小写，若修改时的键名和原键名大小写、拼写存在差异，PowerShell会静默新增一个键，而非修改原有键，直观表现就是原键的值没有变化。可遍历$Collection.Keys输出所有键名核对。
• 发生了隐式类型转换：如果传入函数的对象不是严格的System.Collections.Specialized.OrderedDictionary类型，PowerShell会按照参数声明自动做隐式类型转换，转换后的结果是全新的集合实例，修改不会作用到原对象上。比如传入普通Hashtable、PSCustomObject都会触发自动转换。
• 集合被隐式克隆：如果集合经过了序列化/反序列化（比如ConvertTo-Json+ConvertFrom-Json来回转换）、管道传输、深度复制操作，得到的已经是新的实例，修改自然不会同步到原集合。

引用传递失效的核心原因 #

.NET中引用类型默认按引用传递的逻辑不会随便失效，你以为的失效基本都是以下两种情况：

• 操作的已经是新生成的实例：也就是上面提到的类型转换、克隆、序列化等场景产生的新对象，和原对象没有关联。
• 操作的是不可变集合：如果使用System.Collections.Immutable命名空间下的不可变集合，所有修改操作都会返回新实例，原实例永远不会变更，属于设计特性而非bug。
  内嵌简单数据类型不会导致引用失效，只要你是直接通过$Collection.$key = xxx的方式修改，都是直接修改原集合存储的值，不会出现改副本的问题。

实例一致性验证方法 #

不需要获取内存地址，直接用.NET内置的静态方法即可判断两个变量是否指向同一个实例：

# 初始化时保存原始实例引用
$originalCollection = $parentContainer.data
# 传入函数后判断是否为同一个实例
$isSameInstance = [System.Object]::ReferenceEquals($originalCollection, $Collection)

如果$isSameInstance返回$false，说明你拿到的已经是新实例，修改自然不会同步到原对象。

类迁移风险说明 #

你当前遇到的问题和是否使用类无关，都是集合操作、参数绑定的通用问题，迁移到类之后反而因为属性类型更明确，可以减少隐式类型转换的概率，不会出现同类问题。

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