想把 ESP32-C3 开发板接入米家 APP，但又怕步骤太复杂？别担心，这篇教程专门讲环境搭建，用最直白的方式带你做好准备工作，保证看完就会操作

一、准备工作：这些东西先备齐

硬件清单（缺一不可）

• ESP32-C3 开发板：推荐 ESP32-C3-DevKitM-1，新手友好，价格也合适
• USB 数据线：普通安卓线就行，注意要能传数据（有些充电线只能充电）
• 电脑：Windows 系统，配置不用太高，能正常上网就行

软件准备（提前弄好更省心）

• Python：需要 3.7 或更高版本（后面会教你怎么安装）
• 米家 APP：手机应用商店搜 "米家" 下载好，暂时不用打开

二、超简单！一键搞定 ESPHome 安装

最麻烦的环境配置，我已经帮你做成了cmd执行文件，双击运行就能搞定，全程不用动脑子。

具体步骤：

1.新建脚本文件

在电脑桌面上右键→新建→文本文档，打开后把下面的代码复制进去，然后点 "文件→另存为"，文件名写ESPHome.cmd，保存类型选 "所有文件"（这点很重要，不然会变成 txt 文件）

@echo off
:: 定义根目录和demo子文件夹路径
set "ROOT_DIR=G:\ESPHome"
set "DEMO_DIR=%ROOT_DIR%\demo"

:: 检查并创建ESPHome根目录
if not exist "%ROOT_DIR%" (
    echo 正在创建ESPHome根目录：%ROOT_DIR%
    mkdir "%ROOT_DIR%"
    if %errorlevel% neq 0 (
        echo 创建ESPHome目录失败，请检查G盘权限
        pause
        exit /b 1
    )
)

:: 检查并创建demo子文件夹
if not exist "%DEMO_DIR%" (
    echo 正在创建demo子文件夹：%DEMO_DIR%
    mkdir "%DEMO_DIR%"
    if %errorlevel% neq 0 (
        echo 创建demo目录失败，请检查权限
        pause
        exit /b 1
    )
)

:: 切换到ESPHome工作目录（用于安装操作）
cd /d "%ROOT_DIR%"

:: 检查并安装/更新ESPHome（使用清华镜像源）
echo 正在检查并安装/更新ESPHome...
pip3 install --upgrade esphome -i https://pypi.tuna.tsinghua.edu.cn/simple/

:: 根据安装结果执行后续操作
if %errorlevel% equ 0 (
    echo ESPHome安装/更新成功，正在demo子文件夹中启动仪表盘...
    :: 切换到demo子文件夹
    cd /d "%DEMO_DIR%"
    if %errorlevel% neq 0 (
        echo 无法切换到demo子文件夹
        pause
        exit /b 1
    )
    :: 在demo子文件夹中启动仪表盘并打开网页
    start cmd /k esphome dashboard ./ && start "" http://localhost:6052
) else (
    echo ESPHome安装/更新失败，请检查网络或权限
    pause
    exit /b 1
)

2.运行脚本

右键这个刚保存的ESPHome一键安装.cmd文件，选择 "以管理员身份运行"（一定要用管理员身份，不然可能没权限创建文件夹）

3.等待完成

脚本会自动做这些事，你不用管：

• 在 G 盘创建ESPHome文件夹和里面的demo子文件夹
• 用国内的镜像源下载安装 ESPHome（比直接从国外网站快很多）
• 自动打开浏览器，显示 ESPHome 的操作界面（地址是http://localhost:6052）

看到窗口里出现 "ESPHome 安装 / 更新成功" 的提示，就说明环境搭好了！

不想用脚本？手动安装步骤

1.安装 Python

打开Python 官网，点 "Downloads" 下载最新版本，安装时一定要勾选 "Add Python to PATH"（这个选项在安装界面下面，不勾的话后面会很麻烦），其他步骤一路点 "下一步"。

2.检查 Python 是否装好

按下Win+R，输入cmd打开命令窗口，复制粘贴这两行命令（输完一行按回车）：

python --version
pip3 --version

能看到类似Python 3.9.7和pip 21.2.3这样的版本信息，就说明装好了。

3.安装 ESPHome

在命令窗口里复制粘贴这行命令（用国内源下载快）：

pip3 install esphome -i https://pypi.tuna.tsinghua.edu.cn/simple/

等它跑完，出现 "Successfully installed" 就表示安装成功了。

4.创建工作文件夹并启动 ESPHome

还是在命令窗口，一行行输入这三行命令：

mkdir G:\ESPHome\demo
cd G:\ESPHome\demo
esphome dashboard ./

这时候打开浏览器，输入以下能看到 ESPHome 的界面就大功告成了。

localhost:6052

三、常见问题：遇到了这样解决

1. 提示 "pip3 不是内部或外部命令"

这是因为 Python 没加到系统环境里。最简单的办法是重新安装 Python，安装时一定要勾选 "Add Python to PATH"。

2. 创建文件夹失败

可能是没权限，右键脚本选择 "以管理员身份运行" 试试。如果你的电脑没有 G 盘，或者 G 盘空间不够，打开脚本文件，把里面的G:\ESPHome改成其他盘（比如D:\ESPHome）就行。

3. 浏览器打不开localhost:6052

先看命令窗口有没有红色的错误提示，可能是 6052 端口被其他程序占用了。关掉脚本重新运行试试，还不行就重启电脑再试一次。

小结

到这里，ESP32-C3 接入米家的环境就全部搭建完成了！你已经成功安装了 ESPHome，并且能打开它的操作界面。接下来的设备配置的步骤，我们会在另一篇教程里详细说。

整个环境搭建过程其实很简单，跟着步骤做，遇到问题看解决方法，十分钟就能搞定。有疑问的话欢迎在评论区留言哦！