Rust cargo build を使いこなす：ビルド高速化とバイナリ最適化の実践手法

Rustを用いた開発において、コンパイル時間の長さは多くの開発者が直面する課題の一つです。

しかし、RustのビルドシステムであるCargoを正しく理解し、適切に設定することで、開発のイテレーション速度を劇的に向上させることが可能です。

また、最終的な実行バイナリのサイズ軽量化や実行速度の最適化も、cargo buildのオプションや設定次第で大きな差が生まれます。

本記事では、2026年現在の最新の知見に基づき、ビルド高速化とバイナリ最適化の両面に焦点を当てた実践的なテクニックを詳しく解説します。

cargo buildの基本動作とプロファイルの理解

Rustプロジェクトをビルドする際、最も頻繁に利用するのがcargo buildコマンドです。

このコマンドは、デフォルトではデバッグプロファイルを使用してコンパイルを行います。

デバッグプロファイルでは、コンパイル速度を優先し、デバッグ情報を含める一方で、コードの最適化は最小限に抑えられます。

対照的に、本番環境向けのバイナリを作成する場合はcargo build --releaseを使用します。

リリースプロファイルでは、コンパイラが高度な最適化を行い、実行速度が最大化されますが、その分コンパイル時間は大幅に増加します。

これらの中間的な設定や、特定の用途に合わせた設定を行うために、RustではCargo.toml内でプロファイルをカスタマイズできます。

# Cargo.toml の例

[profile.dev]

opt-level = 0 # 開発時は最適化をオフにしてビルドを速くする

[profile.release]

opt-level = 3 # リリース時はフル最適化を適用 lto = true # リンク時最適化を有効化

ビルド高速化のための実践的手法

Rustのビルド時間を短縮するためには、コンパイラの負荷を減らすアプローチと、ハードウェアリソースを効率的に活用するアプローチの2種類があります。

リンカの変更による高速化

Rustのコンパイルプロセスにおいて、多くの時間を占めるのが「リンク」の工程です。

標準のリンカの代わりに、より高速なリンカを採用することで、インクリメンタルビルドの時間を数秒単位で短縮できます。

特にLinux環境では、moldというリンカが圧倒的な速度を誇ります。

macOSやWindowsでは、LLVMプロジェクトのlldを使用するのが一般的です。

これらを使用するには、.cargo/config.tomlに以下の設定を追加します。

# .cargo/config.toml

[target.x86_64-unknown-linux-gnu]

rustflags = [“-C”, “link-arg=-fuse-ld=mold”]

[target.x86_64-apple-darwin]

rustflags = [“-C”, “link-arg=-fuse-ld=lld”]

リンカを変更するだけで、大規模プロジェクトにおけるリンク時間が半分以下になるケースも珍しくありません。

コンパイルキャッシュの活用（sccache）

複数のプロジェクトを並行して開発している場合や、CI/CD環境において、sccacheを導入することは非常に効果的です。

これは、コンパイル結果をキャッシュし、同一のソースコードが再度コンパイルされるのを防ぐツールです。

インストール後、環境変数に設定するだけで利用可能です。

# sccacheのインストール例
cargo install sccache

# 環境変数の設定
export RUSTC_WRAPPER=sccache

これにより、cargo cleanを実行した後でも、過去にビルドした依存ライブラリの再コンパイルをスキップできるため、ビルド環境のクリーンアップが頻繁に発生する現場では必須のツールと言えます。

依存関係のビルド最適化

プロジェクト自体のコードは頻繁に変更されますが、外部ライブラリ（依存関係）はそれほど頻繁には変わりません。

しかし、cargo buildを実行すると、これら全てのチェックが行われます。

開発効率を高めるためには、cargo checkを積極的に活用しましょう。

これは実行バイナリを生成せず、型チェックのみを行うコマンドで、cargo buildよりも圧倒的に高速です。

コードを書きながらエラーを確認するフェーズでは、常にこちらを使用する癖をつけるべきです。

バイナリサイズと実行速度の最適化

本番環境へのデプロイを想定する場合、バイナリサイズを小さく保つことと、実行パフォーマンスを最大化することが求められます。

特にクラウドネイティブな環境や組み込みシステムでは、バイナリサイズはデプロイ効率に直結します。

LTO（Link Time Optimization）の活用

LTOは、クレートをまたいだ最適化を可能にする機能です。

通常、Rustはクレート単位でコンパイルを行いますが、LTOを有効にすると、リンク時にプロジェクト全体を俯瞰してデッドコードの削除やインライン化を行います。

Cargo.tomlでの設定例は以下の通りです。

[profile.release]
lto = "fat"
codegen-units = 1 # コード生成ユニットを1に制限して最適化効率を最大化

