WindowsでESP32向けRust開発環境を構築する手順

2026年4月17日

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

エンジニアの世界では、「いつでも動ける状態を作っておけ」とよく言われます。
技術やポートフォリオがあっても、自分に合う案件情報を日常的に見れていないと、いざ動こうと思った時に比較や判断が難しくなってしまいます。
普段から案件情報が集まる環境を作っておくと、良い案件が出た時にすぐ動きやすくなりますよ。
筆者自身も、メガベンチャー勤務時代に年収1,500万円を超えた経験があります。振り返ると、技術だけでなく「どんな案件や働き方があるか」を日頃から見ていたことが、キャリアの選択肢を広げるきっかけになりました。
このブログを読んでくれた方に感謝を込めて、実際に使っている情報収集サービスを紹介します。

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

Contents

1 1. 必要なツールと前提条件
2 2. Rust 本体と組込みターゲットのセットアップ
3 3. 補助ツールのインストール
4 4. VS Code のセットアップ
5 5. OpenOCD と ESP‑IDF の設定例
- 5.1 5‑1. OpenOCD（任意）
- 5.2 5‑2. ESP‑IDF Tools Installer のインストール手順（Python 含む）
6 6. 実践：LED 点滅（blinky）サンプルの作成・ビルド・書き込み
7 7. トラブルシューティングまとめ
8 8. 今後のステップ

スポンサードリンク

1. 必要なツールと前提条件

ツール	用途	インストール方法
MSVC C++ ビルドツール	Rust の `rustc` が Windows 用にリンクするためのコンパイラ・ライブラリ	https://visualstudio.microsoft.com/visual-cpp-build-tools/ から Build Tools for Visual Studio をダウンロードし、C++ デスクトップ開発ワークロード（MSVC v143）を選択
Rustup / Rust stable	Rust 本体・標準ツールチェーンの管理	`rustup-init.exe`（https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe）を実行
ESP‑IDF Tools Installer	ESP‑IDF 本体、Xtensa ツールチェーン、Python 環境の自動セットアップ	https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/windows-setup.html の ESP-IDF Tools Installer をダウンロード
OpenOCD（任意）	JTAG/SWD デバッグサーバ – VS Code からデバッガを呼び出す際に使用	GitHub リリースページ https://github.com/openocd-org/openocd/releases から Windows 用 zip を取得し `C:\OpenOCD\bin` に展開
VS Code + 拡張機能	エディタ・IDE としてコード補完・デバッグを実現	https://code.visualstudio.com/ からインストールし、拡張機能 `rust-analyzer`, `ESP‑Debugger`（または `Cortex‑Debug`）を追加
probe‑run（probe‑rs スイート）	USB‑Serial 経由で ESP32 にフラッシュ／実行デバッグを行うコマンドラインツール	後述の `cargo install probe-run` でインストール

ポイント
- 上記すべては管理者権限の PowerShell から実行してください。
- Python がシステムに未インストールの場合、ESP‑IDF Tools Installer が自動的にミニマルな CPython を配置しますが、別途 python.org から最新版（3.9 以上）をインストールしても問題ありません。

2. Rust 本体と組込みターゲットのセットアップ

# 1&#xfe0f;&#x20e3; rustup のインストール（管理者権限で実行）
Invoke-WebRequest -Uri https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe -OutFile rustup-init.exe
.\rustup-init.exe -y --default-toolchain stable

# 2&#xfe0f;&#x20e3; インストール確認
rustc --version   # e.g. rustc 1.xx.x (xxxx-xx-xx)
cargo --version   # e.g. cargo 1.xx.x (xxxx-xx-xx)

# 3&#xfe0f;&#x20e3; ESP32 用 Xtensa ターゲットの追加
rustup target add xtensa-esp32-none-elf

# 4&#xfe0f;&#x20e3; 必要なサポートクレート（esp-idf-sys 等）をビルドできるように環境変数を設定
#    ESP‑IDF のインストールディレクトリが %USERPROFILE%\.espressif\tools にある前提です。
$env:IDF_PATH = &quot;$HOME\.espressif\esp-idf&quot;
$env:PATH += &quot;;$HOME\.espressif\tools\xtensa-esp32-elf\bin&quot;

# 1️⃣ rustup のインストール（管理者権限で実行）

Invoke-WebRequest -Uri https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe -OutFile rustup-init.exe

.\rustup-init.exe -y --default-toolchain stable

# 2️⃣ インストール確認

