2、开发环境搭建：工欲善其事，必先利其器

好，咱们正式开始动手了。这一章我带你搭好开发环境。说白了，就是把你的电脑武装成一个能跟ESP32和HomeAssistant对话的工作站。我见过太多新手卡在这一步，其实没那么玄乎，一步步来就行。

2.1 Arduino IDE 安装与配置

先装Arduino IDE。这是咱们写代码、烧录固件的主力工具。我个人习惯用1.8.x版本，稳定，插件兼容性好。当然你用2.x也行，但有些老库可能不认。

安装步骤：

  1. 去官网下载对应你系统的安装包（Windows/Mac/Linux）。
  2. 双击安装，一路默认就行。注意安装路径别带中文，否则后面编译可能报错。
  3. 装完后打开，界面很简洁。嗯，先别急着写代码，咱们得先让它认识ESP32。
小提示： 如果你用Mac，记得装好USB转串口驱动。我有一回折腾了一下午，结果发现是驱动没装，尴尬。

2.2 ESP32 板级支持包安装

Arduino IDE默认不认识ESP32。你得给它装个“翻译官”——板级支持包。说白了就是告诉IDE：嘿，这块芯片长这样，引脚怎么用，内存多大。

安装方法：

  1. 打开Arduino IDE，点 文件 → 首选项。
  2. 在“附加开发板管理器网址”里，粘贴这个地址：
    https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
  3. 点确定。然后去 工具 → 开发板 → 开发板管理器。
  4. 搜索“ESP32”，找到由Espressif Systems提供的那个，点安装。
注意： 安装过程可能比较慢，因为要下载一堆工具链。建议挂个梯子，或者换个时间段再试。我曾经在公司网络下装了半小时没反应，回家一次搞定。

装完后，在 工具 → 开发板 里就能看到ESP32系列了。选你手头的那款，比如“ESP32 Dev Module”。

2.3 HomeAssistant 核心安装（Docker/虚拟机）

HomeAssistant是咱们智能家居的大脑。我推荐用Docker装，干净利落，升级也方便。当然，如果你对Docker不熟，用虚拟机也行。

Docker方式（我推荐）：

# 拉取最新镜像
docker pull ghcr.io/home-assistant/home-assistant:stable

# 运行容器
docker run -d \
  --name homeassistant \
  --restart=unless-stopped \
  -v /path/to/config:/config \
  -v /etc/localtime:/etc/localtime:ro \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

注意把 /path/to/config 换成你本地的配置目录。我习惯放在 /home/pi/ha_config 下，方便备份。

虚拟机方式（适合新手）：

  1. 下载HAOS的虚拟机镜像（.vmdk或.qcow2格式）。
  2. 用VirtualBox或VMware导入，分配2核CPU、2GB内存、32GB硬盘就够了。
  3. 启动后，它会自动安装。等几分钟，浏览器访问 http://你的IP:8123 就能看到界面。
关键点： 无论哪种方式，确保你的电脑和ESP32在同一个局域网内。否则后面设备发现会出问题。

2.4 HACS 插件商店安装

HACS是HomeAssistant的插件商店。有了它，你就能一键安装各种第三方集成、卡片、主题。我敢说，玩HA不装HACS，就像吃火锅没有蘸料——少了灵魂。

安装步骤：

  1. SSH进你的HA容器或虚拟机。Docker方式用 docker exec -it homeassistant bash。
  2. 执行以下命令：
wget -O - https://get.hacs.xyz | bash -
  1. 重启HA。然后去 配置 → 设备与服务 → 添加集成，搜索“HACS”。
  2. 按提示登录你的GitHub账号（没有就去注册一个，免费的）。
  3. 勾选所有设备类型，提交。搞定。
避坑指南： 我曾经因为GitHub账号没验证邮箱，卡在登录那一步半小时。所以记得提前验证好邮箱。

装好后，左侧菜单会多出一个“HACS”选项。点进去，琳琅满目的插件等着你。咱们后面会用到它来装ESPHome、MQTT等关键组件。

2.5 验证环境是否就绪

环境搭好了，咱们得验证一下。写个最简单的程序，让ESP32的LED闪起来。

void setup() {
  pinMode(2, OUTPUT);  // 大多数ESP32开发板，LED接在GPIO2
}

void loop() {
  digitalWrite(2, HIGH);
  delay(1000);
  digitalWrite(2, LOW);
  delay(1000);
}

选好开发板和端口，点上传。如果看到板子上的LED一秒闪一次，恭喜你，环境搭建成功！

总结一下： 这一章咱们搞定了Arduino IDE、ESP32板级支持包、HomeAssistant核心和HACS。接下来，你就可以正式开始写代码、接传感器了。记住，环境搭好了，后面的事就顺了。
← 上一章 📖 返回目录 下一章 →