本文主要是介绍超硬货,大型 Rust 项目经验分享,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
本篇文章中,我将分享我组织大型 Rust 项目的经验。但这绝不是权威的,只是我通过尝试和错误中发现的一些小技巧。
Cargo,作为 Rust 的构建系统,遵循约定大于配置的原则。它不仅为小型项目提供了一套良好的默认配置集,尤其为公共 crates.io 库量身定做。虽然这些默认值并不完美,但它们已经足够用了。这对整个生态系统的一致性也是值得欢迎的。
然而当涉及到大型的、多 crate 的项目时,Cargo 就不那么统一了,它被组织成一个 Cargo 工作空间。而工作空间是灵活的 —— Cargo 对工作空间的布局并没有一个偏好统一。因此,人们会尝试不同的东西,取得不同程度的效果。
回到标题,我认为对于代码行数在一万到一百万之间的项目,扁平化结构是最为合理的。此处 rust-analyzer[1] (多达 200k 行)是一个比较好的例子,它的项目组织如下:
rust-analyzer/
Cargo.toml
Cargo.lock
crates/
rust-analyzer/
hir/
hir_def/
hir_ty/
...
在 repo 的根部,Cargo.toml 定义了一个虚拟清单:
Cargo.toml:
[workspace]
members = ["crates/*"]
其他的东西(包括 rust-analyzer "main" crate)都嵌套在 crates/ 下的某一个层级中。每个目录的名称都等于 crate 的名称。
crates/hir_def/Cargo.toml:
[package]
name = "hi
这篇关于超硬货,大型 Rust 项目经验分享的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!