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