如何在Arduino IDE中安装ESP32支持？Git操作遇阻求助

Let's walk through the most common issues that pop up when running this command for ESP32 Arduino IDE support, and how to fix them:

1. Permission Errors on Windows #

If you're seeing Permission denied or access-related errors, it's almost always because your sketchbook directory is in a protected Windows area (like C:\Program Files or even C:\Users\<YourName>\Documents with restricted permissions).

• Fixes:
  • Right-click Git Bash and select Run as administrator before executing the command. This gives Git the necessary access to modify files in protected folders.
  • Alternatively, move your Arduino sketchbook to a non-restricted location (e.g., C:\ArduinoSketchbook), then update the path in Arduino IDE via File > Preferences > Sketchbook location. Navigate to this new directory in Git Bash and try the command again.

2. Network or Clone Failures #

Slow, unstable networks, or regional restrictions can cause submodules to fail to clone. You might see errors like fatal: unable to access or fetch failed.

• Fixes:
  • Retry the command a few times—sometimes a simple retry works if it was a temporary blip:

    git submodule update --init --recursive
    

  • If you're behind a corporate proxy, configure Git to use it first (replace with your proxy details):

    git config --global http.proxy http://your-proxy-address:port
    git config --global https.proxy https://your-proxy-address:port
    

    When you're done, you can unset the proxy settings with:

    git config --global --unset http.proxy
    git config --global --unset https.proxy
    

3. Outdated Git Version #

Older Git versions (pre-2.10) might not support some submodule command flags properly, leading to unexpected errors.

• Fix:
  • Check your current Git version with git --version. If it's outdated, download and install the latest stable version. Restart Git Bash after updating, then run the submodule command again.

4. Navigated to the Wrong Directory #

It's easy to end up in the wrong folder by mistake—make sure you're inside the arduino-esp32 subdirectory of your sketchbook's hardware/espressif folder.

• Fix:
  • Navigate step-by-step to avoid mistakes:

    cd "C:\Your\Full\Sketchbook\Path"
    cd hardware/espressif/arduino-esp32
    git submodule update --init --recursive
    

  • Verify your current directory with pwd to confirm you're in the right spot before running the command.

5. Corrupted Local Git Cache #

A corrupted local repository cache can cause weird, unexplained errors when dealing with submodules.

• Fix:
  • Clean the cache and reset the repository (note: this will discard any local changes you've made, so only do this if you haven't modified files):

    git clean -fd
    git reset --hard HEAD
    git submodule update --init --recursive
    

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