如何优雅地抽离 Rust 子工程：以 rumqttd 为例

Pomelo_刘金2025-09-15 16:50

下载工具git-filter-repo

python 复制代码

# macOS
brew install git-filter-repo
# Debian/Ubuntu
sudo apt-get install git-filter-repo
# or via pip
pip install git-filter-repo

克隆上游裸仓库

bash 复制代码

git clone --mirror https://gitlab.com/rumqtt/rumqttd.git rumqttd.git
cd rumqttd.git          # 注意：裸仓库，无工作区

裸仓库能一次带下所有分支 / tag，且速度快。

过滤：只保留子目录并"脱壳"（只保留需要的目录，脱壳）

css 复制代码

# ① 仅保留 rumqttd/src 和 Cargo*，其它全部丢弃
# ② 把 rumqttd/ 这一层目录去掉（即 rumqttd/src/foo.rs 变成 src/foo.rs）
git filter-repo \
  --path rumqttd/src \
  --path rumqttd/Cargo.toml \
  --path rumqttd/Cargo.lock \
  --path-rename rumqttd/:

从刚才裁剪后的裸仓库再克隆出一个"普通仓库"

你当前在 work/ 目录,而不是刚才的 rumqttd.git

bash 复制代码

 
git clone rumqtt.git rumqttd-lite          # 目录名随意
cd rumqttd-lite

看看有哪些分支，HEAD 通常已经指向 main

css 复制代码

git branch -a

如果 HEAD 不是 main，可手动

css 复制代码

git checkout main

添加新的远程（GitHub / GitLab 皆可）

bash 复制代码

# 如果要推到内部 GitLab，就把 URL 换成对应地址
git remote add origin git@github.com:someone/rumqttd.git

一次性推送所有分支 + tag

perl 复制代码

git push --all origin     # 推送分支
git push --tags origin    # 推送标签
# 或者直接   git push --mirror origin   (连同 refs/notes 等一起推)