如何在Roslyn Syntax Rewriter的VisitMethodDeclaration中添加Using指令

我明白你现在的困境——之前用Roslyn做方法重写和参数注入都顺顺利利的，结果一添加Using指令的代码就直接罢工了，这种功亏一篑的感觉确实让人头疼。结合Roslyn的特性，我帮你梳理几个最可能踩坑的地方，以及对应的解决思路：

Roslyn里所有语法节点都是不可变对象，你不能直接修改原有的CompilationUnit或者Usings集合，必须创建新的节点来替换旧节点。很多人在这里栽跟头，比如写了类似下面的错误代码：

// 错误：直接修改只读的Usings集合，会导致异常或无效状态
originalCompilationUnit.Usings.Add(newUsingDirective);

正确的做法是通过Roslyn提供的AddUsings方法生成新的CompilationUnit，再用它更新语法树：

// 1. 创建要添加的Using指令（注意处理换行等格式 trivia）
var newUsing = SyntaxFactory.UsingDirective(SyntaxFactory.ParseName("Your.Target.Namespace"))
    .WithLeadingTrivia(SyntaxFactory.CarriageReturnLineFeed)
    .WithTrailingTrivia(SyntaxFactory.CarriageReturnLineFeed);

// 2. 生成新的CompilationUnit节点
var updatedCompilationUnit = originalCompilationUnit.AddUsings(newUsing);

// 3. 用新节点替换原语法树的根节点
var updatedTree = originalSyntaxTree.WithRootAndOptions(updatedCompilationUnit, originalSyntaxTree.Options);

如果把Using指令加到了类内部、方法体里这类错误位置，会直接导致语法树无效，后续的重写逻辑自然会彻底停摆。你必须确保Using是添加到CompilationUnit的顶级Usings集合中——也就是和其他Using指令同级的位置。

可以通过SyntaxWalker遍历语法树，精准定位到CompilationUnit节点后再添加：

public class CompilationUnitFinder : SyntaxWalker
{
    public CompilationUnitSyntax FoundUnit { get; private set; }

    public override void VisitCompilationUnit(CompilationUnitSyntax node)
    {
        FoundUnit = node;
        base.VisitCompilationUnit(node);
    }
}

// 使用示例
var finder = new CompilationUnitFinder();
finder.Visit(originalSyntaxTree.GetRoot());
var targetUnit = finder.FoundUnit;

修改语法树之后，必须用新的语法树更新原有的Compilation对象，否则后续的方法重写、参数注入逻辑还是基于旧的无效语法树运行：

// 用更新后的语法树替换原Compilation中的对应树
var updatedCompilation = originalCompilation.ReplaceSyntaxTree(originalSyntaxTree, updatedTree);

很多时候程序“停止工作”是因为抛出了未被捕获的语法异常，你可以在处理逻辑里加上异常捕获，并输出详细的诊断信息，帮你定位问题：

try
{
    // 你的Roslyn处理代码：找节点、加Using、重写方法、注入参数
}
catch (Exception ex)
{
    Console.WriteLine($"处理出错：{ex.Message}");
    Console.WriteLine($"堆栈信息：{ex.StackTrace}");

    // 检查编译诊断（重点看错误级别的诊断）
    var diagnostics = updatedCompilation.GetDiagnostics();
    foreach (var diag in diagnostics.Where(d => d.Severity == DiagnosticSeverity.Error))
    {
        Console.WriteLine($"语法错误：{diag.GetMessage()}，位置：{diag.Location}");
    }
}

你可以先从检查「不可变节点的处理」和「Using的添加位置」这两点入手，大概率能找到问题所在。如果还是不行，用上面的诊断代码输出具体错误信息，就能更快定位到遗漏的细节了。

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