跳到主要内容

离线安装 ESP-IDF

备注

以下环境设置适用于 Windows 10/11 系统，Mac/Linux 用户请参考 官方说明。

离线安装程序安装过程中不需要网络连接，安装程序中包含了所有需要的依赖文件。

1. 下载 ESP-IDF 工具安装器​

前往 ESP-IDF Windows Installer Download 下载离线安装工具。可以在页面顶部选择最新稳定版，也可以在页面底部选择所需版本。

下载最新稳定版

如需下载其他版本，建议选择 Mirror 下载链接，该镜像针对国内用户的下载速度进行了优化。

下载指定版本

2. 运行安装器​

运行安装器，按步骤完成安装：

  • 选择安装路径。推荐将 ESP-IDF 下载到 %userprofile%\Desktop\esp-idf 目录下，其中 %userprofile% 代表家目录。

    选择安装路径

  • 建议选择“完全安装”

    选择“完全安装”

  • 确认无误后点击“安装”，记住此处的各个路径。建议截图或拍照记录。

    确认设置

  • 看到此窗口说明安装成功。

    安装成功

3. 验证安装​

  • 在 Windows 10/11 开始菜单中的应用列表中到找到 ESP-IDF 文件夹，打开 ESP-IDF X.X CMD 或者 ESP-IDF X.X PowerShell。

    开始菜单

  • 输入 idf.py --version，成功输出版本号。

    ESP-IDF PowerShell

4. 搭配 VS Code 扩展​

提前下载并安装好 VS Code。

4.1 安装 ESP-IDF VS Code 扩展​

  • 进入 ESP-IDF 扩展安装程序下载地址：https://github.com/espressif/vscode-esp-idf-extension/releases

    在最新的 release 中 Assets 下载对应 esp-idf-extension-xxx.vsix。

    下载 esp-idf-extension-xxx.vsix

  • 打开 VS Code，按 F1 键或点击菜单 查看 -> 命令面板...，输入 从 VSIX 安装，点击 扩展：从 VSIX 安装。然后选择之前下载的 .vsix 文件来安装扩展。

    扩展：从 VSIX 安装
    提示

    你还可以以相同的方式安装 C 语言相关扩展，以获得代码高亮和代码导航功能。

4.2 配置 VS Code 扩展​

  1. 安装扩展后，VS Code 左侧活动栏中会出现 Espressif 图标 图标，点击该图标可查看 ESP-IDF 扩展的基本命令列表，在 Advanced 中选择 配置 ESP-IDF 扩展。

    选择“配置 ESP-IDF 扩展

  2. 选择 USE EXISTING SETUP

    USE EXISTING SETUP

    此时，ESP-IDF 扩展应该能够自动识别电脑上所有已安装的 ESP-IDF，选择刚刚安装的那个。若无法识别，选择 Serach ESP-IDF in system，手动添加路径。

    选择已存在的 ESP-IDF

至此，安装完成。

5. 参考链接​

最后由 wulu 于 更新