从 C# 8 开始,可空引用类型(Nullable Reference Types)不是让引用类型“变可空”,而是开启编译时静态空值检查——它帮你提前发现可能的
NullReferenceException,而不是等运行时报错。
一、启用可空引用类型
这是所有操作的前提。在项目文件(
.csproj)中添加:
或者在代码顶部加全局启用指令(仅限单文件):
#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包裹旧区域,再逐个模块升级
基本上就这些。可空引用类型不是语法糖,而是一套轻量级契约系统——它靠你主动声明意图,换编译器替你盯住空值风险。