rustc --version # e.g. rustc 1.xx.x (xxxx-xx-xx)

cargo --version # e.g. cargo 1.xx.x (xxxx-xx-xx)

# 3️⃣ ESP32 用 Xtensa ターゲットの追加

rustup target add xtensa-esp32-none-elf

# 4️⃣ 必要なサポートクレート（esp-idf-sys 等）をビルドできるように環境変数を設定

# ESP‑IDF のインストールディレクトリが %USERPROFILE%\.espressif\tools にある前提です。

$env:IDF_PATH = "$HOME\.espressif\esp-idf"

$env:PATH += ";$HOME\.espressif\tools\xtensa-esp32-elf\bin"

注意
rustup target add xtensa-esp32-none-elf だけではコンパイルに必要なリンカや標準ライブラリが不足します。ESP‑IDF が提供する Xtensa ツールチェーン（上記 $env:PATH に追加したもの）と、esp-idf-sys クレートが利用できるように IDF_PATH を設定してください。

3. 補助ツールのインストール

# プロジェクトテンプレート作成用
cargo install cargo-generate

# デバッグ/書き込み（probe‑rs スイート）
cargo install probe-run   # 実行デバッグコマンド
cargo install probe-cli    # 低レベル CLI ユーティリティ

# （任意）ARM 系ボード向けの cargo-embed
cargo install cargo-embed

# プロジェクトテンプレート作成用

cargo install cargo-generate

# デバッグ/書き込み（probe‑rs スイート）

cargo install probe-run # 実行デバッグコマンド

cargo install probe-cli # 低レベル CLI ユーティリティ

# （任意）ARM 系ボード向けの cargo-embed

cargo install cargo-embed

インストール後、%USERPROFILE%\.cargo\bin が PATH に含まれていることを必ず確認してください。

4. VS Code のセットアップ

VS Code 本体 を公式サイトからダウンロードしてインストール
拡張機能パネルで次の拡張子を検索し、Install ボタンをクリック

拡張機能	目的
`rust-analyzer`	高速なコード補完・診断
`ESP-Debugger`（または `Cortex-Debug`）	ESP32 用デバッグ設定のテンプレート提供

ユーザー設定 (settings.json) に以下を追記し、OpenOCD のスクリプトパスを環境変数で柔軟に指定できるようにします。

{
    &quot;rust-analyzer.cargo.loadOutDirsFromCheck&quot;: true,
    &quot;rust-analyzer.procMacro.enable&quot;: true,
    &quot;[rust]&quot;: {
        &quot;editor.formatOnSave&quot;: true
    },
    // OpenOCD のスクリプトは %USERPROFILE%\.espressif\tools\openocd-*/share/openocd/scripts にあります
    &quot;esp-debugger.openOcdConfigPath&quot;: &quot;${env:HOME}/.espressif/tools/openocd-*/share/openocd/scripts&quot;
}

