如何标记并记录应弃用的代码模式（非即刻移除的成员/类型）

.NET里并没有原生的DiscouragedAttribute或DoNotUseThisPatternAttribute这类专门标记“不推荐但暂不删除”模式的属性，但可以通过以下几种方式解决你的需求：

1. 自定义属性+Roslyn分析器（最贴合需求） #

自己写一个语义明确的DiscouragedAttribute，再配合Roslyn分析器让IDE给出高亮提示，效果和ObsoleteAttribute类似，但语义更准确——明确是“不推荐新代码使用”，而非“即将删除”。

先定义属性：

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Method | AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
public class DiscouragedAttribute : Attribute
{
    public string Reason { get; }
    public string PreferredAlternative { get; }

    public DiscouragedAttribute(string reason, string preferredAlternative)
    {
        Reason = reason;
        PreferredAlternative = preferredAlternative;
    }
}

然后编写Roslyn分析器，检测到代码中使用了标记该属性的类型/成员时，抛出警告并显示你设置的提示信息。如果团队没有能力写分析器，也可以用下面的替代方案。

2. 复用ObsoleteAttribute但调整文案 #

虽然ObsoleteAttribute本意是标记即将移除的成员，但可以通过修改提示文案明确语义，让团队知道这只是不推荐新代码使用，现有代码无需改动：

[Obsolete("此模式已不推荐在新代码中使用，建议改用FieldInfo<T>封装方案；现有代码可继续保留")]

好处是不用额外开发，IDE自带的高亮、警告提示直接能用，成本极低。

3. 注释+团队规范双约束 #

在旧模式的类型/成员上添加醒目的XML注释，同时在团队内部的编码规范、技术文档里明确淘汰规则：

/// <summary>旧模式的属性示例</summary>
/// <remarks>⚠️ 注意：此模式已过时，新代码请使用FieldInfo<T>封装关联数据</remarks>
public int? SomeIntA { get; set; }

这种方式需要配合代码评审，把“避免使用旧模式”作为固定检查项，确保新代码符合要求。

4. 集中标记旧模式的辅助工具 #

像你之前给扩展方法加ObsoleteAttribute的思路可以延续，但要把所有关联旧模式的辅助方法都统一标记，同时在团队内同步：所有依赖旧模式的工具方法都已标记不推荐，新代码必须使用FieldInfo<T>相关的新工具。

关于整体模式的记录 #

• 在项目根目录下新建DEPRECATED_PATTERNS.md文件，逐条记录要淘汰的模式：包括旧模式的特征、存在的问题、新模式的替代方案，以及明确的规则（比如“新代码必须用新模式，现有代码除非重构否则保留”）。
• 在项目README或技术债务文档里添加对应的章节，让新成员也能快速了解。
• 把模式淘汰规则加入团队的代码评审 checklist，从流程上把控新代码的写法。

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