[Obsolete] 是编译指令而非注释，加 true 参数会使调用直接编译失败；必须传非空字符串消息才能显示有效提示，且消息须为编译期常量；它对反射调用无效。
[Obsolete] 不是注释，它会直接影响编译行为——加不加第二个参数 true，决定是警告还是编译失败。
为什么 [Obsolete] 加了消息却没显示？
常见错误是只写了 [Obsolete] 而没传字符串参数。编译器确实会报警告，但内容只有“类型/成员已过时”，没有上下文。真正有用的提示必须显式传入描述性文本。
- ✅ 正确写法：
[Obsolete("请改用 UserService.GetActiveUsers()")] - ❌ 无效写法：
[Obsolete]（无参数）或[Obsolete(null)] - ⚠️ 注意：消息字符串不能在运行时动态拼接，必须是编译期常量，否则编译报错
[Obsolete] 的 true 参数到底管什么？
第二个 bool 参数控制是否升级为编译错误。设为 true 后，任何调用该成员的代码都会导致 CS0612 或 CS0618 错误，编译直接中断。
- 类上用
[Obsolete("", true)]：所有对该类的引用（声明、new、继承）都报错 - 方法上用
[Obsolete("Use NewMethod", true)]：只要调用该方法就报错，哪怕只在测试代码里写了一行 - ⚠️ 风险点：如果误标在被大量间接调用的基类方法上，可能引发大面积编译失败，建议先用
false观察一段时间
怎么让弃用提示更准？避开常见误用场景
弃用标记不是“贴完就完事”的装饰，它得和实际使用路径对齐。比如你标记了一个 public 方法，但它的逻辑实际由内部 private 方法驱动，那仅标记 public 层是不够的。
- 若弃用的是整个类，请同时检查其构造函数、静态工厂方法、序列化入口（如
[JsonConstructor]），这些地方都可能绕过类级别的[Obsolete] - 若弃用的是属性的
set，但保留get，应单独标记[Obsolete]在set访问器上，而不是整个属性 - ASP.NET Core 中控制器 Action 被弃用时，需确认路由是否仍注册——
[Obsolete]不影响路由匹配，只影响编译期调用检查
最易被忽略的一点：[Obsolete] 对反射调用完全无效。如果你的代码通过 GetType().GetMethod("OldMethod").Invoke() 执行，编译器根本看不到，也就不会报任何警告或错误。
