使用 ESPHome 的核心指令

A. 烧录固件 (上传配置)

当你修改了 .yaml 配置文件（比如添加了开关、传感器）后，需要运行此命令将新代码编译并上传到 ESP32 设备。

esphome run esp32.yaml

• 如果自动找不到设备 ，请加上 --device 参数（结合你的情况）：

      esphome run esp32.yaml --device

• esphome logs esp32.yaml 查看实时日志 (调试神器)

清除配置 (恢复出厂)

当你把 ESPHome 设备搞乱了（比如设错了 WiFi 密码导致连不上），或者要换一个新设备使用时，运行此命令。它会擦除 ESP32 里的所有旧数据。

esphome clear-config esp32.yaml

仅编译 (不上传)

如果你只想检查代码有没有写错，或者你想生成 .bin 文件去其他地方刷机，用这个命令。它不会连接设备。

esphome compile esp32.yaml

仅编译并上传 (不先验证)

通常 run 命令包含编译和上传。这个命令强制重新编译并上传，跳过一些检查。

esphome upload esp32.yaml

检查配置 (验证语法)

在烧录之前，你可以先检查一下 YAML 文件有没有语法错误。

esphome config esp32.yaml

版本信息

查看你安装的 ESPHome 版本。

esphome version

查找设备 (串口命令)

这不是 ESPHome 的特有命令，而是 Linux 系统命令，但在使用 ESPHome 之前经常需要用到它。

• 列出所有 USB 转串口设备：

    ls /dev/ttyUSB* /dev/ttyACM*

• 列出所有设备的唯一 ID (推荐)：

    ls /dev/serial/by-id/

通过 Python 命令行安装（适合树莓派 OS / Ubuntu）

sudo apt update

sudo apt upgrade -y

sudo apt install python3 python3-pip python3-venv -y

pip3 install esphome

如果提示权限不足，加上 sudo:

sudo pip3 install esphome

创建一个文件夹存放 esphome

mkdir esphome-config

cd esphome-config

创建虚拟环境

python3 -m venv venv

激活虚拟环境

source venv/bin/activate

安装 esphome

pip install esphome

以后使用前，都要先执行 source venv/bin/activate

安装完成后，运行：

esphome version

一键安装脚本 (适合 Docker 用户)

如果你是用 Docker 运行 Home Assistant，可以使用官方的一键启动脚本：

# 运行官方安装脚本
curl -fsSL https://esphome.io/install.sh | sh

sudo pip3 install esphome

• esphome logs esp32.yaml

• 如果自动找不到设备 ，请加上 --device 参数（结合你的情况）：

    esphome run esp32.yaml --device

• 如果自动找不到设备 ，请加上 --device 参数（结合你的情况）：

    esphome run esp32.yaml --device