C# 8起可空引用类型是编译时静态空值检查机制,启用后引用类型默认非空,需用?显式声明可空,用!断言非空;核心在于主动声明意图以预防NullReferenceException。

从 C# 8 开始,可空引用类型(Nullable Reference Types)不是让引用类型“变可空”,而是开启编译时静态空值检查——它帮你提前发现可能的 NullReferenceException,而不是等运行时报错。
一、启用可空引用类型
这是所有操作的前提。在项目文件(.csproj)中添加:
或者在代码顶部加全局启用指令(仅限单文件):
#nullable enable
启用后,编译器会将所有引用类型(如 string、object、List)默认视为非空(non-nullable);若想表示“可以为 null”,需显式加 ? 后缀,例如 string?、IList。
二、理解两个核心符号:? 和 !
-
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表示列表本身不可空、且每个元素也不可空;List表示列表非空,但元素可为空;List表示整个列表对象可为空? -
与旧代码交互:未启用可空特性的库会被标记为“null 状态未知”,编译器警告降级为“可能为 null”提示(warning CS8602/CS8604),可用
#nullable disable临时关闭检查
四、实用技巧与避坑提醒
- 用
[AllowNull]、[MaybeNull]等属性细化 API 含义(需System.Diagnostics.CodeAnalysis) - 不要为了消除警告盲目加
!——先确认逻辑是否真能保证非空,否则不如改用空合并(??)、条件访问(?.)或抛出异常 - 启用后,IDE(如 Visual Studio 或 Rider)会在变量悬停时显示
(nullable)或(not null)标识,善用这个提示 - 团队迁移建议:先在新项目启用,老项目可逐步用
#nullable disable包裹旧区域,再逐个模块升级
基本上就这些。可空引用类型不是语法糖,而是一套轻量级契约系统——它靠你主动声明意图,换编译器替你盯住空值风险。










