如何强制后续开发者使用自定义派生类MyCustomCommand而非VendorCommand

以下几种方案可以在编译阶段或IDE中提示开发者改用自定义类，无需修改供应商的VendorCommand：

1. 自定义Roslyn分析器（最推荐） #

直接编写Roslyn分析器，检测代码中对VendorCommand的直接使用（实例化、继承等），触发编译警告或错误：

• 检测逻辑：找到所有创建VendorCommand实例的语法节点，或者继承该类的类声明。
• 诊断提示：明确告知开发者“请使用MyCustomCommand替代VendorCommand”，并可设置为错误级别强制拦截。
• 优势：编译阶段就能阻止违规代码，且IDE会实时给出提示，从根源上避免误用。

2. 包装类+Obsolete特性 #

在项目中创建一个同名的包装类，标记为过时并设为错误：

using OriginalVendor = VendorNamespace.VendorCommand;

[Obsolete("必须使用MyCustomCommand替代，禁止直接使用VendorCommand", error: true)]
public class VendorCommand : OriginalVendor { }

之后开发者如果直接引用VendorCommand，编译器会抛出错误。注意要通过命名空间别名确保项目内的引用指向这个包装类，而非原始供应商类。

3. IDE层面限制 #

• 自定义代码模板：在Visual Studio/Rider中，把创建命令的默认代码模板改成生成MyCustomCommand，覆盖IDE自带的ICommand实现模板。
• 过滤代码补全：部分IDE支持自定义代码补全规则，把VendorCommand从补全列表中隐藏，减少误用的可能。

4. .editorconfig配合规则 #

如果使用自定义Roslyn分析器，可以在.editorconfig中配置规则级别，强制触发错误：

# 假设自定义分析器的规则ID为VC001
dotnet_diagnostic.VC001.severity = error

内容的提问来源于stack exchange，提问作者Dan Narsavage