SuperAPI AI 工具集

rust-unsafe

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:在编写 Rust unsafe 代码、FFI 绑定、裸指针操作或与 C 互操作时提供规范与检查清单,强调 unsafe 只用于应对未定义行为(UB)风险,而非“危险”或单纯性能优化,且所有代码必须 sound、通过 Miri 并附 SAFETY 注释。

主要能力:给出 unsafe 前置检查清单(先尝试安全替代方案、识别操作类型、记录不变量、用 cargo miri test 验证);列出十大陷阱及检测与修复方式,如悬垂指针、CString 提前释放、Vec::set_len 未初始化、#[repr(packed)] 字段引用、裸指针可变别名、transmute 尺寸错误、枚举判别值非法、跨 FFI 边界 panic 展开、双重释放、mem::forget 导致析构器不执行。按类别整理规则:通用原则、安全抽象、裸指针、内存布局、FFI、union、I/O 安全。提供安全抽象模式(用 NonNull、PhantomData、Drop、私有字段封装 unsafe)、FFI 包装模式(extern "C"、CString/CStr、opaque 类型、便携类型、RAII 清理)、错误处理(catch_unwind 防止 panic 跨边界)、回调注册、C 兼容结构体与布局编译期断言。

使用方式:资料未提供具体安装或调用命令;给出的 cargo miri test 需在具备 Miri 的环境中运行。分发包或集成方式暂未提供。

适用场景:编写或评审 unsafe 块、设计 FFI 绑定、封装 C 库、实现回调与 C 兼容结构体。

限制:本资料为技能说明,未给出收费、价格、平台支持或效果保证等信息。