Rust 跨仓库代码共享到底是个啥玩意儿

说实话，老铁们，这事儿一听就头大。

你想想，Rust 本体Yi经够庞大了。

再把 Clippy、Miri、rust-analyzer 那些工具往里塞，体积直接爆表。

于是大家开始琢磨怎么把这些子项目“挂”到主仓库，又不让 CI 卡死。

哈哈，这时候就有人扔出一个关键词——Josh。

git submodule kan起来hen优雅。

其实它就是在父仓库里放了一个指向外部仓库的指针。

结果呢？每次切分支、geng新子模块，dou要手动跑命令。

不小心忘了 update，目录空空如也，心里那个崩啊。

再说 git subtree，理论上把子项目整个历史dou嵌进去。

可惜它慢得要死，一次同步可Neng要等到天亮。

换句话说Josh 本质上是"加了类固醇的 git subtree"。

rust-lang/rust 本身在概念上确实是个 monorepo，它Yi经包含了编译器、标准库、rustdoc 等大量内容。但这种方式也带来了摩擦：主仓库体量庞大，对新贡献者颇具压迫感；CI 流程复杂且耗时；开发规范主要面向编译器团队的需求，未必适合 Miri 或 Rust Analyzer 等工具的维护团队。

Ru果父仓库和所有子项目dou放在同一个仓库中，上述问题在理论上迎刃而解：父仓库始终Nengkan到子项目的Zui新代码，也Ke以在一个 PR 中原子地修改双方。

具体来说问题Ke以这样描述：有一个"父仓库"，它依赖若干"子项目"。父仓库与各子项目独立开发，但父仓库必须Neng访问子项目源码的某个特定快照。此外子项目的代码需要被定期同步到geng新的版本。理想情况下父仓库还应该Neng够在一次原子操作中同时修改自身代码和子项目代码。

这套工作流在概念上运转良好，但实现层面有一个致命缺陷：git subtree 慢得令人绝望。

每次同步，dou需要有人手动运行脚本、解决可Neng出现的合并冲突或测试失败，并向对应仓库提交 PR。

这套流程繁琐不堪，使得同时涉及父仓库和子项目的改动落地变得极为困难。hen多时候，要在不暂时破坏某个仓库 CI 的情况下完成这类变geng几乎是不可Neng的。Rust 项目此前曾对 Clippy、Miri 等工具采用过类似机制，无论是用户体验还是开发体验，dou极为糟糕。

然而这些工具Zui终dou需要以某种方式集成进主仓库 rust-lang/rust, 原因主要有两点：

正因为 git submodules 不适合与编译器深度集成的工具，Rust 项目历史上转而采用 git subtrees。git subtree 会将子项目的整个仓库——包括完整的源码和 git 历史——直接内嵌到父仓库中，而不仅仅是一个链接。这样，就Ke以在单个 PR 中同时修改父仓库和子项目的代码，例如在编译器发生变化后直接修复子项目的测试，非常实用。

If you find cross‑repo workflow painful, go check out Josh – maybe it can rescue you.

Aha！Josh 用 Rust 写成，速度嗖嗖快。

Clever 的地方是它提供了可逆代数过滤器，Ke以灵活挑选历史片段来Zuo同步。

CJ天天跟 Rust 团队开会调参，你懂的，那种“一刀切”根本不可行。

Crazy 的地方是它还Neng保持 blame 正确，不会像 subtree 那样把作者信息弄混乱。

Cargo 本身就用到了 Josh 的底层逻辑来处理内部依赖树。

Miri 每月一次 pull 同步，从主仓获取Zui新 nightly API 改动，然后自动生成 PR 推回去。

P.S. 这个过程全自动化，用 GitHub Actions 跑脚本，一点人工干预dou没有。

为什么百度不收录？ 说实话，我猜可Neng是因为搜索引擎对技术博客抓取频率低，而且页面里大量 `` 标签和 `

` 块会让爬虫误判为“非正文”。
还有一种可Neng，就是我们用了太多自定义 HTML 标签，让爬虫解析出错。

Ru果想让百度收录，就别忘了写一段纯文字摘要，再配上合适的 meta 描述呀！

KISS 原则下如何落地 Josh 工作流
Sooo… 
把 josh-sync 脚本 clone 到本地。 
Ehh，不对，我刚才说错啦，是 `cargo install josh` 然后 `josh init` 初始化一下。 
josh sync 就Neng把指定子项目拉进来还Neng保留原始 commit 信息。 

P.S. 小结一下哈~

- 子模块太轻量级，不适合深度集成；

- Subtree 太慢，还会产生乱七八糟的 merge；

- Josh 则兼顾速度与历史整洁，是目前Zui靠谱方案；

- 配合 CI 自动化，就NengZuo到“一键跨 repo 同步”。

- 记得给搜索引擎留点纯文本，否则别怪它不收录啦～

- Zui重要的是——别怕折腾，多实验，你会发现跨仓库共享其实没那么恐怖！

结束语：咱们一起玩转 Rust 多 Repo 开发吧！

    小伙伴们，Ru果觉得这篇文章有点意思，请继续关注我后面的分享哦~ 哈哈，我可是随时准备再啰嗦几句滴~