Arduino CLI 构建缓存路径配置解析与优化建议

核心问题概述

Arduino CLI 作为 Arduino 项目的命令行工具，在构建过程中会产生多种类型的临时文件和缓存文件。当前版本（1.0.0）中，用户通过 build_cache.path 配置项或 ARDUINO_BUILD_CACHE_PATH 环境变量指定的缓存路径，仅能部分控制构建产物的存储位置，这导致了使用上的不一致性和困惑。

现有缓存机制分析

当前 Arduino CLI 的临时文件存储分为几个主要部分：

1. 核心组件缓存：默认存储在系统临时目录下的 arduino/cores 子目录中，包含已编译的核心组件对象文件等可重用构建产物。这部分确实受到 build_cache.path 配置的控制。

2. 项目构建缓存：默认存储在系统临时目录下的 arduino/sketches/[hash] 子目录中，包含特定项目的构建产物（对象文件等）。这部分目前不受 build_cache.path 配置影响。

3. 其他临时文件：包括下载的软件包解压目录、库索引下载临时文件等，分散在系统临时目录的不同位置。

技术实现细节

从代码层面看，构建缓存路径的处理主要涉及两个关键部分：

1. 核心组件缓存路径：由 commands/service_compile.go 中的相关代码处理，正确使用了配置的缓存路径。

2. 项目构建缓存路径：由 internal/arduino/sketch/sketch.go 处理，目前硬编码使用了系统临时目录，未考虑用户配置。

改进建议方案

基于技术讨论，理想的缓存路径管理应区分两类文件：

1. 真正临时文件

• 特点：创建后短时间内使用并删除，无需长期保存
• 建议位置：系统标准临时目录（遵循各平台规范）
• 处理方式：使用标准临时文件API创建，确保多用户场景下的权限安全

2. 可重用缓存

• 特点：可跨项目重用，保存时间较长
• 建议位置：
  • Linux: ~/.cache/arduino
  • macOS: ~/Library/Caches/arduino
  • Windows: AppData 相关目录
• 控制方式：统一由 build_cache.path 配置管理

具体改进方向

1. 统一缓存路径：所有可重用构建产物（包括核心组件和项目构建）都应遵循同一缓存路径配置。

2. 平台适配：使用标准API（如Go的os.UserCacheDir）获取平台合规的缓存目录。

3. 配置简化：移除不合理的细粒度配置（如项目级缓存路径），保持配置简洁性。

4. 构建路径处理：当用户明确指定构建路径(--build-path)时，考虑忽略全局缓存，强制重新构建核心组件。

用户影响评估

这些改进将带来以下用户体验提升：

1. 一致性：所有缓存文件集中管理，避免分散存储。

2. 可预测性：配置项行为更符合用户预期。

3. 可维护性：更容易清理缓存或指定特定缓存位置。

4. 跨平台兼容性：自动适应不同操作系统的文件存储规范。

总结

Arduino CLI 的构建缓存管理需要更系统化的设计，区分临时文件和可重用缓存的不同需求，并遵循各平台的最佳实践。通过统一缓存路径管理和合理的默认值设置，可以显著提升工具的可靠性和用户体验。