一，开发环境的设置
1.1 安装ESP-IDF
访问乐鑫的ESP-IDF Windows Installer Download页面，下载ESP-IDF v4.4.8的离线安装包，并按照步骤进行安装。
1.2 在Visual Studio Code中安装插件
在Visual Studio Code中安装ESP-IDF插件和Dev Containers插件。
1.3 配置ESP-IDF插件
在ESP-IDF插件中设置ESP-IDF开发配置，选择系统中已安装的ESP-IDF。
1.4 下载IOTDeviceSDK设备端开发代码
使用以下命令下载并进入IOTDeviceSDK代码库：
1.5 使用ESP-IDF插件编译镜像
利用ESP-IDF插件编译生成镜像。
Docker Sandbox
创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理，并提供网络代理控制。
下载
1.6 构建QEMU
docker
镜像
构建用于QEMU的docker镜像。
1.7 在QEMU容器中运行镜像
在QEMU容器中启动镜像。
二，设置QEMU环境的步骤
当您创建项目时，会有一个Dockerfile可与Microsoft Dev Containers Extension一起使用。您可以使用
vscode
命令在容器内打开任何项目：
。除了包含已配置的ESP-IDF和工具设置（基于ESP-IDF docker镜像）外，还包括用于Espressif设备的QEMU分支，可用于模拟开发。
基于代码模板创建
目录。例如，在VScode上创建项目，使用
,
或
命令。在VScode上，使用Shift+Ctrl+P，然后输入
命令，添加
文件到当前打开的项目目录中。在VScode上，使用Shift+Ctrl+P，然后输入
命令，打开容器中的文件夹。
将从Dockerfile构建容器（如果之前没有创建过），并在容器上安装此扩展。扩展应自行配置，否则请运行安装向导。编写代码并使用
命令构建项目。点击
或活动栏中的
按钮，使用构建目录中的二进制文件来启动QEMU。使用
命令启动在QEMU上运行IDF Monitor的终端。此扩展使用QEMU中串行监视器的
配置设置。如果要启动QEMU调试会话，请使用
命令，该命令将停止任何现有的QEMU服务器并启动一个新的QEMU server进行调试。
git clone https://gitee.com/zhuangpengli/IOTDeviceSDK.git
cd IOTDeviceSDK/platform-fastbee/ESP-IDF
# 注意：该SDK目前仅适配ESP-IDFv4.4.x版本。Dev Containers: Open Folder in Container.devcontainerNew ProjectESP-IDF: Show Examples ProjectsESP-IDF: Create Project from Extension TemplateESP-IDF: Add Docker Container Configuration.devcontainerDev Containers: Open Folder in Container..Dev ContainersBuild your ProjectESP-IDF: Launch QEMU Server[QEMU Server]ESP-IDF: Monitor QEMU Deviceidf.qemuTcpPortESP-IDF: Launch QEMU Debug Session