C#的可空引用类型是C# 8.0及更高版本中引入的编译时特性，它改变了引用类型默认可以为null的传统行为，通过编译器的静态流分析，在代码编写阶段就标记出可能的空引用风险，从而帮助开发者提前规避NullReferenceException异常。该特性不会在运行时改变代码的行为，而是通过编译器的警告和错误提示，约束开发者对引用类型变量的空值处理。
可空引用类型的核心概念
在可空引用类型特性启用之前，C#中的所有引用类型（如string、自定义类等）默认都可以赋值为null，编译器不会对此做任何限制，这也是NullReferenceException高发的主要原因。启用可空引用类型后，引用类型被分为两类：
- 不可空引用类型：默认情况下，未添加?后缀的引用类型被视为不可空，编译器会要求这类变量在声明时必须初始化，或者在赋值前确保不为null，否则会给出警告。
- 可空引用类型：在引用类型后添加?后缀（如string?），表示该变量可以接受null值，编译器会要求开发者在使用这类变量前检查其是否为null，否则会给出警告。
要启用可空引用类型，可以在项目文件中添加以下配置：
<PropertyGroup> <LangVersion>8.0</LangVersion> <Nullable>enable</Nullable> </PropertyGroup>
也可以在单个代码文件的开头使用指令控制：
#nullable enable // 启用可空引用类型 #nullable disable // 禁用可空引用类型
可空引用类型如何避免NullReferenceException
1. 编译时约束不可空引用类型的赋值
当启用可空引用类型后，如果尝试将null赋值给不可空引用类型变量，编译器会直接给出警告，提醒开发者这里存在风险：
#nullable enable string name = null; // 编译器警告：将null文本或可能的null值转换为不可为null的类型 string? nullableName = null; // 合法，可空引用类型可以赋值null
这种约束让开发者在编写代码时就能发现明显的空值赋值问题，避免后续使用该变量时触发异常。
2. 强制检查可空引用类型的空值状态
对于可空引用类型变量，编译器会通过静态流分析判断其在使用前是否已经被检查过不为null。如果未检查就直接调用其成员，会给出警告：
#nullable enable
string? GetName()
{
return null;
}
void PrintName()
{
string? name = GetName();
// 未检查name是否为null就调用Length属性，编译器警告：解引用可能为null的引用
int length = name.Length;
}
开发者需要先对可空引用类型变量进行空值检查，编译器确认变量不为null后，才会允许直接调用其成员：
#nullable enable
string? GetName()
{
return null;
}
void PrintName()
{
string? name = GetName();
if (name != null)
{
// 编译器确认name在此处不为null，不会给出警告
int length = name.Length;
Console.WriteLine($"名字长度：{length}");
}
else
{
Console.WriteLine("名字为空");
}
}
3. 空值免除操作符的合理使用
如果开发者明确知道某个可空引用类型变量在此时一定不为null，可以使用空值免除操作符!来告诉编译器跳过检查，但这种方式需要谨慎使用，否则仍然可能触发运行时异常：
#nullable enable
string? GetName()
{
return "test";
}
void PrintName()
{
string? name = GetName();
// 使用!操作符告诉编译器name不为null，跳过检查
int length = name!.Length;
}
如果GetName方法实际返回了null，上述代码仍然会抛出NullReferenceException，因此该操作符仅适合在开发者完全确定变量状态的情况下使用。
4. 泛型与API的空值状态标注
可空引用类型还支持对API的返回值和参数进行空值状态标注，比如使用AllowNull、DisallowNull、MaybeNull等特性，明确告知调用方参数的可空性和返回值的空值状态，进一步减少调用时的空引用风险：
#nullable enable
using System.Diagnostics.CodeAnalysis;
public class UserService
{
// 告知调用方，即使参数是不可空引用类型，也允许传入null
public void UpdateUserName([AllowNull] string name)
{
if (name == null)
{
name = "默认用户";
}
Console.WriteLine($"更新用户名为：{name}");
}
// 告知调用方，返回值可能为null
[return: MaybeNull]
public string GetUserEmail()
{
return null;
}
}
使用注意事项
可空引用类型是编译时特性，不会影响运行时的行为，因此即使在编译时没有警告，如果开发者通过!操作符或者错误的逻辑绕过了检查，仍然可能在运行时抛出NullReferenceException。另外，旧项目迁移时如果直接启用可空引用类型，可能会出现大量的编译器警告，建议逐步迁移，先处理核心逻辑的空值问题，再逐步覆盖全部代码。
总的来说，可空引用类型通过编译器的静态分析，将原本运行时的NullReferenceException风险提前到编译阶段暴露，只要开发者遵循编译器的提示合理处理空值，就能大幅减少这类异常的出现，提升代码的健壮性。
C#可空引用类型NullReferenceExceptionnullable_reference_type修改时间：2026-07-10 04:24:31