Cargo 与 Bazel:两种构建系统在 Rust 大型项目中的取舍分析

【零基础学Rust | 基础系列 | Cargo工具】Cargo介绍及使用 在编程世界中,工具的选择与使用同样重要,甚至有时候比编程语言本身更为重要。对于Rust来说,Cargo就是这样一款强大的工具。本文将详细介绍Cargo的各项功能,并通过实例演示如何使用这些功能。希望通过本文,读者能够熟练掌握Cargo的使用,从而更好地进行Rust开发。 阅读详情

Cargo 与 Bazel:两种构建系统在 Rust 大型项目中的取舍分析

一、Cargo:够用就好

Cargo 是 Rust 的官方构建系统,对纯 Rust 项目来说几乎完美:

# Cargo.toml —— 简洁直观的配置
[package]
name = "my-service"
version = "0.1.0"
edition = "2021"

[dependencies]
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }
serde_json = "1"
# 一个 cargo build 搞定一切

Cargo 的优势很明显:

  • 零配置入门:cargo new 就能开始写代码。
  • crates.io 生态:依赖管理自动、版本解析可靠。
  • 项目结构约定:src/main.rs、src/lib.rs 等约定让所有 Rust 项目看起来一样。
  • 增量编译:cargo build 自动只编译修改过的部分。

但 Cargo 也有局限:

  • 只懂 Rust:无法管理 C++、Python、Protobuf 等非 Rust 代码。
  • 单仓库支持弱:monorepo 场景下,跨 crate 的依赖处理不够灵活。
  • 缓存粒度粗:没有分布式构建缓存(虽然有 sccache,但不是内建的)。

二、Bazel:为大型多语言项目而生

Bazel 是 Google 开源的构建系统,支持几十种语言,核心卖点是多语言、增量编译、分布式缓存。

一个典型的 Bazel Rust 项目结构如下:

# WORKSPACE —— 定义外部依赖和工作空间
workspace(name = "my_project")

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

# 导入 Rust 规则
http_archive(
    name = "rules_rust",
    sha256 = "...",
    urls = ["https://github.com/bazelbuild/rules_rust/releases/download/..."],
)

load("@rules_rust//rust:repositories.bzl", "rules_rust_dependencies")
rules_rust_dependencies()

# 导入 crates.io 依赖(Bazel 也可以拉 Rust 的包)
load("@rules_rust//crate_universe:defs.bzl", "crates_repository")

crates_repository(
    name = "crates_index",
    cargo_lockfile = "//:Cargo.lock",  # 复用 Cargo.lock
    manifests = ["//:Cargo.toml"],
)
# BUILD.bazel —— 定义构建目标(每个目录一个 BUILD 文件)
load("@rules_rust//rust:defs.bzl", "rust_binary", "rust_library", "rust_test")

# 定义 Rust 库
rust_library(
    name = "my_lib",
    srcs = ["src/lib.rs"],
    deps = [
        "@crates_index//:tokio",    # 引用外部 crate
        "@crates_index//:serde",
    ],
    visibility = ["//visibility:public"],  # 控制可见性
)

# 定义 Rust 二进制
rust_binary(
    name = "my_service",
    srcs = ["src/main.rs"],
    deps = [
        ":my_lib",                   # 引用同项目的库
        "//proto:greeter_rust_proto", # 引用 Protobuf 生成的 Rust 代码
        "@crates_index//:tonic",
    ],
)

Bazel 的真正威力在多语言项目中体现:

# proto/BUILD.bazel —— 一个目录同时管理多种语言的生成代码
load("@rules_proto//proto:defs.bzl", "proto_library")
load("@rules_rust//proto:defs.bzl", "rust_proto_library")

# Protobuf 定义(语言无关)
proto_library(
    name = "greeter_proto",
    srcs = ["greeter.proto"],
    visibility = ["//visibility:public"],
)

# 自动生成 Rust 代码
rust_proto_library(
    name = "greeter_rust_proto",
    deps = [":greeter_proto"],
)

# 自动生成 Python 代码
load("@rules_python//python:defs.bzl", "py_proto_library")
py_proto_library(
    name = "greeter_py_proto",
    deps = [":greeter_proto"],
)

三、核心取舍对比

我把两种构建系统在大型项目中的关键差异总结如下:

