Roslyn分析器基于编译器API实现代码实时分析，通过DiagnosticAnalyzer检测问题、CodeFixProvider提供修复，可自定义规则如禁止使用DateTime.Now，并打包为NuGet供团队集成，结合CI/CD提升代码质量。

.NET中的Roslyn分析器是基于Roslyn编译器平台的一组可扩展工具，用于在代码编译前或编辑过程中分析C#或VB.NET代码。它不仅能发现潜在的bug、性能问题和安全漏洞，还能强制执行团队约定的编码规范。与传统静态分析工具不同，Roslyn分析器能深度理解语法树、语义模型和符号信息，因此可以实现更精确、上下文敏感的代码检查。

理解Roslyn分析器的工作机制

Roslyn公开了编译器的API，让开发者可以“看懂”代码结构。分析器通过监听编译过程中的语法节点、语义模型变化来触发检查。当你在Visual Studio中编写代码时，分析器会实时扫描语法树（SyntaxTree），注册对特定节点（如方法声明、变量赋值）的兴趣，一旦匹配就进行逻辑判断并报告诊断（Diagnostic）。

关键组件包括：

• DiagnosticAnalyzer：定义要检测的问题，比如“禁止使用var声明基础类型”
• CodeFixProvider：提供自动修复建议，例如将var i = 0;改为int i = 0;
• DiagnosticDescriptor：描述问题的ID、消息、严重性（Error/Warning/Info）等元数据

创建自定义分析器的基本步骤

编写一个简单的规则：禁止在项目中使用DateTime.Now，推荐使用DateTime.UtcNow或依赖注入时间服务。

1. 创建分析器项目
使用.NET CLI命令生成模板：

dotnet new analyzer -n MyTeam.Rules

2. 定义诊断规则
在Analyzer类中定义规则ID和描述：

private static readonly DiagnosticDescriptor UseUtcNowRule = new(
    id: "TEAM0001",
    title: "使用 DateTime.UtcNow 而非 DateTime.Now",
    messageFormat: "不要使用 DateTime.Now，建议使用 DateTime.UtcNow",
    category: "Design",
    defaultSeverity: DiagnosticSeverity.Warning,
    isEnabledByDefault: true);

3. 注册语法节点回调
在Initialize方法中监听成员访问表达式：

public override void Initialize(AnalysisContext context)
{
    context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.None);
    context.EnableConcurrentExecution();
    context.RegisterSyntaxNodeAction(AnalyzeMemberAccess, SyntaxKind.SimpleMemberAccessExpression);
}

4. 实现分析逻辑
检查是否访问了DateTime.Now：

private static void AnalyzeMemberAccess(SyntaxNodeAnalysisContext context)
{
    var memberAccess = (MemberAccessExpressionSyntax)context.Node;
    var symbol = context.SemanticModel.GetSymbolInfo(memberAccess).Symbol;

    if (symbol is IPropertySymbol property &&
        property.Name == "Now" &&
        property.ContainingType?.Name == "DateTime")
    {
        var diagnostic = Diagnostic.Create(UseUtcNowRule, memberAccess.GetLocation());
        context.ReportDiagnostic(diagnostic);
    }
}

5. 添加代码修复（可选）
实现CodeFixProvider，将DateTime.Now替换为DateTime.UtcNow。用户可在VS中按下Ctrl+查看修复建议。

集成到团队开发流程

提升代码质量不能只靠工具，需结合流程落地：

• 将分析器打包为NuGet包（dotnet pack），发布到内部源，团队统一引用
• 在Directory.Build.props中引入包，确保所有项目自动生效
• 配置.editorconfig文件控制规则严重性，例如把TEAM0001设为error阻止提交
• 与CI/CD集成，在构建时失败不符合规则的代码
• 定期评审规则，避免过度约束影响开发效率

常见的有效自定义规则包括：禁止直接new HttpClient、要求方法参数加注释、限制项目间依赖层级等。关键是根据团队痛点设计，而非追求大而全。

基本上就这些。掌握Roslyn分析器后，你可以把代码评审经验转化为自动化检查，持续推动代码风格统一和技术债务降低。不复杂但容易忽略的是测试——记得为每个分析器编写单元测试，验证它能在真实代码场景下准确触发。