ExpandoObject 并非真正动态加属性，而是通过 IDictionary 存储键值对；编译器不识别其“属性”，反射和默认序列化均不可见；仅适合临时数据、弱类型API桥接等场景。
ExpandoObject 真的能“动态加属性”吗？
不能——它只是看起来能。本质上 expandoobject 是一个实现了 idictionary<string object></string> 和 inotifypropertychanged 的特殊容器，你“加属性”实际是往字典里塞键值对。编译器不认这些键为真实属性，所以 obj.newprop 能写，但反射查 obj.gettype().getproperties() 会为空；序列化（如 json.net 默认配置）也不会自动包含它们。
- 适合场景：构建临时数据结构、桥接弱类型 API 响应、快速原型组装对象
- 不适合场景：需要强类型校验、依赖属性反射的框架（如 EF Core 映射、WPF 绑定依赖属性）、长期维护的核心模型
- 注意：
ExpandoObject不支持索引器、方法、事件，也不能继承或实现接口
怎么安全地给 ExpandoObject 添加/读取属性？
必须走 IDictionary<string object></string> 接口，别依赖点语法做动态操作。点语法只在编译期已知字段名时“表面可用”，一旦字段名来自变量或运行时拼接，就会报 RuntimeBinderException: 'System.Dynamic.ExpandoObject' does not contain a definition for XXX。
- 正确写法：
var obj = new ExpandoObject() as IDictionary<string, object>; obj["Name"] = "Alice"; obj["Age"] = 30; // 读取 if (obj.TryGetValue("Name", out var name)) { /* 安全 */ } - 错误写法：
obj.Name = "Alice"在泛型上下文或反射调用中可能失效；obj[variableKey]直接报错（ExpandoObject不实现索引器） - 如果非要点语法，只能配合
dynamic：但此时所有类型检查被绕过，IDE 无提示，错误拖到运行时
和 Dictionary 比，ExpandoObject 有啥不可替代？
几乎没——除了两个关键点：dynamic 友好性和部分序列化器的默认支持。JSON.NET 默认把 ExpandoObject 序列化成 JSON 对象，而普通 Dictionary 会变成数组；ASP.NET Core 的 JsonSerializer（.NET 5+）也原生识别它。
- 性能：两者底层都是哈希表，差异可忽略；但
dynamic访问ExpandoObject有 DLR 绑定开销，比直接字典访问慢 3–5 倍 - 兼容性：旧版 .NET Framework 4.0+ 支持；.NET Core / 5+ 全支持；但某些轻量序列化器（如
SpanJson）完全不识别它 - 调试体验：
ExpandoObject在 Visual Studio 调试器中显示为展开的属性列表，Dictionary则显示为键值对集合——仅此而已
为什么 JsonConvert.DeserializeObject 有时返回 null？
常见于 JSON 字符串本身是数组（[...]）或原始值（"hello"、123），而非对象（{...}）。ExpandoObject 只能反序列化 JSON 对象，遇到其他类型会静默失败或抛异常（取决于设置）。
- 检查输入：
if (json.StartsWith("{") && json.EndsWith("}"))是最简前置判断 - 推荐写法：
try { var obj = JsonConvert.DeserializeObject<ExpandoObject>(json); } catch (JsonReaderException ex) { // ex.Path 告诉你哪一行出问题，比 null 更有用 } - 更健壮方案：先反序列化为
JToken，再判断类型：token.Type == JTokenType.Object ? token.ToObject<expandoobject>() : null</expandoobject>
真正麻烦的是嵌套结构里混用 ExpandoObject 和强类型类——序列化器容易混淆，建议全程统一风格，别一半动态一半静态。