codegen-unitsを1に設定すると、並列ビルドができなくなるためコンパイル時間は大幅に伸びますが、生成されるコードの実行効率は最高レベルになります。

シンボル情報の削除（strip）

デフォルトのビルドでは、パニック時のバックトレースなどに必要なシンボル情報がバイナリに含まれています。

しかし、これらは商用利用において不要な場合が多く、削除することでファイルサイズを大幅に削減できます。

2026年現在では、Cargoの設定で簡単に指定可能です。

[profile.release]
strip = true # デバッグシンボルを自動的に削除

これにより、数MB単位でバイナリサイズが縮小することがあります。

パニック時の挙動変更

Rustの標準的な挙動では、パニックが発生するとスタックを巻き戻す（Unwinding）処理が行われます。

これには例外処理のためのメタデータが必要ですが、これを「即座にプロセスを終了する（Abort）」設定に変更することで、さらにバイナリを軽量化できます。

[profile.release]
panic = "abort"

この設定は、特にWebサーバーのバックエンドやマイクロサービスなど、プロセスが再起動されることを前提としたシステムにおいて、メモリフットプリントの削減とコードサイズの縮小に寄与します。

Cargoプロファイルの応用的な管理

プロジェクトの規模が大きくなると、単なる「dev」と「release」だけでは不十分な場合があります。

例えば、特定のテスト環境のみをリリース相当の速度で動かしたい場合や、プロファイリングを行うために最適化をかけつつデバッグ情報を残したい場合などです。

カスタムプロファイルの作成

Cargoでは独自のプロファイルを作成し、既存のプロファイルから設定を継承できます。

# プロファイリング専用のプロファイル

[profile.profiling]

inherits = “release” debug = true # リリース設定をベースにしつつデバッグ情報を保持

このプロファイルを使用してビルドするには、以下のコマンドを実行します。

cargo build --profile profiling

このように、用途に応じたビルド設定を定義しておくことで、開発チーム内でのビルド手順の統一と、実行環境の最適化が両立できます。

依存関係ごとの最適化レベル調整

特定の重いライブラリ（例えば暗号化ライブラリや画像処理ライブラリ）のみ、開発中であっても最適化をかけたい場合があります。

自作コードのビルドは速く保ちつつ、重い計算を伴うライブラリだけを高速に動作させることが可能です。

[profile.dev.package."*"]
opt-level = 2 # 全ての依存パッケージに適用

[profile.dev.package.bcrypt]

opt-level = 3 # 特定のパッケージだけを最大最適化

この設定により、デバッグビルド時の実行速度不足というRust開発でよくあるストレスを解消できます。

ターゲットアーキテクチャへの最適化

Rustはクロスコンパイルに強い言語ですが、特定のCPUアーキテクチャが持つ特殊な命令（AVX-512など）を活用するためには、明示的なフラグ指定が必要です。

特定のCPUに特化した最適化を行うには、RUSTFLAGSを利用します。

RUSTFLAGS="-C target-cpu=native" cargo build --release

target-cpu=nativeを指定すると、コンパイルを実行しているマシンのCPUで利用可能な全ての機能を活用するコードが生成されます。

汎用的なバイナリにはなりませんが、特定のサーバー上で最高のパフォーマンスを発揮させたい場合に非常に有効です。

ビルドプロセスの可視化と分析

どの部分がビルド時間を費やしているのか、あるいはどのライブラリがバイナリサイズを肥大化させているのかを知ることは、改善の第一歩です。

cargo-bloat によるサイズ分析

バイナリ内のどの関数やライブラリが容量を占有しているかを調査するには、cargo-bloatが便利です。

cargo bloat --release --n 20

実行結果には、サイズを占めている上位の項目が表示されます。

これにより、不必要にジェネリクスを多用してコードが膨張（コードブロート）している箇所などを特定できます。

cargo –timings によるビルド時間分析

Cargoには標準でビルド時間を可視化する機能が備わっています。

cargo build --timings

実行完了後、target/cargo-timings/report.htmlが生成されます。

これをブラウザで開くと、どのクレートのコンパイルに時間がかかったのか、並列化がどこでボトルネックになっているのかがグラフィカルに表示されます。

まとめ

Rustのcargo buildは、単にソースコードをバイナリに変えるだけの道具ではありません。

プロジェクトの性質に合わせて適切にカスタマイズすることで、開発者の生産性と実行プログラムの品質を同時に引き上げる強力な武器となります。

ビルド速度に悩む場合は、まず高速なリンカの導入とsccacheの検討を行ってください。

バイナリサイズや実行速度を極めたい場合は、Cargo.tomlでのLTO設定やシンボル削除、ターゲットCPUの指定を試みることが重要です。

これらのテクニックを駆使して、Rustの持つポテンシャルを最大限に引き出した効率的な開発フローを構築しましょう。