{

"rust-analyzer.cargo.loadOutDirsFromCheck": true,

"rust-analyzer.procMacro.enable": true,

"[rust]": {

"editor.formatOnSave": true

// OpenOCD のスクリプトは %USERPROFILE%\.espressif\tools\openocd-*/share/openocd/scripts にあります

"esp-debugger.openOcdConfigPath": "${env:HOME}/.espressif/tools/openocd-*/share/openocd/scripts"

}

5. OpenOCD と ESP‑IDF の設定例

5‑1. OpenOCD（任意）

# GitHub から zip を取得し解凍 → C:\OpenOCD\bin に配置済みと仮定
[Environment]::SetEnvironmentVariable(
    &quot;Path&quot;,
    $Env:Path + &quot;;C:\OpenOCD\bin&quot;,
    &quot;Machine&quot;
)

# GitHub から zip を取得し解凍 → C:\OpenOCD\bin に配置済みと仮定

[Environment]::SetEnvironmentVariable(

"Path",

$Env:Path + ";C:\OpenOCD\bin",

"Machine"

)

launch.json で参照するパスは次のように変数化しておくと環境依存を回避できます。

{
    &quot;type&quot;: &quot;espidf&quot;,
    &quot;request&quot;: &quot;launch&quot;,
    &quot;name&quot;: &quot;Debug on ESP32&quot;,
    &quot;target&quot;: &quot;esp32&quot;,
    &quot;program&quot;: &quot;${workspaceFolder}/target/xtensa-esp32-none-elf/debug/blinky.elf&quot;,
    &quot;openOcdConfig&quot;: [
        &quot;${env:HOME}/.espressif/tools/openocd-*/share/openocd/scripts/board/esp-wroom-32.cfg&quot;
    ],
    &quot;preLaunchTask&quot;: &quot;cargo build --target xtensa-esp32-none-elf&quot;
}

{

"type": "espidf",

"request": "launch",

"name": "Debug on ESP32",

"target": "esp32",

"program": "${workspaceFolder}/target/xtensa-esp32-none-elf/debug/blinky.elf",

"openOcdConfig": [

"${env:HOME}/.espressif/tools/openocd-*/share/openocd/scripts/board/esp-wroom-32.cfg"

"preLaunchTask": "cargo build --target xtensa-esp32-none-elf"

}

5‑2. ESP‑IDF Tools Installer のインストール手順（Python 含む）

上記リンクから ESP‑IDF Tools Installer をダウンロードし実行
インストーラが表示するチェックリストで “Add Python to PATH” と “Install Xtensa toolchain” に必ずチェックを入れる
完了後、PowerShell で次のコマンドが成功すればインストールは完了です。

python --version   # 例: Python 3.11.x
idf.py --version    # ESP-IDF のバージョン表示

python --version # 例: Python 3.11.x

idf.py --version # ESP-IDF のバージョン表示

6. 実践：LED 点滅（blinky）サンプルの作成・ビルド・書き込み

6‑1. テンプレート取得

cargo generate --git https://github.com/esp-rs/esp-hal-template.git --name blinky
cd blinky

cargo generate --git https://github.com/esp-rs/esp-hal-template.git --name blinky

cd blinky

Cargo.toml の依存関係に esp-idf-sys = { version = "0", features = ["native"] } が自動で追加されます。

6‑2. ビルド（デバッグモード）

cargo build --target xtensa-esp32-none-elf
# 出力例: target/xtensa-esp32-none-elf/debug/blinky.elf

cargo build --target xtensa-esp32-none-elf

# 出力例: target/xtensa-esp32-none-elf/debug/blinky.elf

ビルドが通らない場合は次を確認してください。

エラー	原因例	対処
`cannot find crate 'std'`	ターゲット未追加または Xtensa ツールチェーンが PATH に無い	`rustup target list --installed` で確認し、必要なら再度 `rustup target add xtensa-esp32-none-elf`
リンカエラー (`ld.exe: fatal error`)	ESP‑IDF の環境変数 `IDF_PATH` が未設定	`$env:IDF_PATH = "$HOME\.espressif\esp-idf"` を PowerShell に書き込む

6‑3. 書き込み & デバッグ（probe‑run）

# USB‑Serial 経由でフラッシュし、同時に GDB デバッグサーバを起動
probe-run --chip esp32 target/xtensa-esp32-none-elf/debug/blinky.elf

# USB‑Serial 経由でフラッシュし、同時に GDB デバッグサーバを起動

probe-run --chip esp32 target/xtensa-esp32-none-elf/debug/blinky.elf

probe-run は内部で esptool.py を呼び出すため、追加のスクリプトインストールは不要です。

代替手段
- cargo embed --target xtensa-esp32-none-elf --release（ARM 用に最適化された場合のみ）
- idf.py flash monitor（ESP‑IDF 標準コマンド）

6‑4. 動作確認

シリアルモニタが自動で起動し、次のようなログが表示されれば成功です。

Hello, world! ESP32 is blinking...

1 2	Hello, world! ESP32 is blinking...

LED が点滅すればハードウェア側も正しく接続できています。

7. トラブルシューティングまとめ

現象	主な原因	解決策
`probe-run: No probes found`	USB ドライバが未インストール、または PowerShell が管理者権限でない	デバイスマネージャで COM ポートを確認し、PowerShell を管理者で再起動
ビルド時に `undefined reference to __wrap_*`	Xtensa ツールチェーンのパスが通っていない	`$env:PATH += ";$HOME\.espressif\tools\xtensa-esp32-elf\bin"` を実行し、再度ビルド
デバッグ中に `target remote :3333` がタイムアウト	OpenOCD の設定ファイルパスが間違っている	`launch.json` の `openOcdConfig` パスを `${env:HOME}/.espressif/tools/openocd-*/share/openocd/scripts/board/...` に修正
Python が見つからない	ESP‑IDF Installer で「Add to PATH」にチェックし忘れた	`python -m pip install --upgrade esptool` で手動インストール、または再度インストーラを実行