维度CargoBazel大项目影响
学习曲线低(30 分钟入门)高(需要学 Starlark、BUILD 语法)团队培训成本
配置复杂度Cargo.toml 一个文件WORKSPACE + 每个目录 BUILD.bazel维护负担
增量编译自动(crate 粒度)精确(文件级别,更细粒度)CI 时间
分布式缓存需要 sccache内建 Remote Cache + Remote Execution编译速度
多语言支持仅 RustRust/C++/Python/Java/Go/Proto…跨语言项目必需
外部依赖crates.io (版本好管理)需要手动声明或通过 crate_universe依赖管理复杂度
IDE 支持rust-analyzer 完美需要生成 Cargo.toml 代理开发体验
CI 集成简单(cargo test)复杂(bazel 配置 + 缓存服务)CI 维护成本

四、什么时候该切换到 Bazel?

我的判断标准很简单,满足以下任意两条就应该考虑 Bazel:

  1. 项目超过 3 种编程语言:如果你在写 Rust 服务 + C++ FFI + Python 脚本 + Protobuf 定义,Cargo 管不了这些。
  2. 团队超过 10 个开发者:Bazel 的可见性控制(visibility)、构建目标粒度和缓存共享对于大团队更有价值。
  3. CI 编译时间超过 10 分钟:Bazel 的分布式缓存(Remote Cache)可以让第二次及以后的全量构建变成几乎即时的。
  4. 单仓库(monorepo)中有多个独立服务:Bazel 的精确依赖分析能确保"只重新编译真正需要的东西"。

如果你只是一个 Rust 项目,没有其他语言,团队不超过 5 个人,别折腾 Bazel——Cargo 完全够用,换 Bazel 反而会增加维护负担。

实际项目中,如果你已经用 Cargo 开发了一段时间想迁移到 Bazel,可以借助 rules_rust 的 crate_universe 直接读取现有的 Cargo.toml 和 Cargo.lock,减少迁移成本:

# 直接读取 Cargo.toml 中的依赖,生成 Bazel 的 BUILD 文件
crates_repository(
    name = "crates_index",
    cargo_lockfile = "//:Cargo.lock",
    manifests = ["//:Cargo.toml", "//sub_crate:Cargo.toml"],
)

实际迁移时还踩过一个坑:crate_universe 生成的 BUILD 文件不包含 build.rs 的编译产物,导致依赖 OpenSSL 的 crate 在 Bazel 下直接编译失败,需要手动补 cargo_build_script 规则。

五、总结

  1. Cargo——Rust 专属、简单直观、生态完善。纯 Rust 项目首选。
  2. Bazel——多语言、增量精确、分布式缓存。大团队多语言项目的最佳选择。
  3. 迁移成本——如果未来可能上 Bazel,建议一开始就把 Cargo.toml 和目录结构调整好,减少后续迁移的工作量。
  4. 混合使用——也可以在 Bazel 项目中让 Bazel 管理外部依赖,内部 Rust 代码继续用 cargo build 开发(通过 Bazel 的 genrule 桥接)。

作为程序员,接触 Bazel 的过程确实比 Cargo 痛苦很多——Starlark 语法、WORKSPACE 配置、BUILD 文件规则……每一个概念都值得专门写一篇文章。但理解了它的设计理念后,不得不承认:在大型多语言项目中,Bazel 的复杂度是有道理的,因为它解决的问题本身就是复杂的。

Rust:专属的cargo工具介绍 Cargo 是 Rust 的构建系统和包管理器。Rust 开发者常用 Cargo 来管理 Rust 工程和获取工程所依赖的库。在上个教程中我们曾使用 cargo new greeting 命令创建了一个名为 greeting 的工程,Cargo 新建了一个名为 greeting 的文件夹并在里面部署了一个 Rust 工程最典型的文件结构。这个 greeting 文件夹就是工程本身。 阅读详情

相关推荐

Rust项目构建与管理:深入理解Cargo

本文还有配套的精品资源,点击获取 简介:Cargo是Rust编程语言的核心构建系统,负责依赖管理、编译、测试和打包等。本文详细介绍了Cargo的工作原理、子命令、插件以及如何在持续集成和部署(CI/CD)中应用。了解Cargo对于Rust开发者而言是不可或缺的,它使得构建和管理Rust项目变得更加高效和标准化。 1. Cargo作为Rust的标准构建系统 1...

weixin_42497762的博客 2828

Rust之Cargo构建、运行、调试

的工程,Cargo 新建了一个名为 helloworld 的文件夹并在里面部署了一个 Rust 工程最典型的文件结构。调试程序的方法与其它环境相似,只需要在行号的左侧点击红点就可以设置断点,在运行中遇到断点会暂停,以供开发者监视实时变量的值。为该工程的配置文件,这个关系类似于: package.json 是 npm 的配置文件。Cargo是rustup安装后自带的,Cargo 是 Rust 的构建系统和包管理器。是编译后的文件目录。

write less , do more 7117

