debuggerdisplay特性必须加在类、结构体或委托定义上方，不能写在方法或字段上；泛型类型需放在泛型声明处；字符串仅支持可访问的字段、属性及无参方法，不支持空条件运算符或格式化字符串，且修改后需重启调试会话才生效。
DebuggerDisplay 特性不是用来“美化”调试器的，而是解决“对象在监视窗口里根本看不出关键信息”这个实际问题。
为什么加了 [DebuggerDisplay] 却没生效？
最常见原因是：特性写在了错误的位置，或类型没被正确识别。
- 必须直接写在类、结构体或委托定义上方，不能写在方法里或字段上
- 如果目标类型是泛型（比如
MyList<t></t>），[DebuggerDisplay]要放在泛型声明处，且字符串中可用{T}或{Count}这类可访问成员，但不能用未声明的变量名 - 调试时若看到的是
MyNamespace.MyType而非自定义文本，说明编译器没加载该特性——检查是否启用了“仅我的代码”（Tools → Options → Debugging → General → ✔ Enable Just My Code），关掉它再试 - ASP.NET Core 项目中，若类型在类库中且未启用源链接或符号未加载，也可能不显示；确保 .pdb 文件随程序集一起部署
[DebuggerDisplay] 字符串里能写什么？
本质是 C# 插值字符串，但限制比普通插值多：只支持字段、属性、无参方法（且不能有副作用）、以及嵌套一层的简单表达式。
- ✅ 合法：
"Name = {Name}, Count = {Items.Count}"、"{GetSummary()}"（GetSummary是 public 无参方法） - ❌ 非法：
"{items?.Count ?? 0}"（带空条件运算符）、"{ToString()}"（递归调用易崩溃）、"{DateTime.Now:HH:mm}"（不支持格式化字符串语法） - ⚠️ 注意：
{Count}和{this.Count}效果一样，但显式写this.可避免歧义；若属性名含下划线（如_id），直接写{_id}即可，无需特殊处理
调试集合时，[DebuggerDisplay] 和 [DebuggerTypeProxy] 怎么选？
二者定位完全不同：[DebuggerDisplay] 控制单行摘要，[DebuggerTypeProxy] 才真正接管整个展开视图。
- 只加
[DebuggerDisplay]：对象在监视窗口/局部变量窗口里显示为一行文本，点开后仍是默认字段列表 - 想自定义展开后的子项（比如隐藏冗余字段、聚合计算值、按逻辑分组），必须用
[DebuggerTypeProxy]配合一个代理类 - 典型组合：给
Order类加[DebuggerDisplay("ID={OrderId}, Items={Items.Count}")]，再配[DebuggerTypeProxy(typeof(OrderDebugView))]，让点开后只显示Customer、ValidatedItems等有意义的子节点 - 性能提示：代理类的属性 getter 在调试时会被频繁调用，避免在里面做 IO、锁、或复杂计算
真正容易被忽略的是：调试器不会重新编译你改过的 [DebuggerDisplay] 字符串——改完必须重启调试会话，否则旧文本仍会缓存显示。另外，Unity 项目中该特性默认被剥离（IL stripping），需在 Player Settings 中关闭 “Strip Engine Code”。
