解决 Arduino IDE 2.3.6 在 Windows 上无法启动：缺少 Documents 文件夹与注册表路径错误

作为一名 Arduino 爱好者，我最近在 Windows 上安装 Arduino IDE 2.3.6 时遇到了启动失败的问题：程序无窗口显示，日志报错提示 Unable to get Documents Folder: The system cannot find the file specified.。而旧版 Arduino IDE 1.x.x 却能正常运行。网上说的删各种文件我都试过了还是无效,最后是Arduino的英文社区上找到问题的.在经过排查，我发现问题源于用户目录缺少 Documents 文件夹和注册表路径配置错误。在这篇博客中，我将分享问题的原因、排查步骤和解决方案，希望能帮助其他遇到类似问题的朋友。

问题描述

我在 Windows 系统上安装了 Arduino IDE 2.3.6（安装路径为 D:\Tool\ArduinoIDE），但程序无法启动，没有任何窗口显示。在 PowerShell 中运行命令 & ".\Arduino IDE"，日志显示一个反复出现的错误：

Unable to get Documents Folder: The system cannot find the file specified.

日志还显示 arduino-cli 不断尝试启动并失败。相比之下，Arduino IDE 1.x.x 版本能够正常运行，说明问题与 2.x.x 的新架构有关。

问题原因

通过分析日志，我确定了两个主要原因：

1. 缺少 Documents 文件夹 ：Arduino IDE 2.3.6 依赖 arduino-cli，后者需要访问用户目录下的 Documents 文件夹（通常是 C:\Users\<用户名>\Documents）来存储草稿和配置文件。在我的系统中，C:\Users\hwq 下没有 Documents 文件夹，导致 arduino-cli 启动失败。
2. 注册表路径错误 ：Windows 注册表中的 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders\Personal 键未指向有效的 Documents 文件夹路径。

Arduino IDE 1.x.x 基于 Java，对 Documents 文件夹的依赖较少，因此不受此问题影响。

排查与解决步骤

以下是我诊断和解决问题的详细步骤：

步骤 1：检查并创建 Documents 文件夹

我打开文件资源管理器，导航到 C:\Users\hwq，确认 Documents 文件夹确实不存在。解决方法：

• 在 C:\Users\hwq 下手动创建 Documents 文件夹。
• 右键 Documents 文件夹，选择"属性" -> "安全"选项卡，确保我的用户账户具有"完全控制"权限。

步骤 2：修复注册表路径

我检查了注册表中的配置，发现问题：

1. 按 Win + R，输入 regedit 打开注册表编辑器。
2. 导航到 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders。
3. 找到 Personal 键，发现其值未指向 C:\Users\hwq\Documents。
4. 双击 Personal，将其值修改为 C:\Users\hwq\Documents。
5. 同样检查 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders 中的 Personal 键，确保路径一致。
6. 关闭注册表编辑器，重启电脑以应用更改。

步骤 3：清理配置文件

之前的错误可能导致配置文件损坏，我决定清理相关数据：

• 关闭 Arduino IDE（如果正在运行）。
• 删除以下文件夹（建议先备份）：
  • C:\Users\hwq\.arduinoIDE（包含 arduino-cli.yaml 等配置文件）。
  • C:\Users\hwq\AppData\Local\Arduino15（数据缓存）。
• 以管理员身份运行 D:\Tool\ArduinoIDE\Arduino IDE.exe，让程序重新生成配置文件。

步骤 4：测试启动

完成以上步骤后，我以管理员身份再次运行 Arduino IDE：

• 右键 D:\Tool\ArduinoIDE\Arduino IDE.exe，选择"以管理员身份运行"。
• 程序成功启动，窗口正常显示，日志不再报 Unable to get Documents Folder 错误。

经验教训与建议

1. 检查用户目录 ：确保 C:\Users\<用户名>\Documents 文件夹存在且可访问。这是 Arduino IDE 2.x.x 的关键依赖。
2. 验证注册表 ：非标准用户目录配置可能导致路径错误，检查并修正注册表中的 Personal 键。
3. 清理缓存 ：损坏的配置文件可能导致意外错误，定期清理 C:\Users\<用户名>\.arduinoIDE 和 AppData\Local\Arduino15。
4. 以管理员身份运行：某些权限问题可能影响启动，建议以管理员身份运行 IDE。
5. 备用方案：如果 2.x.x 版本仍有问题，可以回退到 1.x.x 版本（例如 1.8.19），或尝试稍旧的 2.x.x 版本（例如 2.3.2）。

结语

这次排查让我认识到 Arduino IDE 2.x.x 对用户目录的依赖以及注册表配置的重要性。通过新建 Documents 文件夹和修正注册表路径，我成功解决了启动问题。希望我的经验能帮助其他 Arduino 用户避免类似困扰。如果你有类似经历或更好的解决方案，欢迎在评论区分享！

---

相关资源：

• Arduino 官网：Software | Arduino
• Arduino IDE 历史版本：Software | Arduino