Cursor での Rust 開発：究極のガイド

Cursor での Rust 開発

Rust は、安全性とパフォーマンスを優先するシステムプログラミング言語です。Rust と Cursor を組み合わせることで、AI 支援と厳格なコンパイラフィードバックが融合した、類を見ない開発体験が生まれます。このガイドでは、Cargo ワークフロー、借用チェッカーナビゲーション、Rust Analyzer 統合、およびインテリジェントなデバッグのために Cursor を活用する方法を探ります。

Cursor での Rust セットアップ

適切に設定された環境は、効率的な Rust 開発に不可欠です。Cursor は Rust Analyzer 拡張機能とシームレスな Cargo 統合を通じて Rust をサポートしています。

Rust ツールチェーンのインストール

rustup を介して Rust がインストールされていることを確認してください。Cursor のターミナルを開いて確認します：

rustc --version
cargo --version
rustup show

Rust がインストールされていない場合は、公式の rustup の指示に従ってください。インストール後、開発に必要なコンポーネントを追加します：

rustup component add rust-src rustfmt clippy

ヒント

rustup update でツールチェーンを最新に保ちましょう。Cursor のターミナルにより、複数のツールチェーンやターゲットの管理が簡単になります。

Rust Analyzer のインストール

Rust Analyzer は、Rust IDE サポートのゴールドスタンダードです。Cursor では、拡張機能ビューを開いて「rust-analyzer」をインストールしてください。この拡張機能は以下を提供します：

リアルタイムのエラーチェックと診断
構造体、トレイト、モジュールの自動補完
インライン型ヒントとパラメータ名
インポートとリファクタリングのコードアクション
定義への移動とすべての参照の検索

警告

rust-lang のレガシー「Rust」拡張機能など、競合する拡張機能を無効にしてください。rust-analyzer と並行して両方を実行すると、重複した診断とパフォーマンスの低下が発生します。

Rust プロジェクト向けの Cursor 設定

.vscode/settings.json でプロジェクト固有の設定を微調整します：

{
  "rust-analyzer.cargo.features": "all",
  "rust-analyzer.check.command": "clippy",
  "rust-analyzer.check.extraArgs": ["--tests", "--benches"],
  "rust-analyzer.procMacro.enable": true,
  "rust-analyzer.lens.enable": true,
  "editor.formatOnSave": true,
  "[rust]": {
    "editor.defaultFormatter": "rust-lang.rust-analyzer"
  }
}

これらの設定により、Clippy によるリント、プロシージャルマクロのサポート、および保存時の自動フォーマットが有効になります。

Cargo 統合とワークスペース

Cargo は Rust のビルドシステム兼パッケージマネージャーです。Cursor のターミナルと AI 機能により、Cargo ワークフローが直感的かつ効率的になります。

プロジェクトの作成と管理

Cursor のターミナルから直接新しいプロジェクトを開始します：

cargo new my_project --bin
cd my_project

ライブラリの場合は cargo new my_lib --lib を使用します。Cursor は Cargo.toml を自動的に検出し、ワークスペースに対して Rust Analyzer を有効化します。

ヒント

依存関係をコマンドラインから管理するには cargo edit を使用してください。cargo install cargo-edit でインストールし、cargo add serde tokio でクレートを追加します。

Cargo ワークスペースの操作

大規模な Rust プロジェクトでは、ワークスペースを使用して複数のクレートを整理するのが一般的です。ワークスペースの Cargo.toml は次のようになります：

[workspace]
members = ["crates/core", "crates/api", "crates/cli"]
resolver = "2"

