rust

コミュニティ向け Rust のベストプラクティス

Rust アプリケーションの包括的なパフォーマンス最適化ガイドです。8 つのカテゴリにまたがる 42 個のルールを、影響度の高い順に掲載し、自動リファクタリングとコード生成の指針を示します。

適用するタイミング

次の場合に、これらのガイドラインを参照してください。

• 新しい Rust コードを書くとき
• メモリ割り当てと所有権のパターンを最適化するとき
• イテレーターやコレクションを扱うとき
• Tokio やその他のランタイムを使って非同期コードを書くとき
• パフォーマンス上の問題がないかコードをレビューするとき

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	メモリ割り当て	CRITICAL	mem-
2	所有権と借用	CRITICAL	own-
3	データ構造の選択	HIGH	ds-
4	イテレーターとコレクションのパターン	HIGH	iter-
5	非同期処理と並行処理	MEDIUM-HIGH	async-
6	アルゴリズムの計算量	MEDIUM	algo-
7	コンパイル時の最適化	MEDIUM	comp-
8	マイクロ最適化	LOW	micro-

クイックリファレンス

1. メモリ割り当て（CRITICAL）

• mem-avoid-unnecessary-clone - 不要な clone 呼び出しを避ける
• mem-preallocate-vec-capacity - Vec の容量を事前に確保する
• mem-use-cow-for-conditional-ownership - 条件付きの所有権には Cow を使う
• mem-use-arc-for-shared-immutable-data - 共有する不変データには Arc を使う
• mem-avoid-format-for-simple-concatenation - 単純な連結には format! を使わない
• mem-use-smallvec-for-small-collections - 小規模なコレクションには SmallVec を使う

2. 所有権と借用（CRITICAL）

• own-accept-str-slice-not-string - &String ではなく &str を受け取る
• own-accept-slice-not-vec - &Vec ではなく &[T] を受け取る
• own-use-into-for-flexible-ownership - 柔軟な所有権のために Into を使う
• own-return-borrowed-when-possible - 可能であれば借用データを返す
• own-use-asref-for-generic-borrows - ジェネリックな借用には AsRef を使う

3. データ構造の選択（HIGH）

• ds-use-hashset-for-membership - メンバーシップの判定には HashSet を使う
• ds-use-hashmap-for-key-lookup - キーと値の検索には HashMap を使う
• ds-use-btreemap-for-sorted-iteration - ソート順のイテレーションには BTreeMap を使う
• ds-use-vecdeque-for-queue-operations - キュー操作には VecDeque を使う
• ds-use-entry-api-for-conditional-insert - 条件付き挿入には Entry API を使う

4. イテレーターとコレクションのパターン（高）

• iter-chain-instead-of-intermediate-collect - 中間で collect せず、イテレーターをチェーンします
• iter-use-iter-over-into-iter-when-borrowing - 借用する場合は into_iter() ではなく iter() を使用します
• iter-use-filter-map-for-combined-operations - 複合操作には filter_map を使用します
• iter-use-flat-map-for-nested-iteration - ネストした反復処理には flat_map を使用します
• iter-use-extend-for-bulk-append - 一括追加には extend() を使用します
• iter-use-fold-for-accumulation - 複雑な累積処理には fold() を使用します

5. 非同期処理と並行処理（中〜高）

• async-avoid-blocking-in-async-context - 非同期コンテキストでブロッキングを避けます
• async-use-join-for-concurrent-futures - 並行するフューチャーには join! を使用します
• async-use-rwlock-over-mutex-for-read-heavy - 読み取りが多い場合は Mutex ではなく RwLock を使用します
• async-minimize-lock-scope - ロックのスコープを最小限にします
• async-use-buffered-for-bounded-concurrency - 並行処理数を制限するには buffered() を使用します
• async-avoid-holding-lock-across-await - await をまたいでロックを保持しないようにします

6. アルゴリズムの計算量（中）

• algo-avoid-nested-loops-for-lookup - 検索にネストしたループを使用しないようにします
• algo-use-binary-search-for-sorted-data - ソート済みデータには二分探索を使用します
• algo-use-sort-unstable-when-order-irrelevant - 順序が重要でない場合は sort_unstable を使用します
• algo-use-select-nth-unstable-for-partial-sort - 部分ソートには select_nth_unstable を使用します
• algo-use-chunks-for-batch-processing - バッチ処理には chunks() を使用します

7. コンパイル時の最適化（中）

• comp-use-const-for-compile-time-computation - コンパイル時の計算には const を使用します
• comp-prefer-static-dispatch - 動的ディスパッチより静的ディスパッチを優先します
• comp-reduce-monomorphization-bloat - モノモーフィゼーションによる肥大化を抑えます
• comp-use-const-generics-for-array-sizes - 配列サイズには const ジェネリクスを使用します
• comp-avoid-repeated-parsing-of-static-data - 静的データの解析を繰り返さないようにします

8. マイクロ最適化（低）

• micro-use-inline-for-small-functions - 小さく、実行頻度の高い関数には inline 属性を適用します
• micro-avoid-bounds-checks-in-hot-loops - 実行頻度の高いループで境界チェックを避けます
• micro-use-wrapping-arithmetic-when-safe - 安全な場合はラッピング演算を使用します
• micro-use-byte-literals-for-ascii - ASCII にはバイトリテラルを使用します

使用方法

詳しい説明とコード例については、各リファレンスファイルをお読みください。

• セクションの定義 - カテゴリー構成と影響度レベル
• ルールのテンプレート - 新しいルールを追加するためのテンプレート

コンパイル済みドキュメントの全文

すべてのルールを1つのドキュメントにまとめた包括的なガイドについては、AGENTS.mdをご覧ください。

参照ファイル

ファイル	説明
AGENTS.md	すべてのルールをまとめた完全なガイド
references/_sections.md	カテゴリーの定義と並び順
assets/templates/_template.md	新しいルール用のテンプレート
metadata.json	バージョンと参照情報