Nullable Annotation 具体含义是什么？C# 可空特性设置疑问

架构老林

2026-10-21

C# 可空配置项Annotation模式的设计逻辑说明

这个模式是C# 可空特性为旧项目渐进式迁移提供的中间态配置，解决老项目直接开启全量可空警告时出现数百条报错、无法一次性完成改造的问题。
该模式下的核心行为和作用如下：
- 编译器会正常识别所有可空相关注解：包括string?这类可空引用类型标记、[NotNullWhen]/[MaybeNull]等可空特性注解，也会默认将无?后缀的引用类型识别为不可空，只是不会触发任何可空性警告。
- 最常见的使用场景是类库项目：你可以先给所有对外公开的API补充可空注解，其他已经开启可空警告的项目调用你的类库时，就能拿到正确的可空性提示；同时你自己的项目内部不会弹出大量可空警告，现有编译流程完全不受影响。
- 当你后续计划逐步处理项目内的可空问题时，直接将配置切换为启用所有警告即可，之前补充的所有注解都会直接生效，不需要再返工补全注解。