Frenet坐标系下动态街道场景的最优轨迹生成

本文详细解读了Lattice Planner

BigDavid123的博客 2394

学习笔记一—— Rust 包管理神器 Cargo 全面详解

Rust 之所以被称为“工程师的语言”,是因为它把代码质量和工程实践融合得非常深入,而Cargo 就是这种理念的体现。如何用 Cargo 创建、运行、管理项目Cargo.toml和Cargo.lock的作用与区别如何使用features做功能开关如何通过workspace组织大型项目构建优化(debug/release)常见命令操作。

pumpkin84514的博客 2788

小米手机Magisk解锁与Root完整指南:从Bootloader到模块管理

Android系统Root权限获取是设备深度定制的核心技术之一,其核心原理在于通过修改系统启动流程获取超级用户权限。Systemless Root技术通过动态挂载修改,在不触碰系统分区的前提下实现功能注入,既保证了系统完整性,又能绕过完整性检测。这一技术为设备带来了极高的可定制性,用户可以通过模块化方式增强系统功能、修改UI界面或启用隐藏特性。在小米手机生态中,由于官方提供了完整的Bootloader解锁通道,结合Magisk的无系统修改Root方案,使得安全可控的深度定制成为可能。本文聚焦于Bootloa

weixin_29164185的博客 339

ThingsKit物联网平台产品管理之物模型

物模型是ThingsKit物联网平台为产品定义的数据模型,用于描述产品的功能。本文介绍物模型相关概念和使用限制。

云腾五洲官方博客 1175

Cargo调度器原理与Rust构建优化实践

构建系统的调度器决定了并行任务的执行顺序、资源分配与失败处理,是影响编译效率的核心机制。在Rust工程中,Cargo调度器借助依赖图、fingerprint和jobserver令牌机制协调多个编译单元,避免重复计算并控制并行度。理解它的默认行为,才能避免盲目调高并行度导致内存耗尽,或忽略长尾crate拖慢整体构建。合理利用sccache缓存、精确设置构建作业数、拆分workspace以及分析任务日志,可以在不依赖单一编译速度提升的前提下显著缩短构建时间。从本地开发到CI生产环境,掌握调度器的资源感知与排队逻

weixin_33928137的博客 365

基于matlab版本的三维直流电法反演算法

可以使用RESINVM3D工具包等现成的MATLAB工具进行三维直流电法反演。反演问题求解:基于MATLAB的反演问题求解算法实现和应用,包括反演问题数值模拟、反演问题参数优化和反演问题结果分析。希望这个代码示例能帮助你入门三维直流电法反演。如果有更具体的需求或问题,可以进一步探讨。反演过程中可能需要调整正则化参数和优化算法的设置。需要根据实际问题实现,可能涉及复杂的数值计算。

ytttr873的博客 671

Cargo调度器深度解析:原理、性能瓶颈与优化实战

Cargo作为Rust官方构建系统的核心,其内部调度器负责在依赖图中规划任务执行顺序,决定并行构建的效率与稳定性。理解任务图、并行度控制等基础原理,是优化大型workspace编译时间的重要前提。而在实际工程中,cargo metadata常作为外部工具与Cargo交互的桥梁,频繁出现在CI、IDE及构建脚本中,其报错信息如failed to run 'cargo metadata'常阻断整个构建流程。本文从调度器核心机制出发,结合--timings分析调度瓶颈,并引入sccache、链接器替换及依赖结构调

weixin_33782386的博客 413

AntV G6避坑指南:折叠树状图那些意想不到的BUG(附解决方案)

本文深入剖析了在React项目中使用AntV G6实现折叠树状图时,从图标错乱、数据同步到状态管理的常见BUG与解决方案。文章基于实战经验,详细解读了G6的内部机制,提供了从环境配置、自定义节点绘制到事件处理与性能优化的完整避坑指南,帮助开发者彻底解决折叠展开功能的疑难杂症。

wasm7browser的博客 259

mjlab 入门教程(一)MuJoCo 人形机器人强化学习训练 sim-to-real 部署框架

摘要:mjlab是一个结合IsaacLab API与MuJoCo简洁性的GPU加速机器人仿真框架,专为强化学习和机器人研究设计。它提供快速安装(支持uv、pip、conda和Docker)、核心功能(域随机化、NaN守护、观测历史/延迟、执行器/传感器系统)以及从IsaacLab的迁移指南。相比IsaacLab,mjlab更轻量、启动更快,直接构建在MuJoCo Warp上,避免了Omniverse开销。其哲学强调裸机性能、开发者体验和核心领域专注,适合需要快速迭代和直接MuJoCo控制的用户,而Isaac

