如何使用Roslyn在命名空间外部添加using指令？

要把using指令加到命名空间上方的全局区域，你需要重写VisitCompilationUnit方法而非VisitNamespaceDeclaration——因为整个C#文件的根语法节点是CompilationUnitSyntax，它直接包含全局的using指令集合和命名空间声明。

完整实现代码 #

public class AddGlobalUsingDirective : CSharpSyntaxRewriter
{
    private readonly NameSyntax _usingName;

    public AddGlobalUsingDirective(string usingNamespace)
    {
        _usingName = SyntaxFactory.ParseName(usingNamespace);
    }

    public override SyntaxNode VisitCompilationUnit(CompilationUnitSyntax node)
    {
        // 检查要添加的using是否已经存在，避免重复添加
        var existingUsings = node.Usings.Select(u => u.Name.ToString());
        if (existingUsings.Contains(_usingName.ToString()))
        {
            return node; // 已存在则直接返回原节点
        }

        // 创建新的using指令，保留格式换行
        var newUsing = SyntaxFactory.UsingDirective(_usingName)
            .WithLeadingTrivia(SyntaxFactory.ElasticCarriageReturnLineFeed)
            .WithTrailingTrivia(SyntaxFactory.ElasticCarriageReturnLineFeed);

        // 将新using添加到全局using集合中
        var updatedUsings = node.Usings.Add(newUsing);

        // 重新构建编译单元，替换using集合并保持其他内容不变
        var updatedCompilationUnit = node.WithUsings(updatedUsings)
            .NormalizeWhitespace();

        return base.VisitCompilationUnit(updatedCompilationUnit);
    }
}

关键说明 #

• 根节点处理：CompilationUnitSyntax是整个C#文件的语法根，所有全局using和命名空间都属于它的成员，在这里修改才能把using加到命名空间外部。
• 重复检查：添加前先判断目标using是否已存在，避免生成冗余代码。
• 格式保持：用ElasticCarriageReturnLineFeed处理换行，配合NormalizeWhitespace()保证生成的代码格式和原文件一致。

使用示例 #

// 假设你已经有了要修改的SyntaxTree
var tree = CSharpSyntaxTree.ParseText(yourSourceCode);
var root = tree.GetRoot();

var rewriter = new AddGlobalUsingDirective("MyCompany.MyProject.DataAccessLayer.Abstractions");
var newRoot = rewriter.Visit(root);

// 输出修改后的代码
var updatedCode = newRoot.ToFullString();

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