.NET中in、out、ref、params关键字分别怎么用？使用场景和代码示例有哪些？

在.NET的C#开发中，参数传递相关的关键字是日常编码的高频使用内容，其中in、out、ref、params四个关键字各有不同的设计目的和使用规则，下面我们结合代码示例逐一讲解。

一、ref关键字：引用传递，允许修改原参数

ref关键字用于按引用传递参数，调用方法前必须先初始化参数，方法内部可以修改参数的值，修改会同步到原变量。

using System;

class Program
{
    static void Main()
    {
        int num = 10;
        Console.WriteLine($"调用前num的值：{num}");
        ModifyByRef(ref num);
        Console.WriteLine($"调用后num的值：{num}");
    }

    // ref参数需要先初始化，方法内修改会影响原变量
    static void ModifyByRef(ref int value)
    {
        value = value * 2;
    }
}

适用场景：需要方法修改传入的变量值，并且希望修改结果反映到调用方的时候使用。

二、out关键字：引用传递，用于多返回值

out关键字同样按引用传递，但是调用前不需要初始化参数，方法内部必须为out参数赋值，常用于需要返回多个结果的场景。

using System;

class Program
{
    static void Main()
    {
        int result;
        // out参数不需要提前初始化，调用时也要加out
        bool success = TryParseNumber("123", out result);
        if (success)
        {
            Console.WriteLine($"解析结果：{result}");
        }

        // C# 7.0之后支持out变量声明简化写法
        bool success2 = TryParseNumber("456", out int num2);
        if (success2)
        {
            Console.WriteLine($"解析结果2：{num2}");
        }
    }

    // 尝试解析字符串为数字，返回是否成功和数字结果
    static bool TryParseNumber(string input, out int output)
    {
        if (int.TryParse(input, out output))
        {
            return true;
        }
        output = 0;
        return false;
    }
}

适用场景：方法需要返回多个值，或者需要明确区分成功失败状态并返回对应结果的时候使用。

三、in关键字：只读引用传递，避免值拷贝

in关键字用于按只读引用传递参数，调用方传入的参数不能被方法修改，适合传递较大的结构体类型，避免值类型拷贝的性能开销。

using System;

struct LargeStruct
{
    public int Id;
    public string Name;
    public decimal[] Data;
}

class Program
{
    static void Main()
    {
        LargeStruct user = new LargeStruct
        {
            Id = 1,
            Name = "测试用户",
            Data = new decimal[1000]
        };
        // 传递大结构体，用in避免拷贝
        PrintStructInfo(in user);
    }

    // in参数不能修改，编译器会保证只读性
    static void PrintStructInfo(in LargeStruct info)
    {
        Console.WriteLine($"Id：{info.Id}，Name：{info.Name}");
        // 下面这行代码会编译报错，因为in参数是只读的
        // info.Id = 2;
    }
}

适用场景：传递较大的值类型参数，希望避免拷贝开销，同时不希望方法修改参数内容的时候使用。

四、params关键字：可变数量参数

params关键字用于修饰方法参数，允许调用方法时传入可变数量的同类型参数，或者传入数组，params参数必须是方法的最后一个参数。

using System;

class Program
{
    static void Main()
    {
        // 可以传入任意数量的int参数
        SumNumbers(1, 2, 3);
        SumNumbers(10, 20, 30, 40, 50);
        // 也可以直接传入数组
        int[] nums = { 1, 3, 5, 7 };
        SumNumbers(nums);
    }

    // params修饰的参数必须是最后一个参数，类型是数组
    static void SumNumbers(params int[] values)
    {
        int sum = 0;
        foreach (int num in values)
        {
            sum += num;
        }
        Console.WriteLine($"求和结果：{sum}");
    }
}

适用场景：方法需要接收不确定数量的同类型参数，比如日志打印、求和、拼接字符串等场景使用。

五、四个关键字的核心差异对比

实际开发中可以根据需求选择合适的参数关键字，避免不必要的性能开销或者逻辑错误。

in关键字out关键字ref关键字params关键字.NET参数传递修改时间：2026-05-29 15:26:10