CからRustへの移行ガイドブック
The C to Rust migration book (mainmatter.com)
要約
Mainmatter社は、C言語のコードベースをRustに安全かつ段階的に移行するためのガイドブックを公開しました。この書籍では、CとRustの混在コードベースの維持、クリーンなAPIの設計、一般的なCのイディオムを慣用的なRustに翻訳する方法など、実践的なテクニックを学ぶことができます。メモリ安全性や信頼性の向上が求められる現代において、既存のCコードをRustにモダナイズしようとする開発者にとって貴重なリソースとなります。
全文翻訳
世界を壊すことなくCからRustへ移行する
ソフトウェアのセキュリティ確保と近代化は、今日の最優先事項です。技術的負債とメモリ安全性のバグは、依然として脆弱性の最大の原因であり、そのためチームは信頼性とメモリ安全性を持つRustへとますます移行しています。しかし、書き直しは困難で恐ろしく、多くのリスクを伴います。Mainmatterは、世界で最も重要なソフトウェアの一部を正常に近代化するクライアントを支援した経験を、この書籍にまとめました。
自己完結型のライブラリをゼロから書き直す場合でも、変化し続ける大規模で複雑なコードベースを段階的に移行する場合でも、この書籍は成功するためのテクニックを教えてくれます。安全なCとRustの混在コードベースを維持する方法、クリーンなAPIを設計・構造化する方法、一般的なCのイディオムを慣用的なRustに翻訳する方法を学びます。
CからRustへの移行に関する書籍
[画像: C to Rust migration books]
このコースは、自己ペースの演習という私たちの哲学を中心に構築されています。各概念には、実際のRustパッケージで解決する演習がペアになっており、そのソリューションをチェックするテストスイートが用意されています。
Rustの事前知識とCのいくらかの知識を前提としています。FFIの事前知識は不要です。それはこのコースで教えられることです。
最終的には、生産的な方法でCコードベースにRustを導入できるようになるでしょう。
目次
1
外部関数インターフェース
FFIの基本:CとRustがC ABI、シンボルテーブル、リンカを通じてバイナリレベルでどのように通信するか。手動で最初のextern "C"ブロックを記述し、バインディングを宣言する際にコンパイラに何を約束しているのか、そしてシグネチャが一致しない場合に何が起こるのかを確認します。
2
境界を越える型とデータ
所有権を明確に保ちながら、プリミティブ値、文字列、構造体、コレクションを言語境界を越えて移動させる方法。bindgenを使用してCヘッダーからRustバインディングを生成し、逆方向のツールであるcheadergenを使用してRustコードからCヘッダーを生成し、両方を非自明な型のために設定します。
3
FFIセーフな型
生のポインタと型指定のないプリミティブは、FFI境界におけるバグの主要な原因です。より安全な代替手段を学びます:NonNull、Option、newtypeラッパー、値ではなく意味を持つenumディスクリミネータ、そして独自の型安全性を持たないCコードと通信する場合でも無効な状態を表現不可能にする型を設計する方法。
4
FFI検証
すべてのFFI関数は信頼の境界です。Cの呼び出し元はnullポインタ、範囲外の値、または無効なUTF-8を渡す可能性があり、Rustはコンパイル時にそれを検出できません。境界で入力を検証および絞り込む規律を構築し、Cからの無効なデータが安全なRustやビジネスロジックに到達しないようにします。
5
エラーハンドリングとAPI設計
RustのResultと?はextern "C"で停止します。Rustのエラー型を、エラーコードenumとアウトパラメータを使用してC互換の結果に変換し、Rustの内部を漏らすことなく失敗情報を表面化します。また、フィールドごとのセッターではなく、粗い操作を公開し、APIサーフェスを小さく保つ方法も学びます。
6
本番品質のFFI
FFI関数をRustの/// # Safety規約と番号付きの不変条件で文書化し、すべてのunsafeな契約を明示的にし、cheadergenを通じて生成されたヘッダーにCのドキュメントコメントとして表面化させます。ビルド統合、自動チェック、そしてFFIサーフェスを永遠に維持するAPIとして扱うことについて説明します。
著者について
Jonas Kruckenbergは、次世代コンピューティングインフラストラクチャに焦点を当てたシステムエンジニアおよびテクノロジストです。彼は、実験的な高信頼性オペレーティングシステムであるk23の主任著者です。TC39の招待専門家として、ブラウザ以外の視点をJavaScript言語標準化にもたらすことで、Webの未来を形作ることに貢献しています。
Mainmatterは、Rustを専門とするエンジニアリングコンサルティング会社です。CからRustへの移行や、既存のコードベースへのRust導入を目指す企業に、エンジニアリングサービス、トレーニング、メンターシップを提供しています。
[画像: EuroRust 2026 logo]
コミュニティ
EuroRust 2026
EuroRustは、Rustに関するあらゆるもののための2日間のカンファレンスで、さらに2日間のサイドアクティビティ、ワークショップ、ハッカソンがあります。10月にバルセロナでお会いしましょう。