源码地图

主线位置：三条主线经过的 crate 和文件。主线 1（一条消息）全在 crossbeam-channel 里，主线 2（一个任务）在 crossbeam-deque，主线 3（一块内存的回收）在 crossbeam-epoch；三条线都踩在 crossbeam-utils 上。

flowchart BT
  utils["crossbeam-utils 0.8.23"]
  epoch["crossbeam-epoch 0.9.21"] --> utils
  deque["crossbeam-deque 0.8.8"] --> epoch
  deque --> utils
  chan["crossbeam-channel 0.5.17"] --> utils
  queue["crossbeam-queue 0.3.14"] --> utils
  skip["crossbeam-skiplist 0.1.3（不在发布分支）"] --> epoch
  skip --> utils
  facade["crossbeam 0.8.5（门面）"] --> chan
  facade --> deque
  facade --> epoch
  facade --> queue
  facade --> utils

crate 与依赖

依赖只有一个方向：utils 在最底下，不依赖任何 crossbeam crate；epoch 依赖 utils；deque 和 skiplist 依赖 epoch 和 utils；channel 和 queue 只依赖 utils。门面 crossbeam 依赖除 skiplist 外的全部。行数是 src/ 下 .rs 的总行数，含文档注释和文件内的单元测试，不含 tests/、benches/：

工作区根 Cargo.toml 的 members 里，skiplist 那一行被注释掉了：

members = [
  ".",
  "crossbeam-channel",
  "crossbeam-channel/benchmarks",
  "crossbeam-deque",
  "crossbeam-epoch",
  "crossbeam-queue",
  # "crossbeam-skiplist", # Not published from this branch.
  "crossbeam-utils",
]

这就是为什么 skiplist 用的是另一个 tag：发布分支上的 skiplist 目录比 0.1.3 还旧（Cargo.toml 写 version = "0.0.0"），见 怎么读这一卷。

门面 crate

src/lib.rs 是 #![no_std]，正文只有重导出：

pub use crossbeam_utils::atomic;

pub mod utils {
    pub use crossbeam_utils::Backoff;
    pub use crossbeam_utils::CachePadded;
}

#[cfg(feature = "alloc")]
#[doc(inline)]
pub use {crossbeam_epoch as epoch, crossbeam_queue as queue};

#[cfg(feature = "std")]
#[doc(inline)]
pub use {
    crossbeam_channel as channel, crossbeam_channel::select, crossbeam_deque as deque,
    crossbeam_utils::sync,
};

#[cfg(feature = "std")]
#[cfg(not(crossbeam_loom))]
pub use crossbeam_utils::thread::{self, scope};

no_std 下只剩 atomic 和 utils；开 alloc 多出 epoch、queue；std 才有 channel、select!、deque、sync 和 scope。crossbeam::scope 在 cfg(crossbeam_loom) 下不存在。

每个文件管什么

crossbeam-utils

crossbeam-epoch

crossbeam-deque：deque.rs 一个文件 2261 行，Worker、Stealer、Injector、Steal；lib.rs 只有文档和重导出。

crossbeam-channel

crossbeam-queue：seg_queue.rs 713 行，array_queue.rs 645 行。

crossbeam-skiplist（0.1.3）：base.rs 2123 行（跳表本体），map.rs 783 行、set.rs 629 行（带默认收集器的包装），lib.rs 257 行。

feature

cfg

除 feature 外，源码里还有五个 cfg 改变行为。它们不是 feature，由 RUSTFLAGS、构建脚本或编译器给出：

no_atomic.rs 是 ci/no_atomic.sh 生成的：用 rustc --print all-target-specs-json 找出 max-atomic-width 为 0、或者最小原子宽度不是 8 的目标。CI 的 codegen 任务每次重新生成一遍，git diff --exit-code 确认文件没过时。

本卷只在 aarch64 macOS 上用默认 feature 编译和运行，以上 cfg 都没有打开。

MSRV

README 写的是 1.61；各 crate 的 rust-version 是 1.60（utils、channel、queue）或 1.61（epoch、deque、skiplist、门面）。0.8.23 / 0.5.17 这一轮把政策从「支持半年内的 Rust」改成「支持一年内」（#1284），理由写的是和 rayon 的 MSRV 政策对齐。CI 的 test 矩阵最低测到 1.65（Linux）和 1.71（Windows），features 任务用 cargo hack --rust-version 按各 crate 声明的 MSRV 编译（不跑测试）。

低 MSRV 解释了 utils 和 epoch 为什么各自带一份 OnceLock（std 的要 1.70 才稳定）。另有几处注释比 MSRV 还旧：x86 上 pin 那段说「stable 上用不了内联汇编」（asm! 1.59 已稳定），AtomicCell 那段说「AtomicU8 在 stable 上不可用」。

小结

• 五个发布 crate 加门面：utils 在底层，epoch 依赖 utils，deque 依赖 epoch，channel、queue 只依赖 utils；门面只做重导出，no_std / alloc / std 三档逐级放开。
• skiplist 不在发布分支的工作区成员里，本卷用 tag crossbeam-skiplist-0.1.3，src/ 共 3792 行。
• feature 只有 std、alloc、nightly（已无作用）、loom；真正改行为的是五个 cfg：crossbeam_loom、crossbeam_sanitize、crossbeam_sanitize_thread、crossbeam_no_atomic、miri。
• MSRV 1.60 / 1.61，CI 测到 1.65 / 1.71。