[workspace.dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1.35", features = ["full"] }

Cursor のファイルエクスプローラーと検索は、ワークスペースメンバー間でシームレスに動作します。AI チャットはワークスペースの境界を理解し、@ でシンボルを参照するときにクロスクレートコードを生成できます。

ビルドスクリプトとカスタム設定

コード生成やネイティブ依存関係を必要とするプロジェクトでは、build.rs を使用します：

use std::env;
use std::path::PathBuf;

fn main() {
    let out_dir = PathBuf::from(env::var("OUT_DIR").unwrap());
    println!("cargo:rustc-link-search=native=/usr/local/lib");
    println!("cargo:rerun-if-changed=src/wrapper.h");
}

Cursor のエラーハイライトはビルドスクリプトの失敗にも及び、設定問題の診断が容易になります。

AI 支援による借用チェッカーのナビゲート

Rust の借用チェッカーはメモリ安全性を保証することで有名ですが、初心者には難しい場合があります。Cursor の AI 支援は、借用チェッカーのエラーをより迅速に理解し解決するのに役立ちます。

所有権エラーの理解

借用チェッカーがコードを拒否すると、Cursor はインラインで明確なエラーメッセージを表示します。複雑なライフタイムの問題については、エラーを選択して Cursor の AI チャットに尋ねてください：

このコードは借用チェッカーを通らないのはなぜでしょうか、どう修正すればよいでしょうか？

Cursor は所有権の移転、可変借用を説明し、clone()、Rc<RefCell<T>>、またはコードの再構築を使用した修正を提案します。

ライフタイムアノテーションの支援

関数や構造体にライフタイムを追加することは、Rust で最も難しい部分の一つです。Cursor にアノテーションを提案させましょう：

// 変更前：ライフタイムが欠落
fn longest(x: &str, y: &str) -> &str {
    if x.len() > y.len() { x } else { y }
}

// 変更後：Cursor が明示的なライフタイムを提案
fn longest<'a>(x: &'a str, y: &'a str) -> &'a str {
    if x.len() > y.len() { x } else { y }
}

ヒント

Cursor がライフタイムを提案したときは、説明を注意深く読んでください。ライフタイムがなぜ必要かを理解することで、Rust の借用ルールを身に付けることができます。

スマートポインタの推奨

シンプルな参照が不十分な場合、Cursor は適切なスマートポインタを推奨できます：

シナリオ	Cursor の提案
共有所有権	`Rc<T>` または `Arc<T>`
内部可変性	`RefCell<T>` または `Mutex<T>`
動的ディスパッチ	`Box<dyn Trait>`
オプションの所有権	`Option<Box<T>>`

Cursor に直接尋ねてください：「スレッド間で共有される可変状態にはどのスマートポインタを使用すべきですか？」と、使用例付きで Arc<Mutex<T>> を推奨します。

AI 駆動のデバッグとエラー解決

Cursor での Rust デバッグは、CodeLLDB のパワーと AI 駆動のエラー分析および修正提案を組み合わせています。

デバッガーの設定

ネイティブデバッグサポートのために CodeLLDB 拡張機能をインストールします。.vscode/launch.json 構成を作成します：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug Rust",
      "type": "lldb",
      "request": "launch",
      "cargo": {
        "args": ["build", "--bin", "my_app"],
        "filter": {
          "name": "my_app",
          "kind": "bin"
        }
      },
      "args": [],
      "cwd": "${workspaceFolder}"
    }
  ]
}

ブレークポイントの設定と値の検査

行番号の横にあるガターをクリックしてブレークポイントを設定します。実行が停止すると、変数ペインを使用して Option、Result、およびカスタム構造体の値を検査します。Cursor は列挙型のバリアントとフィールド名を明確にフォーマットします。

非同期 Rust の場合、ウォッチペインで futures やタスクの状態を検査します。これは Tokio ベースのアプリケーションをデバッグする際に重要です。

警告

最適化されたリリースビルドをデバッグすると、一部の変数が最適化される可能性があります。完全な変数の可視性を得るには、常に cargo build（デバッグプロファイル）でデバッグしてください。

AI を使用した複雑なエラーの解決

Rust コンパイラのエラーは冗長になることがあります。エラーを Cursor の AI チャットに貼り付けて、人間にわかりやすい説明を得てください：

error[E0382]: borrow of moved value: `data`
  --> src/main.rs:15:14
   |
10 |     let data = vec![1, 2, 3];
   |         ---- move occurs because `data` has type `Vec<i32>`, which does not implement the `Copy` trait
11 |     process(data);
   |             ---- value moved here
...

Cursor はムーブセマンティクスを説明し、値が消費された場所を示し、借用（&data）やクローン（data.clone()）などの代替案を提案します。

Cursor で慣用的な Rust を書く

Cursor の AI は高品質な Rust コードベースでトレーニングされています。それを使用して、慣用的で高性能かつ安全な Rust を書きましょう。

トレイトと実装の生成

カスタムトレイトが必要ですか？コメントで説明し、Cursor にボイラープレートを生成させてください：

/// コンパクトなバイナリ形式にシリアライズ可能な型のトレイト
pub trait CompactSerialize {
    fn to_bytes(&self) -> Vec<u8>;
    fn from_bytes(bytes: &[u8]) -> Result<Self, Error>
    where
        Self: Sized;
}

次に、Cursor に構造体への実装を依頼します：

@network.rs の Packet 構造体に CompactSerialize を実装

非同期 Rust と並行パターン

非同期 Rust を書くには、futures、streams、および並行プリミティブを慎重に扱う必要があります。Cursor は完全な非同期関数を生成できます：

use tokio::time::{sleep, Duration};

async fn fetch_with_retry(url: &str, max_retries: u32) -> Result<String, reqwest::Error> {
    for attempt in 0..max_retries {
        match reqwest::get(url).await {
            Ok(response) => return response.text().await,
            Err(e) if attempt < max_retries - 1 => {
                eprintln!("Attempt {} failed: {}, retrying...", attempt + 1, e);
                sleep(Duration::from_secs(2_u64.pow(attempt))).await;
            }
            Err(e) => return Err(e),
        }
    }
    unreachable!()
}

ヒント

