警告
This document is not updated for ESP32C5 yet, so some of the content may not be correct.
This warning was automatically inserted due to the source file being in the add_warnings_pages list.
IDF Windows 安装程序
命令行参数
IDF Windows 安装程序 esp-idf-tools-setup 提供以下命令行参数：
/CONFIG=[PATH]- 指定ini配置文件的路径，覆盖安装程序的默认配置。默认值：config.ini。/GITCLEAN=[yes|no]- 在以离线模式安装时，执行git clean命令，并删除未跟踪的目录。默认值：yes。/GITRECURSIVE=[yes|no]- 递归克隆所有 Git 仓库子模块。默认值：yes。/GITREPO=[URL|PATH]- 指定克隆 ESP-IDF 仓库的 URL。默认值：https://github.com/espressif/esp-idf.git。/GITRESET=[yes|no]- 在安装过程中，启用或禁用对仓库的git reset操作。默认值：yes。/HELP- 显示 Inno Setup 安装程序提供的命令行选项。/IDFDIR=[PATH]- 指定安装目录的路径。默认值：{userdesktop}\esp-idf}。/IDFVERSION=[v4.3|v4.1|master]- 使用指定的 ESP-IDF 版本，如 v4.1、v4.2、master。默认值：empty，选取列表中的第一个版本。/IDFVERSIONSURL=[URL]- 使用 URL 下载 ESP-IDF 版本列表。默认值：https://dl.espressif.com/dl/esp-idf/idf_versions.txt。/LOG=[PATH]- 在指定目录中存储安装日志文件。默认值：empty。/OFFLINE=[yes|no]- 在离线模式下，使用pip执行。通过设置环境变量PIP_NO_INDEX，也可在离线模式下安装 Python 软件包。默认值：no。/USEEMBEDDEDPYTHON=[yes|no]- 使用嵌入式 Python 版本完成安装。将此参数设置为no，可以在安装程序中选择 Python 版本。默认值：yes。/PYTHONNOUSERSITE=[yes|no]- 在启动任意 Python 命令前，设置PYTHONNOUSERSITE变量，避免从 AppDataRoaming 加载 Python 软件包。默认值：yes。/PYTHONWHEELSURL=[URL]- 指定 PyPi 存储库的 URL，以解析二进制 Python Wheel 依赖关系。设置环境变量PIP_EXTRA_INDEX_URL可以实现相同效果。默认值：https://dl.espressif.com/pypi。/SKIPSYSTEMCHECK=[yes|no]- 跳过系统检查页面。默认值：no。/VERYSILENT /SUPPRESSMSGBOXES /SP- /NOCANCEL- 执行静默安装。
静默安装
通过设置以下命令行参数，可以静默安装 ESP-IDF：
esp-idf-tools-setup-x.x.exe /VERYSILENT /SUPPRESSMSGBOXES /SP- /NOCANCEL
在命令行中运行安装程序时，它会在后台启动一个独立的进程执行安装操作，而不会阻塞命令行的使用。通过以下 PowerShell 脚本可以等待安装程序完成：
esp-idf-tools-setup-x.x.exe /VERYSILENT /SUPPRESSMSGBOXES /SP- /NOCANCEL
$InstallerProcess = Get-Process esp-idf-tools-setup
Wait-Process -Id $InstallerProcess.id
自定义 Python 版本及 Python Wheel 位置
IDF 安装程序默认使用嵌入的 Python 版本，并参考预定义的 Python Wheel 镜像获取所需软件包。
以下参数支持自定义 Python 版本及 Python Wheel 位置：
esp-idf-tools-setup-x.x.exe /USEEMBEDDEDPYTHON=no /PYTHONWHEELSURL=https://pypi.org/simple/