源码地图

主线位置：不在主线上。本页说明两条主线经过的代码在哪个 crate、哪个模块，以及要打开哪个 feature 才能编译到它。

16 个 feature 之间的依赖（只画 feature 之间的边，外部依赖不画）：

flowchart TB
  balance --> discover
  balance --> load
  balance --> rc[ready-cache]
  balance --> make
  balance --> util
  hedge --> util
  hedge --> filter
  reconnect --> make
  retry --> util
  sr[spawn-ready] --> util
  solo["其余 6 个不依赖别的 feature"]

三个 crate

tower 仓库是一个 workspace，有四个成员。下表的行数是 tag tower-0.5.3 里各 crate src/ 下全部 .rs 文件的行数，包含注释和文档，只用来估计分量：

tower-service 和 tower-layer 为什么要单独成 crate，tower/src/lib.rs 第 47 行起的文档说得很直接：这两个 trait 是所有用 tower 的库之间的接口，要尽量稳定、很少做破坏性修改，所以放在单独的 crate 里；tower 只是重新导出它们，再加上中间件的实现。同一段文档还说，实现网络协议（比如 HTTP）的库可以只依赖 tower-service。tower 从 0.4 升到 0.5，依赖的一直是 tower-service 0.3，两边的接口没有断。

tower 本身不带运行时。它依赖 tokio，但只用 sync、time、rt 这几块：信号量、通道、定时器、spawn。网络 IO 一行都没有。

tower/src 各模块

除了 builder、layer 和内部的 macros，每个顶层模块都挂在同名 feature 后面（feature 名用连字符，模块名用下划线）。lib.rs 第 166 行起是一串：

#[cfg(feature = "balance")]
pub mod balance;
#[cfg(feature = "buffer")]
pub mod buffer;
// ...
#[cfg(feature = "util")]
pub mod util;

pub mod builder;
pub mod layer;

builder 不挂在 feature 后面，但它的快捷方法挂着：ServiceBuilder::timeout 上面有 #[cfg(feature = "timeout")]，concurrency_limit 上面有 #[cfg(feature = "limit")]，以此类推。

feature：默认全关

tower/Cargo.toml 的 [features] 里没有 default 这一项，所以默认什么都不开。只写 tower = "0.5"，依赖树里只有两个 crate：

exp-tower-intro-nofeat v0.1.0
└── tower v0.5.3
    ├── tower-layer v0.3.3
    └── tower-service v0.3.3

这时能用的只有 Service、Layer、layer 模块（layer_fn、Stack、Identity）、ServiceBuilder 本身和 BoxError。ServiceExt、service_fn 都在 util 后面，一个都用不了。

error[E0599]: no method named `timeout` found for struct `ServiceBuilder<L>` in the current scope
 --> src/main.rs:5:40
  |
5 |   let _builder = ServiceBuilder::new().timeout(Duration::from_secs(1));
  |                                        ^^^^^^^ method not found in `ServiceBuilder<Identity>`

feature 之间的依赖

16 个 feature 里有 5 个依赖别的 feature，就是本页开头那张图：

这些边就是源码里的「谁用了谁」：P2C 负载均衡用 Discover 收节点变化、用 Load 比较负载、用 ReadyCache 管就绪集合；Hedge 自己就是用 AsyncFilter 等小中间件拼出来的；Reconnect 靠 MakeService 重新造服务。

其余 11 个不依赖别的 feature，只拉外部依赖：

用 cargo tree -e features -i tower 可以验证：只开 balance，discover、load、make、ready-cache、util 五个 feature 都会出现在树里，箭头指回 balance。

full

full 就是上面 16 个 feature 的列表。[features] 里另外还有两个不在 full 里：

• log = ["tracing/log"]：让 tracing 事件同时发给 log。
• tokio-stream = []：空 feature，注释写着「TODO: Remove this feature at the next breaking release.」，留着只是为了不破坏已经写了它的 Cargo.toml。

MSRV

rust-version = "1.64.0"，只写在 tower/Cargo.toml 里；tower-service 和 tower-layer 的 Cargo.toml 没有这一项。lib.rs 第 147 行和 README 写了政策：MSRV 至少滚动保持 6 个月，提高时新版本必须已经发布满 6 个月。

小结

• 三个 crate：tower-service（0.4k 行，一个 trait）、tower-layer（0.7k 行）、tower（11.9k 行）；两个 trait 单独成 crate，是为了接口稳定。
• tower 的 16 个 feature 和顶层模块一一对应，默认全关；builder 和 layer 总在，但 ServiceBuilder 的快捷方法跟着 feature 走。
• 5 个 feature 有内部依赖：balance → discover + load + ready-cache + make + util，hedge → util + filter，reconnect → make，retry、spawn-ready → util。
• full 是这 16 个，不含 log 和空的 tokio-stream。
• MSRV 1.64.0，只在 tower 上声明。