【Rust】Rust ~ cargoコマンド ~

◾️はじめに

前々から、cargoコマンド はどんなものがあるのか気になっていて

https://dk521123.hatenablog.com/entry/2025/12/11/234320

で「cargo new --lib」や「cargo search」とかが出てきたので、
これを機にまとめておく

目次

【0】主なcargoコマンド一覧
【1】基本的なコマンド
 1)cargo new
 2)cargo build
 3)cargo run
【2】コード整形系
 1)cargo check
 2)cargo fix
 3)cargo fmt
 4)cargo clippy
【3】補助系
 1)cargo doc
【4】その他
 1)cargo install / cargo uninstall
 2)cargo publish

【0】主なcargoコマンド一覧

https://doc.rust-jp.rs/book-ja/ch01-03-hello-cargo.html
https://doc.rust-lang.org/cargo/commands/cargo.html

Commands Explanations
cargo --version バージョン確認
cargo new 新規プロジェクト作成
cargo init 新規プロジェクト作成(既にディレクトリがあっても作成可能)
cargo build Rustコードをビルド
cargo run Rustコードを実行
cargo test Rustコードのテストコード実行
cargo clean Rustコードでの生成物を削除
cargo doc ドキュメント作成
cargo add Rust のプロジェクトに依存クレート(ライブラリ)を追加
cargo install 公開されているパッケージをインストール
cargo uninstall 公開されているパッケージをアンインストール
cargo search クレート(ライブラリ)を探す
cargo check Rustコードのエラーチェック
cargo fix Rustコードの不備を発見し修正
cargo fmt コードを自動整形するコマンド
cargo clippy Rust の高度な lint(コード品質チェック)
cargo publish crates.io に crate を公開する

【1】基本的なコマンド

1)cargo new

* 新規プロジェクト作成

構文

cargo new [Options] <path>

オプション

Options Explanations
--lib ライブラリを作るコマンド
--bin 実行可能バイナリ(CLIアプリ)を作るコマンド

2)cargo build

* ビルド

構文

cargo build [Options]

オプション

Options Explanations
--release 本番用の最適化ビルド を作るためのコマンド(出力先:target/release/)

3)cargo run

* 実行

構文

cargo run [Options]

【2】コード整形系

1)cargo check

* 「コンパイルせずに」型チェックだけ行う高速検証

チェック項目

* 型チェック
* 構文チェック
* 依存関係のチェック

構文

cargo check [Options]

2)cargo fix

* 警告を自動で修正してくれるコマンド

Memo

* コンパイラの警告を読み取り
* 安全なものだけ 自動で修正
 => 危険な変更はしない(安全な範囲だけ直す)
* 古い構文を新しい書き方に変換
* edition 更新にも便利(例:cargo fix --edition)

構文

cargo fix [Options]

3)cargo fmt

* コードを自動整形するコマンド

やること

* インデント調整
* 改行位置の調整
* スタイルの統一
* 余計なスペース削除
 => 自動整形するだけで動作は変わらない

構文

cargo fmt [Options]

4)cargo clippy

* Rust のリンター Clippy を使って、
 コードの問題や改善点を教えてくれるコマンド

教えてくれる例

* 不要なクローン
* より良い書き方(&str → str)
* バグを生む可能性のある書き方
* パフォーマンス改善
* 冗長コードの警告

【3】補助系

1)cargo doc

* ドキュメントを生成(HTML)

https://doc.rust-lang.org/cargo/commands/cargo-doc.html

* コメントに関する詳細は、以下の関連記事を参照のこと

Rust ~ コメント ~
https://dk521123.hatenablog.com/entry/2025/12/13/000224

Memo

* Rustdoc によるドキュメント生成
* 依存クレートの API ドキュメントもまとめて生成
* HTML 形式で閲覧できる

構文

cargo doc [Options]

オプション

Options Explanations
--open ブラウザで API ドキュメントが開く

【4】その他

1)cargo install / cargo uninstall

* crates.io から CLI アプリを「インストール/アンインストール」する

構文

cargo install [Options] <Target>

2)cargo publish

* crates.io に crate を公開する
 => Rust のパッケージレジストリ crates.io に
  独自の crate(ライブラリ・バイナリ)を公開するコマンド

動作

1. Cargo.toml のメタデータチェック
2. 必要なファイルの自動パッケージング
3. crates.io にアップロード
4. 以後、cargo add your_crate で誰でも使えるようになる
 => 一度公開すると バージョン削除できない ので慎重に!

関連記事

Rust ~ 環境構築編 ~
https://dk521123.hatenablog.com/entry/2023/04/22/234808
Rust ~ 入門編 ~
https://dk521123.hatenablog.com/entry/2025/11/26/224648
Rust ~ コメント ~
https://dk521123.hatenablog.com/entry/2025/12/13/000224