如何在DiagnosticAnalyzer中获取特性的构造参数值

场景重现 #

特性定义在独立程序集中：

[AttributeUsage(AttributeTargets.All, AllowMultiple = true)]
public class MyAttribute: Attribute
{
     public MyAttribute(string name) {}
     public MyAttribute(int number) {}
}

[AttributeUsage(AttributeTargets.All)]
[My("whatever")]
[My(333)]
class XAttribute: Attribute {
}

[XAttribute]
public class Usage {}

需要在DiagnosticAnalyzer中获取XAttribute上附加的MyAttribute实例的参数值（"whatever"和333），但尝试代码后，AttributeData的ConstructorArguments和NamedArguments始终为空。

原因及解决方案 #

核心问题 #

原有代码存在两个关键问题：

1. 通过AttributeSyntax获取构造函数符号后，仅用类名匹配MyAttribute容易引发命名冲突；
2. 特性定义在外部程序集时，若编译上下文未正确加载该程序集的完整符号信息，会导致参数无法被解析。

正确实现代码 #

private static void AnalyzeNode(SyntaxNodeAnalysisContext context)
{
    // 获取当前分析的类符号（假设节点是类声明）
    var classSymbol = context.SemanticModel.GetDeclaredSymbol(context.Node) as INamedTypeSymbol;
    if (classSymbol == null) return;

    // 获取类上的XAttribute实例
    var xAttributeData = classSymbol.GetAttributes()
        .FirstOrDefault(a => a.AttributeClass?.MetadataName == nameof(XAttribute));
    if (xAttributeData?.AttributeClass == null) return;

    // 获取XAttribute类型本身的符号
    var xAttributeType = xAttributeData.AttributeClass;

    // 获取XAttribute上的所有MyAttribute实例（结合程序集避免同名）
    var myAttributes = xAttributeType.GetAttributes()
        .Where(a => 
        {
            var attrClass = a.AttributeClass;
            return attrClass != null 
                && attrClass.MetadataName == nameof(MyAttribute)
                && attrClass.ContainingAssembly.Name == "外部程序集的名称"; // 替换为实际程序集名
        })
        .ToList();

    // 遍历解析每个MyAttribute的构造参数
    foreach (var myAttr in myAttributes)
    {
        if (myAttr.ConstructorArguments.Count == 0) continue;

        var argValue = myAttr.ConstructorArguments[0].Value;
        switch (argValue)
        {
            case string str:
                // 处理字符串参数："whatever"
                break;
            case int num:
                // 处理整数参数：333
                break;
        }
    }
}

关键注意事项 #

• 确保外部程序集被引用：Analyzer项目必须引用定义特性的程序集，或打包时将其作为依赖项包含，否则Roslyn无法解析完整符号信息；
• 精确匹配特性类型：结合MetadataName和程序集名称匹配特性，避免同名特性干扰；
• 优先操作符号而非语法节点：通过INamedTypeSymbol.GetAttributes()获取AttributeData，比从语法节点遍历更可靠，尤其适用于跨程序集场景。

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