在做ESP32S3开发过程中，我发现ESP32的工作目录下有一个managed_components文件夹，体积还很庞大。查询了一下其作用，它是存放项目依赖组件使用。于是，深入的了解一下ESP-IDF是如何存放项目依赖组件的。

managed_components 文件夹‌作用

由ESP-IDF组件管理器自动创建和维护的核心目录，专门用于存放项目依赖的所有第三方托管组件。是实现依赖隔离、精确锁定组件版本、自动完成组件下载与完整性校验，避免手动管理第三方组件带来的版本冲突问题 。

• 它是IDF组件管理器的专属工作目录，所有从乐鑫组件注册表、Git仓库等渠道拉取的外部组件都会自动存放在这里 。

• 构建系统的组件搜索优先级中，它的位置仅次于项目根目录下的自定义components文件夹，高于ESP-IDF框架自带的官方组件目录 。

managed_components 文件夹‌目录结构

它的目录结构的规则非常值得我们学习，我以我项目的managed_components文件夹为例。

组件命名格式

所有托管组件以vendor__component_name形式命名，用双下划线分隔组件提供者标识和组件名，例如：

• espressif__esp_lvgl_port：乐鑫官方提供的LVGL图形库驱动

• lvgl__lvgl：LVGL官方提供的图形库

单组件内部结构每个子目录下都包含完整的组件运行所需文件：

• .component_hash、CHECKSUMS.json：用于校验组件文件完整性

• CMakeLists.txt、idf_component.yml：构建配置与组件元数据

• include/、src/：组件的头文件与源代码目录

我把CHECKSUMS.json打开看了一下，记录了每一个文件的校验值。换句话说，如此记录与校验之下，就是充分保障文件版本的一致性。使用了相同的工程，编译出来的固件一定是相同的。

managed_components 文件夹生成与删除

• 自动生成：当你在idf_component.yml中声明了外部组件依赖，执行idf.py build或idf.py reconfigure时，组件管理器会自动创建该文件夹并下载所有依赖组件 。

• 手动移除/禁用：如果希望完全脱离组件管理器、手动管理所有组件，可以在项目根目录的CMakeLists.txt中添加set(COMPONENT_MANAGER none)，之后将所需组件手动复制到项目的components目录下，再执行idf.py fullclean清理旧构建产物即可 。

总结

对于通过构建系统来编译的工程，依赖包的管理是一个必然。传统Keil开发环境下的文件夹管理，文件管理的方式已然不再适合。