非同期 Rust を扱うとき、コードがマルチスレッドエグゼキュータで実行される場合は、Cursor に Send および Sync の境界を含めるよう依頼してください。これにより、後でコンパイル時の予期しない問題を防げます。

Unsafe Rust と FFI 境界

システムプログラミングの場合、Cursor は unsafe ブロックや Foreign Function Interface（FFI）コードを支援できます：

use std::os::raw::{c_char, c_int};
use std::ffi::CStr;

extern "C" {
    fn legacy_compute(input: *const c_char) -> c_int;
}

pub fn safe_compute(input: &str) -> Result<i32, String> {
    let c_string = std::ffi::CString::new(input)
        .map_err(|e| e.to_string())?;
    unsafe {
        let result = legacy_compute(c_string.as_ptr());
        if result < 0 {
            return Err("Legacy function failed".to_string());
        }
        Ok(result)
    }
}

unsafe コードは常に注意深くレビューしてください。Cursor は unsafe ブロックを明確にマークし、AI チャットは維持しなければならない不変条件を説明できます。

テスト、ベンチマーク、およびドキュメント

Rust の組み込みテストおよびドキュメントツールは優れています。Cursor は AI 生成のテストとドキュメントコメントでそれらを増強します。

ユニットテストと統合テスト

Cursor は Rust の慣例に従ってテストを生成します。次のような関数の場合：

pub fn divide(a: f64, b: f64) -> Result<f64, &'static str> {
    if b == 0.0 {
        return Err("division by zero");
    }
    Ok(a / b)
}

Cursor は次を生成します：

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_divide_normal() {
        assert_eq!(divide(10.0, 2.0), Ok(5.0));
    }

    #[test]
    fn test_divide_by_zero() {
        assert_eq!(divide(10.0, 0.0), Err("division by zero"));
    }

    #[test]
    fn test_divide_negative() {
        assert_eq!(divide(-10.0, 2.0), Ok(-5.0));
    }
}

ドキュメントとドックテスト

Rust は実行可能な例を含むドキュメントを推奨しています。Cursor は、埋め込みテストケースを含む /// ドキュメントコメントを生成できます：

/// 設定文字列をキーと値のペアに解析します。
///
/// # 例
///
/// ```
/// let config = parse_config("key=value\nname=test");
/// assert_eq!(config.get("key"), Some(&"value".to_string()));
/// ```
pub fn parse_config(input: &str) -> HashMap<String, String> {
    input.lines()
        .filter_map(|line| line.split_once('='))
        .map(|(k, v)| (k.trim().to_string(), v.trim().to_string()))
        .collect()
}

ドックテストを実行：

cargo test --doc

Criterion によるベンチマーク

パフォーマンス測定には、Criterion クレートを使用します。Cursor はベンチマークファイルの足場を組むことができます：

use criterion::{black_box, criterion_group, criterion_main, Criterion};
use my_crate::fibonacci;

fn criterion_benchmark(c: &mut Criterion) {
    c.bench_function("fib 20", |b| {
        b.iter(|| fibonacci(black_box(20)))
    });
}

criterion_group!(benches, criterion_benchmark);
criterion_main!(benches);

警告

ベンチマークには criterion 依存関係が必要で、benches/ に配置する必要があります。Cursor の Cargo.toml の提案には、正しい [dev-dependencies] エントリが含まれます。

まとめ

Cursor での Rust 開発は、厳格なコンパイラフィードバックとインテリジェントな AI 支援のシナジーです。Cargo 統合をマスターし、借用チェッカーのガイダンスを理解し、Rust Analyzer を活用し、Cursor の AI をデバッグとコード生成に使用することで、前例のない速度で安全なシステムコードを書くことができます。コンパイラを協力ツールとして受け入れ、Cursor に複雑なエラーを説明させ、AI 生成の unsafe コードは常に検証してください。Cursor での Rust の旅は、生産的でありながら深く教育的なものとなるでしょう。

Cursor での Rust セットアップ​

Rust ツールチェーンのインストール​

Rust Analyzer のインストール​

Rust プロジェクト向けの Cursor 設定​

Cargo 統合とワークスペース​

プロジェクトの作成と管理​

Cargo ワークスペースの操作​

ビルドスクリプトとカスタム設定​

AI 支援による借用チェッカーのナビゲート​

所有権エラーの理解​

ライフタイムアノテーションの支援​

スマートポインタの推奨​

AI 駆動のデバッグとエラー解決​

デバッガーの設定​

ブレークポイントの設定と値の検査​

AI を使用した複雑なエラーの解決​

Cursor で慣用的な Rust を書く​

トレイトと実装の生成​

非同期 Rust と並行パターン​

Unsafe Rust と FFI 境界​

テスト、ベンチマーク、およびドキュメント​

ユニットテストと統合テスト​

ドキュメントとドックテスト​

Criterion によるベンチマーク​

まとめ​