返回资讯中心
外部精选
软件工程
#开发者实时流

Needful:为 C 语言带来 Rust 级类型检查,零运行时开销

来源标题:Needful: Rust-grade type checking for C, at zero runtime cost

Needful 是一个单文件、仅头文件的库,为 C 代码引入 Option(T)、Result(T)、非空 Need(T)、类型安全转换和可执行注释标注。它通过同一份源码在 C 与 C++ 下以不同模式编译来实现严格检查,发布构建不增加任何运行时库或开销。该项目定位是类型规范层而非内存安全层,不防止 use-after-free、缓冲区溢出等问题。

Hacker News 最新ae10202026/11/12 · 5 天前18 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Needful 是一个单文件、header-only 的库,为 C 代码库带来 Option(T)、Result(T)、非空 Need(T)、类型安全转换以及可执行注释标注。它是一层类型约束,而不是内存安全层。它能捕获建模错误的值和接口错误;它不能防止 use-after-free、缓冲区溢出、数据竞争或整数溢出缺陷。

关键在于架构设计,而非魔法:同一份源码可以在多种模式下编译,宏的角色会从透明的词汇变为严格的检查包装器。你的 C 代码仍然是 C。C++ 编译器只是能更严格地检查它。从安全角度看,Needful 很容易评估:发布构建用的是 C 还是 C++,如果 NEEDFUL_CPP_ENHANCED 关闭,你运行的就是零额外运行时代码。在 CI 中运行带检查的构建,则会增加静态分析压力,从而发现真实的缺陷。因此“零依赖”的意思是:在发布构建中(C,或未启用增强的 C++),Needful 不增加运行时库,也不要求伴随目录树。额外的依赖只属于可选的增强检查模式,而较重的 C++ 机制恰恰只存在于那里。

第 1 步。把 needful.h 放进你的项目并 #include 它。所有宏都会展开为简单的 C——你的构建甚至不会察觉。第 2 步。准备好后,把 needful-enhanced/ 增强文件与 needful.h 放在一起。(把这个目录加入你的 .gitignore,不要提交它。)#define NEEDFUL_CPP_ENHANCED 1,并以 C++11 或更高版本构建。宏开始长牙:类型不匹配会变成编译错误。如果 C++ 编译器在任何 Needful 检查运行之前就拒绝了你的 C 代码,第一次尝试时这是预期之中的:参见 Building C as C++。为了让 CI 可靠地执行这些检查,请以警告即错误(-Werror / /WX)的方式运行带检查的构建。所以是的,即使没有警告即错误,Needful 仍然有用,但“必须使用 / 必须处理”承诺的一部分会变成建议性的,而非强制性的。第 3 步。在 CI 中运行两种模式:C 构建用于生产,C++ 增强构建用于捕获缺陷。两者之间无需修改代码!

其中有两项值得再看一眼,因为它们的名字低估了它们的作用:nocast 是让“直接把我的 C 当 C++ 编译”在真实代码库中存活下来的关键。没有它,上面的第 2 步会让你淹没在关于 malloc() 返回 void* 以及 int 到 enum 赋值的错误中——而这些在 C 里完全没问题。它未覆盖的不兼容情况以及各自的修复方法,都在 Building C as C++ 中。注释宏是 Needful 中唯一在 Rust、C++ 或其他任何语言中没有等价物的部分——也是唯一完全不要求类型改动的部分。如果你想尝试一样东西,就试试这些。

没有魔法。C 定义是完整写出来的,你可以看到它们有多简单。把 Needful 加入 C 项目是一项低影响的选择。渐进采用。今天只用 nocast。下个月加 Option。准备好时再启用 NEEDFUL_CPP_ENHANCED。什么都不会坏。代码库文档。注释宏(possibly、definitely、impossible、unnecessary、dont)用编译期检查的表达式取代散文注释,并让这些表达式保持最新。可编译的文档。同样的理念,也用在了本站上。这里每个演示受检查行为的示例都会被提取出来,并在 CI 中用 GCC、Clang 和 MSVC 构建——正向示例必须编译并运行,负向示例必须因所述原因而编译失败。一个过时的示例不会悄悄误导你;它会让构建变红。这些页面之间的链接也以同样的方式检查。

Needful 在以下条件全部成立时最有用:你有一个 C 代码库,其中可空性、错误传播和输出参数误用会产生昂贵的缺陷。你可以在 CI 中偶尔运行带检查的 C++ 构建,即使发布产物仍以 C 构建。你希望获得更强的静态检查,同时不引入运行时依赖,也不把代码库重写成另一种语言。如果你的首要目标是内存安全,那这不该是首选工具。如果你的目标是在现有 C 中加强值和 API 约束,那这恰恰就是它的定位。

大多数项目给你看的是软球。这里先把硬球摆出来,让你现在就发现它们,而不是三周后。它不是内存安全解决方案。Needful 是类型约束层。它不会阻止 use-after-free、缓冲区溢出、数据竞争或整数溢出。它捕获的是这样一类缺陷:一个值的含义被误解了——可能为空的值被当作永不为空,错误返回值被丢弃,输出参数被赋予了类型层级的错误一端。这是一类真实且有价值的缺陷。但它不是会被分配 CVE 的那一类。强制执行并不统一,而且有一种常见配置什么都不检查。Fallible(T) 做出三个承诺,而没有任何单一构建能同时兑现这三个;在 C23 以下的 C 模式中,MSVC 一个都不兑现。完整矩阵被如实记录,而不是埋起来——在决定哪个构建才是你真正的闸门之前,请先读它。警告必须变成错误,否则你什么也得不到。Needful 拒绝的大多数内容都会以警告形式出现,然后编译器以零退出。没有 -Werror / /WX,CI 会对你加入 Needful 正是为了捕获的那些错误保持绿色。带检查的构建需要第二个仓库。我们说“一个头文件,无依赖”,这对发布构建成立。检查构建则希望把 needful-enhanced/ 克隆到旁边,并保持版本匹配。这是有意为之的权衡——但也是简单叙事不再简单的那个点。你的 C 可能还无法作为 C++ 解析。C 不是 C++ 的子集。跳过初始化的 goto、乱序书写的指定初始化器、名为 new 的变量:每一个都会在 Needful 查看任何东西之前让带检查的构建停下。nocast 覆盖了两种最常见的破坏情况,Building C as C++ 为其余大多数情况提供了变通方法。把现有代码库迁移过来仍然是真正的工作,而且少数构造完全没有变通方法。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →