esp32-使用虚拟机开发-部署esp32的linux的环境
以下是在 Ubuntu Linux 上完整搭建 ESP32 开发环境(基于 ESP-IDF v5.4)的详细步骤,适用于 ESP32、ESP32-S2、ESP32-S3 等芯片
python需要3.9以上。升级python版本到3.9的手动编译版本
sudo apt update
sudo apt install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev \
libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev wgetcd /tmp
wget https://www.python.org/ftp/python/3.9.16/Python-3.9.16.tar.xz
tar -xf Python-3.9.16.tar.xz
cd Python-3.9.16
./configure --enable-optimizations
make -j$(nproc)
sudo make altinstall
---
✅ 第 1 步:安装系统依赖
打开终端,执行以下命令安装编译所需工具:
```bash
sudo apt update
sudo apt install -y git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
```
---
✅ 第 2 步:创建工作目录并克隆 ESP-IDF
```bash
mkdir -p ~/esp
cd ~/esp
git clone -b v5.4 --recursive https://gitee.com/EspressifSystems/esp-idf.git
```
> ⚠️ 注意:使用 Gitee 镜像可加速国内访问 。
---
✅ 第 3 步:安装 ESP-IDF 工具链
进入 ESP-IDF 目录,执行安装脚本(以 ESP32 为例):
```bash
cd ~/esp/esp-idf
./install.sh esp32
```
如需支持多个芯片(如 ESP32-S3):
```bash
./install.sh esp32 esp32s3
```
> 国内用户可设置镜像环境变量加速下载:
>
> ```bash
> export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
> ./install.sh esp32
> ```
---
✅ 第 4 步:配置环境变量
每次打开终端都需要运行一次:
```bash
. $HOME/esp/esp-idf/export.sh
```
为方便使用,建议添加别名到 `~/.bashrc`:
```bash
echo "alias get_idf='. $HOME/esp/esp-idf/export.sh'" >> ~/.bashrc
source ~/.bashrc
```
以后只需输入 `get_idf` 即可激活环境 。
---
✅ 第 5 步:验证安装(运行 hello_world 示例)
```bash
cd ~/esp
cp -r $IDF_PATH/examples/get-started/hello_world .
cd hello_world
idf.py set-target esp32
idf.py menuconfig
```
> 在 `menuconfig` 中可配置串口、Flash 大小、PSRAM 等参数。
---
✅ 第 6 步:编译并烧录程序
1. 连接开发板,确认串口设备名(如 `/dev/ttyUSB0`)。
2. 编译并烧录:
```bash
idf.py build
idf.py -p /dev/ttyUSB0 flash
```
3. 查看串口输出:
```bash
idf.py monitor
```
✅ 常见问题速查
| 问题描述 | 解决方法 |
|----------------------|------------------------------------------------------------|
| 找不到串口 `/dev/ttyUSB0` | 确保已连接开发板,使用 `ls /dev/tty*` 查看设备名 |
| 权限不足 | 将用户加入 `dialout` 组:`sudo usermod -a -G dialout $USER` |
| 编译失败 | 确认依赖是否安装完整,建议使用 Ubuntu 22.04 |
✅ 可选:使用 VS Code 插件(图形化开发)
1. 安装 VS Code。
2. 安装插件:**Espressif IDF**。
3. 使用快捷键 `Ctrl+Shift+P`,输入 `ESP-IDF: Configure Extension`,选择 Express 安装 。
✅ 总结一句话
> **完成以上 6 步,你的 Ubuntu 系统就已具备完整的 ESP32 开发能力,支持命令行或 VS Code 开发。**