依存の深淵を覗く：Cargoメタデータでバイナリ肥大化を「外科手術」する技術
Rustのバイナリが肥大化する原因の9割は、あなたのコードではなく「依存関係の連鎖」にあります。`cargo build –release` を実行した際、なぜその巨大なライブラリがリンクされているのか。直感に頼った調査は時間の浪費です。
今日は、`cargo-metadata` を武器に、依存関係の構造を可視化し、バイナリサイズを最小化する「外科手術」の手法を伝授します。
—
1. なぜ「なぜ？」を突き止める必要があるのか
Rustのコンパイラである `rustc` は、非常に賢いですが、デフォルトでは「機能の全部盛り（Default Features）」を優先します。例えば、あるライブラリが `serde` を必要とすれば、そのライブラリが要求する機能が自動的に有効になり、芋づる式に巨大な依存ツリーが構成されます。
バイナリサイズを削減する第一歩は、「誰がその機能を有効にしたのか」という因果関係をメタデータから抽出することです。
隠れた依存を暴く `cargo-tree` の真の実力
まずは、標準的な `cargo tree` を使いつつ、特定のパッケージがどこから来ているのかをトレースします。
特定のクレートがどこから依存されているか、パスを可視化する
cargo tree -i
しかし、これだけでは不十分です。チームのCIでバイナリサイズを監視し、肥大化を即座に検知するには、`cargo-metadata` を解析して構造化データを扱う必要があります。
—
2. cargo-metadata を活用した依存関係のデータ解析
`cargo metadata –format-version 1` を実行すると、`Cargo.toml` や `Cargo.lock` に記述された情報の全てが JSON として出力されます。これを解析することで、特定のクレートがどの機能を有効にしているかをプログラム的に抽出できます。
実践：バイナリサイズ最適化のためのスクリプト戦略
以下のコマンドは、依存関係の中で「どのクレートが `default features` を有効にしているか」をリストアップし、不要なものを特定するための起点となります。
JSONでメタデータを取得し、jqで依存ツリーの構造を抽出する
cargo metadata –format-version 1 –no-deps | jq ‘.packages[] | {name: .name, features: .features}’
これに加え、CI/CDパイプラインに以下のチェックを導入することを推奨します。
- ルール: `default-features = false` を強制するクレートを管理する
- 手法: `cargo-deny` を用いて、許可リストにない巨大な依存の追加をビルド時にブロックする
—
3. バイナリサイズを劇的に削る `Cargo.toml` の構成術
無駄なコードのリンクを避けるための、プロレベルの設定です。`Cargo.toml` は単なる設定ファイルではなく、バイナリの設計図です。
[dependencies]
必要な機能だけを明示的に指定する（default-features = false）
serde = { version = “1.0”, default-features = false, features = [“derive”] }
[profile.release]
リンク時の最適化を強化
lto = “fat”
パニック時のスタックトレースを削除してサイズを縮小
panic = “abort”
コード生成の最適化レベルをサイズ優先にする
opt-level = “z”
冗長なシンボルを削除
strip = “symbols”
チームで共有すべき「開発効率向上」設定
チーム開発において「依存の肥大化」を未然に防ぐには、`.cargo/config.toml` をリポジトリに含め、ビルド設定を統一してください。
.cargo/config.toml
[build]
並列ビルドの最適化
jobs = 8
[target.x86_64-unknown-linux-gnu]
実行時のメモリフットプリントを最小化するための設定
rustflags = [“-C”, “target-feature=+crt-static”]
—
4. 現場で震えるほど役立つ神プラグイン・ツール3選
手作業での解析には限界があります。以下のツールを導入して、可視化の工数をゼロにしてください。
1. [cargo-bloat](https://github.com/RazrFalcon/cargo-bloat)
- 「バイナリのどの関数がどれだけのスペースを占有しているか」を教えてくれる魔法のツール。依存ライブラリの肥大化した関数を一撃で見抜けます。
- `cargo bloat –release -n 20` でトップ20の肥大関数を特定せよ。
2. [cargo-udeps](https://github.com/est31/cargo-udeps)
- 「使っていないのに `Cargo.toml` に書かれている依存」を検出します。これを消すだけでコンパイル時間が数秒〜数分短縮されます。
3. [cargo-chef](https://github.com/LukeMathWalker/cargo-chef)
- Dockerビルドにおいて、依存関係のみを事前にキャッシュする神ツール。CI/CDのビルド時間が劇的に短縮されます。
—
結論：コードを書く前に「構造」を見よ
優秀なエンジニアは、コードを書く前に依存関係のグラフを頭の中で、あるいはツールを使って描きます。`cargo-metadata` を活用して依存を制御下に置くことは、単なる「サイズ削減」ではありません。「自分のプロジェクトを完全にコントロール下に置く」という、シニアエンジニアとしての規律そのものです。
今日から `cargo bloat` を入れ、`Cargo.toml` の `default-features = false` を徹底してください。あなたのRustバイナリは、もっと速く、もっと小さく、もっと強くなれるはずです。