C#怎么使用null可空引用类型 C# 8可空引用类型全面指南

来源:这里教程网 时间:2026-02-21 17:36:44 作者:

从 C# 8 开始,可空引用类型(Nullable Reference Types)不是让引用类型“变可空”,而是开启编译时静态空值检查——它帮你提前发现可能的

NullReferenceException
,而不是等运行时报错。

一、启用可空引用类型

这是所有操作的前提。在项目文件(

.csproj
)中添加:


  enable

或者在代码顶部加全局启用指令(仅限单文件):

#nullable enable

启用后,编译器会将所有引用类型(如

string
object
List<t></t>
)默认视为非空(non-nullable);若想表示“可以为 null”,需显式加
?
后缀,例如
string?
IList<int>?</int>

二、理解两个核心符号:? 和 !

T?
表示“类型 T 的可空引用”——编译器允许它为
null
,且不会对它做非空警告
value!
是空值断言操作符——告诉编译器“我保证这里不为 null”,绕过警告(慎用!滥用会掩盖真实问题)

例如:

string? name = GetUserName(); // 允许为 null
string displayName = name ?? "Anonymous"; // 安全使用
Console.WriteLine(name!.Length); // 编译通过,但若 name 为 null,运行时仍崩

三、常见场景与写法建议

方法参数和返回值:明确意图。比如
void Process(string input)
表示调用方必须传非 null 字符串;而
string? GetName()
表示该方法可能返回 null
字段/属性初始化:非空引用字段必须在构造函数中赋初值,或声明为可空(
string? description;
),否则编译报错
集合与泛型
List<string></string>
表示列表本身不可空、且每个元素也不可空;
List<string></string>
表示列表非空,但元素可为空;
List<string>?</string>
表示整个列表对象可为空
与旧代码交互:未启用可空特性的库会被标记为“null 状态未知”,编译器警告降级为“可能为 null”提示(warning CS8602/CS8604),可用
#nullable disable
临时关闭检查

四、实用技巧与避坑提醒

[AllowNull]
[MaybeNull]
等属性细化 API 含义(需
System.Diagnostics.CodeAnalysis
不要为了消除警告盲目加
!
——先确认逻辑是否真能保证非空,否则不如改用空合并(
??
)、条件访问(
?.
)或抛出异常
启用后,IDE(如 Visual Studio 或 Rider)会在变量悬停时显示
(nullable)
(not null)
标识,善用这个提示
团队迁移建议:先在新项目启用,老项目可逐步用
#nullable disable
包裹旧区域,再逐个模块升级

基本上就这些。可空引用类型不是语法糖,而是一套轻量级契约系统——它靠你主动声明意图,换编译器替你盯住空值风险。

相关推荐