ImmutableList 初始化必须一步到位，常用ImmutableList.Create()创建空或带初始值的实例；Add等操作返回新实例而非修改原集合；频繁修改应使用ToBuilder()提升性能。
ImmutableList 和 ImmutableList.Create() 怎么初始化
不可变集合一旦创建就不能修改，所以初始化必须一步到位。最常用的是 ImmutableList.Create() 静态工厂方法，它返回一个空的、线程安全的不可变列表；传入元素则直接构建带初始值的实例。
注意：不能用 new ImmutableList —— 它是抽象类，没有公开构造函数。
-
var list = ImmutableList：获取空实例，比反复调用.Empty Create()更轻量 -
var list = ImmutableList.Create(1, 2, 3)：内部会优化为紧凑结构，适合小数据量 -
大数据量建议用
ImmutableList.ToImmutableList()从现有IEnumerable转换，避免多次Add()造成中间对象堆积
为什么 Add() 不改变原集合，而返回新实例
这是不可变性的核心机制：Add()、Remove()、SetItem() 等所有“修改”方法都返回新集合，原实例完全不变。这保证了多线程读取安全，也支持函数式链式操作。
常见错误是忽略返回值：list.Add(4); 这行代码执行后 list 仍是旧的，新增元素被丢弃。
- 正确写法：
list = list.Add(4)或var newList = list.Add(4) - 链式调用可行：
list.Add(4).Remove(1).SetItem(0, 99)，每步都生成新快照 - 性能提示：频繁单步更新（如循环中反复
Add）会产生大量中间对象，应改用Builder模式
ImmutableList.ToBuilder() 的使用时机和代价
当需要多次增删改时，直接链式调用 Add() 效率低，因为每次都会复制底层结构。此时应先转成 ImmutableList，操作完再调用 ToImmutable() 一次性生成最终不可变实例。
新普网店系统XpShop完美结合Discuz 2.0版本论坛。论坛可以到Discuz官方网站或者到XpShop官方网站下载，集成方法请到XpShop官方网站论坛查询软件特点介绍：1、使用ASP.Net(c#)、三层结构开发2、自由选择模板，界面美观，皮肤设计灵活多变3、在线支付：支付宝，网银在线，快钱，paypal,YeePay易宝支付,IPS环讯支付,腾讯财付通4、销售统计，图表分析5、集成多种
Builder 是可变的、非线程安全的临时容器，内部用数组实现，接近 List 的性能。
- 适用场景：批量构建、算法中需多次调整集合内容（如递归处理树节点）
- 注意点：
builder不是线程安全的，不能跨线程共享 - 别忘了最后调用
builder.ToImmutable()，否则拿不到不可变结果 - 示例：
var builder = ImmutableList.CreateBuilder
();
for (int i = 0; i < 1000; i++) builder.Add(i * 2);
var result = builder.ToImmutable();
引用相等 vs 值相等：Equals() 和 == 判断逻辑
不可变集合重写了 Equals() 和 GetHashCode()，默认按元素值逐个比较（即值相等），不是引用相等。但 == 运算符未重载，仍走引用比较 —— 这点极易踩坑。
- 判断内容是否相同，必须用
.Equals(other)或ImmutableList.IsValueEqual(a, b) -
a == b只有在两个变量指向同一实例时才为true，即使内容完全一样也返回false - 序列化/缓存场景下，若依赖哈希表（如
Dictionary），值相等性已由, string> GetHashCode()保障，无需额外处理
真正难察觉的是调试时看“值相同就以为 == 成立”，结果逻辑分支没进对 —— 记住：只要用了不可变集合，一律用 .Equals() 做内容判等。
