本文记录在 Windows WSL2 的 Ubuntu 子系统中，使用乐鑫 EIM 工具安装 ESPIDF6.1 开发环境完整流程，包含 WSL 子系统启动失败报错处理、软件源配置、EIMCLI 安装、ESPIDF 部署与环境激活，整理实操步骤，适合想要在 Linux 子系统下做 ESP32 开发的同学参考。参考乐鑫官方网页：在 Linux 上安装 ESP-IDF 及工具链
环境搭建指南
1
WSL启动修复
部分同学在微软应用商店安装 Ubuntu 之后，会遇到启动子系统直接报错：Linux 的 Windows 子系统未启用 / 未安装分发版本。
·
以管理员身份打开 PowerShell，执行下面两条命令开启 WSL 与虚拟机平台功能
· 
·
执行完成后重启电脑；
·
·
将已安装的 Ubuntu 卸载，重新从微软商店安装 Ubuntu，再次启动即可正常初始化。
·
修复后Ubuntu正常启动效果：
小知识点：apt 是 Ubuntu 的包管理器，Ubuntu 属于 Debian 系列发行版，下文我们使用 apt 来安装乐鑫 EIM 工具。
2
EIM工具安装
EIM 是乐鑫推出的 ESPIDF 安装管理器，可以简化 ESPIDF 和配套工具链下载配置工作。 我们需要先把乐鑫的软件源添加到 apt 源列表。
如果只需要命令行操作，只安装eimcli即可：sudo apt install eim-cli
3
IDF在线安装
运行以下命令，在非交互模式下使用默认设置安装最新稳定版本的 ESP-IDF：eim install 执行后安装输出效果：
安装成功后终端将输出关键信息摘录：
重点：每次新开终端，都必须执行 source 脚本激活 ESPIDF 环境，否则 idf.py 命令无法识别。
4
环境激活配置
复制安装完成提示给出的激活脚本路径，在终端执行 source 命令加载环境变量：source "/home/yml/.espressif/tools/activate_idf_v6.1.sh"
小提醒：yml 是用户名，每个人的电脑用户名不一样，不要直接复制整条 source 命令，以自己终端打印出来的路径为准！环境激活结果演示如下：
5
实操贴士总结
·
WSL2 环境中，每打开一个新终端窗口，都需要重新 source 激活脚本，环境只对当前终端会话生效；
·
·
如果想要打开终端自动加载环境，可以把上面 source 命令写入~/.bashrc；
·
·
安装过程需要联网，国内网络慢的情况下可以配置国内镜像源加速下载。
·
本次在 WSL2 Ubuntu 环境借助乐鑫 EIM 工具，完成 ESPIDF6.1 版本完整部署。主要流程：开启 WSL2 功能→修复 Ubuntu 启动报错→添加乐鑫 apt 源→安装 eimcli→eim install一键安装 IDF→source 脚本激活开发环境。 后续就可以使用idf.py build、idf.py flash等命令编译烧录 ESP32 工程。
