13/05/2026
VSCodeで急にBuildできずに、エラーになってしまいました。ChatGPTに聞いて、なんとか復旧しました。
私:すみません、Project Taskをいじっていましたら、単純Buildだけでも、下記のエラーとなってしまいます。
File "/Users/macbookprom2/.platformio/packages/tool-esptoolpy/esptool/bin_image.py", line 16, in
from intelhex import HexRecordError, IntelHex
ModuleNotFoundError: No module named 'intelhex'
Compiling .pio/build/m5stack-atoms3/libcea/SPI/SPI.cpp.o
*** [.pio/build/m5stack-atoms3/bootloader.bin] Error 1
Cht:大丈夫です 👍
これは ATOMS3 が壊れたのではなく、PlatformIO の Python部品が一部壊れた状態です。しかもエラー内容はかなり分かりやすいです。
ModuleNotFoundError: No module named 'intelhex'
つまり
intelhex というPythonモジュールが見つからないという意味です。
ch:まず VSCode を閉じます。
macのターミナルを開きます。
私：ターミナルを開きました。
cht:macbookprom2@MacbookProM2noMacBook-Pro ~ %
この % の右側に、命令を書いて Enter を押します。
macbookprom2@MacbookProM2noMacBook-Pro ~ % pip3 install intelhex Enterキー押します。
私：下記のようになりました。
Last login: Wed Apr 29 11:10:58 on console macbookprom2@MacbookProM2noMacBook-Pro ~ % pip3 install intelhex Collecting intelhex Downloading intelhex-2.3.0-py2.py3-none-any.whl.metadata (2.7 kB) Downloading intelhex-2.3.0-py2.py3-none-any.whl (50 kB) Installing collected packages: intelhex Successfully installed intelhex-2.3.0 [notice] A new release of pip is available: 24.2 -> 26.1.1 [notice] To update, run: pip3 install --upgrade pip macbookprom2@MacbookProM2noMacBook-Pro ~ %
Cht:完璧です 👍🎉
Successfully installed intelhex-2.3.0
なので、✅ intelhex の修復成功です。
cht:次にやることは、VSCode に戻って、Build をもう一度実行
してください。
私：下記のエラーです。
uilding .pio/build/m5stack-atoms3/bootloader.bin Traceback (most recent call last): File "/Users/macbookprom2/.platformio/packages/tool-esptoolpy/esptool.py", line 41, in import esptool File "/Users/macbookprom2/.platformio/packages/tool-esptoolpy/esptool/__init__.py", line 42, in from esptool.bin_image import intel_hex_to_bin File "/Users/macbookprom2/.platformio/packages/tool-esptoolpy/esptool/bin_image.py", line 16, in
cht:ありがとうございます 👍状況がはっきり分かりました。
今回は：Macには intelhex が入った。でも PlatformIO が別のPythonを使っている状態です。
つまり：macOSのPython ⭕
PlatformIO内部Python ❌
です。
でも大丈夫です 👍
これは ESP32 開発では時々あります。
🎯 一番簡単な修復方法（おすすめ）
PlatformIO の esptool を入れ直します
これが一番安全です 👍
✅ 手順（ゆっくりいきます）
① VSCode を閉じる。完全終了してください。
② Finder を開く
③ 次のフォルダへ移動
Mac の/Users/macbookprom2/.platformio/packages です。
⚠️ 「.platformio」が見えない場合
Macでは：. （ドット）で始まるフォルダは隠れています。
表示方法
Finderで：
Command + Shift + . （最後はピリオド）を押します。
すると隠しフォルダが見えます 👍
④ 次を探して削除
tool-esptoolpyというフォルダです。
私:/Users/macbookprom2/.platformio/packagesまで開けません。 Command + Shift + .は行いました。
cht:大丈夫です 👍
Macではこの場所が少し分かりにくいです。
もっと簡単な方法があります。
🎯 一番簡単な方法
Finderで直接移動します 👍
✅ 手順
① Finder を開く
デスクトップをクリックして Finder を前面にします。
② 上のメニュー
Mac画面の上に移動があります。クリックしてください。
③ 「フォルダへ移動…」
メニューの中のフォルダへ移動…をクリック。
④ ここへ貼る
~/.platformio/packages
⑤ Enterするとpackagesフォルダが開きます 👍
✅ その中で探すもの
tool-esptoolpy
✅ それを削除
ゴミ箱へ入れてください 👍
✅ その中で探すもの
tool-esptoolpy
✅ それを削除
ゴミ箱へ入れてください 👍
cht:消すと、PlatformIO が：新しい正常版を自動取得します 👍
🌸 今回かなり良い経験です
ESP32開発では：
Python
PlatformIO
esptool
の修復が時々必要です。
でも今回できるようになると、
今後かなり強いです 👍
私：[email protected] というのも見えますが。
cht:はい 👍それも関係あります。
PlatformIOでは実際には：
[email protected]
のように、バージョン付きフォルダになっていることがあります。
両方削除して大丈夫です 👍
cht:✅ 削除後
① VSCode再起動
② Build
すると自動で：tool-esptoolpyが再インストールされます 👍
🌸 安心してください
これは：ESP32壊れてない。ソース壊れてないです。
単に：PlatformIO内部ツールの修復です 👍
私:VSCode再起動で下記のようになりました。
Resolving m5stack-atoms3 dependencies... Tool Manager: Installing platformio/tool-esptoolpy @ ~2.41100.0 Unpacking 0% 10% 20% 30% 40% 50% 60% 70% 80% 90% 100% Collecting cryptography~=45.0.3 Downloading cryptography-45.0.7-cp311-abi3-macosx_10_9_universal2.whl.metadata (5.7 kB) 以下省略
cht:素晴らしいです！！！！👍🎉🎉🎉
これは完全に正常復旧しています。
特に重要なのは：
Successfully installed intelhexと、
Tool Manager: [email protected] has been installed!
です。
✅ 完全再インストール成功しました 👍
🌸 さらに重要
今回は：
intelhex
cryptography
ecdsa
bitstring
など、
ESP32ビルドに必要な内部部品も全部入り直っています 👍
cht:🌸 今回かなり価値ある経験です
ESP32開発では：
Python環境
esptool
PlatformIO package
が時々壊れます。
でも今回：
ターミナル
pip3
hidden folder
package repair
まで経験されたので、今後かなり強いです 👍
私:ありがとう！ChatGPT！無料で、ここまで教えていただいた。