2506_90492529的博客 2729

Skia 的 Bazel 构建体系:bazel/external 目录如何组织第三方依赖

本文以 [bazel/external/README.md](https://link.gitcode.com/i/710f372c06f36d216888ef1d651689b0) 为骨架,结合 [WORKSPACE.bazel](https://link.gitcode.com/i/03efe03459f18d479f5aacbd132e6ddb) 与 [bazel/deps.bzl](htt

gitblog_01104的博客 202

基于ESP32的智能停车场管理系统开发

智能停车场管理系统通过引入物联网(IoT)技术,实现对停车场内车辆的实时监控、空闲车位的管理、车辆的入场与出场控制等功能,大大提高了停车场的利用率和管理效率。通过集成物联网技术、云平台以及先进的传感器和执行器,系统不仅能实时监控停车场的车位状态,还能提供更好的用户体验。本文将介绍如何基于ESP32开发一个智能停车场管理系统,涵盖系统架构、硬件选择、软件开发以及最新技术的应用,帮助开发者实现高效的智能停车管理。ESP32的代码主要负责处理车位传感器的数据,控制LED指示灯的状态,以及与云平台进行数据交互。

2201_76125393的博客 915

Comprehensive Rust 课程中的泛型(Generics)系统指南:从泛型函数到 `dyn Trait` 动态分发

本篇基于 Google Android 团队 Rust 课程([comprehensive-rust](https://link.gitcode.com/i/4228773ee743d983546f6e24b8235efb))的 `src/generics.md` 章节整理而成。该章节覆盖 Rust 泛型的完整知识链:泛型函数、泛型数据类型、泛型 trait、trait 约束、`impl Trai

gitblog_00368的博客 1396

用 deepseek 写小说(通用版提示词模板)

#Initialization:作为[Role],在[Goals]下,回顾你的[Skill],严格遵守[Constraints],5.第五步:人物大纲,给小说里的每个人物撰写背景故事,深挖人物过去的经历,原生家庭,住所:一栋位于市郊的房子,有三个卧室,房龄 10 年,厨房很大,当中有一个鸟式大理石。示例 2.戈德里洛克先去了熊老爹的工作坊,尝试用大纲法写作,却发现这种方法无聊透顶,1.第一步:一句话概括,一句话概述小说内容,主要包含小说癸型,主角,以及故事中需要。大灰狼的暴行彻底激怒了戈德里洛克,

陈奕昆的博客 2985

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

Ghidra 软件逆向实战:从导入二进制到批量反编译 C 代码的完整操作路径

Ghidra 是 NSA 开源的软件逆向工程(SRE)框架,它要解决的问题只有一个:把没有源码的二进制文件还原成你能读懂的代码——反汇编、反编译、调试、批量处理全部内置,且完全免费。本文写给第一次接触 Ghidra 的开发者,读完你能独立走完"环境搭建 → 导入样本并自动分析 → 反编译出 C 伪代码 → 用命令行和脚本批处理整个目录"的全流程。 读完你能做到: - 会从零克隆源码并用 Gra

gitblog_01048的博客 287

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

protobuf Rust 官方运行时 crate 详解:V4 浅层包装架构、upb/C++ 双内核与 protoc 版本匹配规则

本文围绕官方 Google Rust Protobuf 实现的运行时 crate `protobuf`(位于 `rust/release_crates/protobuf/`)展开,解析其 V4 版本"对 `google_protobuf` crate 的浅层再导出"这一核心架构、upb 纯 C 内核与 C++ 内核的选择机制,以及 Rust protobuf 与 protoc 二进制之间严格的版本

gitblog_00379的博客 347

Outlook Express 6 (OE6) for Win7/Win8/Win10

英文版 Outlook Express6.0, 兼容Win7/Win10/WinXP,解压就可用。

Comprehensive Rust 教程:深入理解 `for` 循环与 Rust 的迭代机制

`for` 循环是 Rust 控制流体系中最常用、也最具 Rust 风格的循环结构:它既能遍历数值区间(range),也能遍历数组、切片、`Vec` 等集合。本文以 Google Android 团队维护的开源课程 Comprehensive Rust 中 [for 循环](https://link.gitcode.com/i/0e4fca7ae6ff19fba19c3350cf8bc689) 一

gitblog_00651的博客 969

Aeneas外部依赖建模教程:rust_fun属性与extract-lean-std完全指南

本文面向 Aeneas(Rust 程序形式化验证工具链)的新手用户,完整讲解如何为外部依赖(如 Rust 标准库函数)建立数学模型:从 `-split-files` 生成模板,到用 `rust_fun` 属性注册 Lean 模型,最后运行 `make extract-lean-std` 命令将模型信息回灌到 Aeneas 翻译器中。掌握这套流程后,你就可以验证任何依赖标准库的 Rust crate

gitblog_00862的博客 779

OR-Tools 完整指南:Google 运筹优化工具箱如何帮你搞定调度、路由与线性规划问题

OR-Tools 是 Google 开源的组合优化工具箱,核心功能是用内置的约束规划(CP-SAT)、线性规划(Glop/PDLP)与图算法求解器,把排班、配送路线、资源分配这类"组合爆炸"问题变成一段可执行的建模代码。它用 C++ 实现核心引擎,同时提供 Python、Java、.NET 封装,Apache 2.0 许可,商业项目可以放心使用。 ## 它解决的到底是什么问题 现实业务里有一类

gitblog_00396的博客 805

Tock Core Working Group 2022-02-11 会议纪要解读:libtock-rs 稳定 Rust 迁移、TAB 命名问题与内核稳定化路线

本文基于 [doc/wg/core/notes/core-notes-2022-02-11.md](https://link.gitcode.com/i/3b0282fdac4c185129b6efe9fe00c48a) 这份 Tock 核心工作组(Core Working Group)的周会纪要展开,系统梳理当次会议围绕 libtock-rs 稳定 Rust 迁移、Tockloader/elf2

gitblog_01017的博客 814

如何获取网盘直链:网盘直链下载助手完整使用指南

网盘直链下载助手(LinkSwift)是一款开源油猴脚本:只要浏览器里登录着网盘网页,它就能在本地把选中文件的真实下载地址解析出来。支持百度网盘、阿里云盘、中国移动云盘、天翼云盘、迅雷云盘、夸克网盘、UC 网盘、123 云盘共 8 个平台,全程本地解析、无第三方中转,适合想把文件交给 IDM、Aria2 等下载器后台拉取的场景。 ## 为什么值得装一个本地解析脚本 这一节能帮你判断它是否符合你

gitblog_00020的博客 508

开源游戏大全:从找到 100+ 款开源游戏到提交第一个 PR 的完整路线

找不到能玩的开源游戏,或者想找 Doom、Quake 这类商业经典的开源重制版却不知从何下手?open-source-games 就是干这事的:一份按类型分好类的清单,收录上百款开源电子游戏和经典商业游戏的开源重制版本,每条都带源码仓库链接,你只管逛清单,再顺链接出门玩。仓库本身非常轻量,总共只有 4 个文件。 ## 三个一句话结论:open-source-games 是个什么东西 - **结

gitblog_00700的博客 359

Qwen3-TTS 语音克隆实战:3秒录音复刻声音的完整路径

给视频旁白换成自己的声音,常规做法往往要录大量素材再训练。Qwen3-TTS 把语音克隆压缩到 3 秒:Base 模型吃进一段 3 秒左右的参考音频,就能零样本复刻说话人音色,再用这个声音合成任意新文本;全系列覆盖中、英、日、韩等 10 种语言,流式输出时端到端延迟最低 97ms。本文不按"介绍—上手"的套路走,而是按三个真实场景展开:浏览器零代码体验、单条声音克隆、整剧批量配音,最后给一张常见坑

gitblog_00621的博客 222

Open Interpreter 的 codex-git-utils:git 补丁应用与可重置基线 diff 机制深度解析

本文以 `codex-rs/git-utils` 这个 Rust crate 为主体,解析 Open Interpreter 编码代理中"让模型安全地修改代码"背后的 git 基础设施:如何把模型产出的 unified diff 通过 `git apply --3way` 落到工作区并解析出结构化结果,以及一套把 git 当作"可重置 diff 机制"来用的轻量基线 API(`ensure_git

gitblog_00776的博客 479

macOS 15 arm64 GitHub Actions Runner 镜像软件清单全解析:版本明细、工具链构成与镜像构建原理

macOS 15(Sequoia)arm64 是 GitHub Actions 面向 Apple Silicon 架构的托管运行器镜像,本文基于仓库中的 [macos-15-arm64-Readme.md](https://link.gitcode.com/i/d281e4f71fd8ab871ecc3dfa8e7c1d4b) 完整梳理该镜像的软件构成,并结合 [macOS-15.arm64.an

gitblog_00830的博客 214
上一篇: AI Agent 请求合并:多个用户问类似问题,怎么复用一次模型调用
下一篇: Rust AI CLI 的网络层优化:连接池、HTTP/2 和请求合并的关键技术
第一程序员
博客等级 码龄1年 1万+粉丝 1827原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值