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

16次阅读

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

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

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

一、启用可空引用类型

这是所有操作的前提。在项目文件(.csproj)中添加:

  enable

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

#nullable enable

启用后,编译器会将所有引用类型(如 StringObjectList)默认视为非空(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 包裹旧区域,再逐个模块升级

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

text=ZqhQzanResources