跳到主要内容

1 / 4概念

Feature: Interop

unsafe 不是关闭检查,而是把证明责任从编译器转给开发者:代码必须满足别名、对齐、初始化和有效性等不变量。判断标准不是“能不能写”,而是能否写出不变量、调用方义务和验证它的测试。

1 概念​

1.1 一句话定义​

unsafe 块允许五种操作:解引用裸指针、调用 unsafe 函数、读写可变静态变量、实现 unsafe trait、访问 union 字段。FFI 通过 extern "C" 与 #[unsafe(no_mangle)] 暴露稳定的二进制接口;跨语言边界没有 Rust 的借用检查,所有契约都要用文档和测试固定。

1.2 它解决什么问题​

  • 操作系统接口、硬件寄存器和零拷贝缓冲区必须直接操作地址。
  • 已有 C/C++ 库无法重写时,需要稳定的调用边界。
  • 某些数据结构与算法需要突破借用检查的表达能力。
  • 性能敏感的代码需要显式控制布局、对齐与分配。

Rust 把 unsafe 缩小到最小块,并要求用安全抽象包住它;代价是每个 unsafe 块都要人工证明。

1.3 不属于本页的内容​

主题去哪
所有权与借用规则Ownership and Borrowing
trait、泛型与错误类型Traits, Generics, and Errors
async、执行器与 Send/SyncAsync and Concurrency
Cargo 依赖与构建产物Cargo and Quality Gates
虚拟内存与页表Memory Management

1.4 关键术语​

术语含义容易混淆的点
unsafe由开发者承担不变量的代码块不是“关闭所有检查”
UB未定义行为,编译器可任意假设不是“崩溃”
裸指针*const T 与 *mut T可以是空或悬垂
别名多个指针指向同一内存与 &mut T 互斥
对齐地址必须满足类型要求不是字节大小
provenance指针的来源与可访问范围不是单纯整数地址
MaybeUninit可能未初始化的值不能用 assume_init 猜
transmute按位重解释类型长度与有效性都不检查
repr(C)C 兼容的内存布局Rust 默认布局不保证
extern "C"C 调用约定不保证 panic 安全
catch_unwind捕获展开的 panic不能捕获 abort
Miri解释执行并检测 UB 的工具只覆盖执行的路径