Ubuntu命令行使用ESP-IDF V4.4编译提示找不到esp_nimble_hci.h

• 编译环境：已安装ESP-IDF V4.4的Ubuntu系统
• 异常表现：执行idf.py构建指令时编译失败，同一项目在Windows端Espressif IDE中可正常编译
• 已做操作：已在sdkconfig配置文件中启用BT（蓝牙）组件，构建时仍无法识别蓝牙组件相关头文件

main/ble.c:12:10: fatal error: esp_nimble_hci.h: No such file or directory
#include "esp_nimble_hci.h"
      ^~~~~~~~~~~~~~~~~~
compilation terminated.
[1049/1070] Building C object esp-idf/wifi_provisioning/CMakeFiles/__idf_wifi_provisioning.dir/src/scheme_softap.c.obj
ninja: build stopped: subcommand failed.
ninja failed with exit code 1

• 核对蓝牙栈配置：ESP-IDF V4.4版本中esp_nimble_hci.h是NimBLE蓝牙栈的专属头文件，仅开启通用BT开关、选用Bluedroid蓝牙栈时不会引入该头文件。执行idf.py menuconfig进入配置界面，依次进入Component config > Bluetooth > Bluetooth Host，选中NimBLE - BLE only选项，保存配置后退出。
• 补全组件依赖声明：打开项目main目录下的CMakeLists.txt，确认idf_component_register的REQUIRES字段中显式添加了nimble依赖，参考写法：

idf_component_register(SRCS "ble.c"
                       INCLUDE_DIRS "."
                       REQUIRES nimble)

Windows端IDE会自动索引部分组件路径，但命令行编译严格依赖CMake声明的依赖关系，缺少显式声明时会出现头文件找不到的问题。

• 清理构建缓存后重编译：旧的构建缓存、残留的sdkconfig配置会导致新配置不生效，在项目根目录依次执行以下命令：

idf.py fullclean
rm -f sdkconfig sdkconfig.old
idf.py set-target esp32  # 替换为你实际使用的目标芯片型号，如esp32s3、esp32c3
# 重新执行menuconfig确认NimBLE配置开启后，执行编译
idf.py build

• 确认终端环境加载正常：每次打开新的Ubuntu终端执行编译前，需要先运行ESP-IDF安装路径下的./export.sh脚本加载完整环境变量，避免组件路径索引异常。

内容的提问来源于stack exchange，提问作者Joe