不使用cargo vendor如何手动为Rust项目添加离线依赖

• 直接从GitHub拉取的源码仓库不符合cargo的依赖识别要求：GitHub仓库通常包含开发配置、CI脚本、多版本工作区配置等非发布内容，且仓库默认分支代码往往和crates.io上发布的对应版本代码存在差异，直接复制会出现路径引用错误、配置不兼容问题。
• 手动搭建的vendor目录缺少cargo必需的元数据：标准vendor目录下每个依赖版本都对应专属的校验和配置文件，用来校验源码完整性、匹配版本映射关系，缺少这些文件哪怕目录名完全正确，cargo也会拒绝构建。
• 遗漏传递依赖处理：公开crate几乎都存在多层传递依赖，比如rand 0.8.5就依赖rand_core、rand_chacha、getrandom、ppv-lite86等多个下游crate，仅下载rand本身的源码完全无法完成构建。

方案1：本地注册表方案（适配绝大多数公开依赖场景，操作成本最低） #

这个方案不需要手动调整任何目录结构、手写配置元数据，所有解析逻辑由设备B上的cargo自动完成：

1. 在设备B上进入目标Rust项目根目录，执行cargo generate-lockfile生成完整的Cargo.lock文件，这个文件里会记录项目所有直接、间接依赖的精确名称和版本号，不需要手动梳理。
2. 把Cargo.lock里记录的所有依赖清单同步到设备A，逐个下载对应版本的官方.crate格式压缩包：这类包是cargo发布到crates.io的标准打包产物，内容和cargo vendor输出的对应版本源码完全一致。
3. 所有.crate包下载完成后，全部复制传输到设备B的固定存储目录，比如创建/data/rust-local-registry目录存放所有包。
4. 在项目根目录下创建.cargo/config.toml文件，写入以下配置，将cargo的依赖源替换为本地目录：

[source.crates-io]
replace-with = "local-registry"

[source.local-registry]
local-registry = "/data/rust-local-registry"

5. 配置完成后直接在项目根目录执行cargo build即可，整个构建过程不需要联网，cargo会自动从本地目录解析、校验所有依赖。

方案2：本地路径依赖方案（适配私有git依赖、非crates.io发布的依赖） #

如果你的依赖来自私有仓库、没有发布到crates.io，可以用这个方案：

1. 在设备A上克隆对应依赖的完整git仓库，切换到项目依赖对应的commit或tag版本，将整个仓库目录复制传输到设备B的固定存储路径。
2. 修改项目根目录下的Cargo.toml，将对应依赖的引用改为本地路径格式，示例：

# 原写法
# rand = "0.8.5"
# 改成本地路径引用
rand = { path = "/data/rust-deps/rand-0.8.5" }

3. 如果该依赖本身还有其他非crates.io的传递依赖，需要按相同方式逐个下载、配置路径，因此这个方案仅适合依赖数量较少的场景。

注意：不要尝试手动模拟cargo vendor生成的目录结构：vendor目录除了源码外，还需要为每个依赖版本生成专属的校验和文件，手动搭建很容易出现版本不匹配、校验失败的问题，稳定性远低于上述两种方案。

内容的提问来源于stack exchange，提问作者RobbyWobby