Android Studio启动提示No Android SDK found 新手求助安装遗漏排查指引

Hey there! Don’t worry—this is a super common hiccup when starting out with Android development, and we can work through it step by step. Let’s walk through the most likely issues and fixes:

1. Did you skip the SDK download during initial setup? #

When you first launch Android Studio, it runs a Setup Wizard that includes downloading the core Android SDK (SDK Platforms, SDK Tools, and Build Tools). If you canceled this step, had a network issue, or the download didn’t complete, Android Studio won’t find the SDK later.

• Fix: Re-run the Setup Wizard by going to File > New > New Project (this might trigger the wizard again) or manually open the SDK Manager via File > Settings > Appearance & Behavior > System Settings > Android SDK (Windows/Linux) or Android Studio > Settings > ... (Mac) to start the download.

2. Verify Android Studio is pointing to the correct SDK path #

Sometimes the SDK is installed, but Android Studio isn’t looking in the right place:

• Open Android Studio’s settings and navigate to the Android SDK section (same path as above).
• Check the Android SDK Location field—if it’s blank or shows an invalid path:
  • Click Edit to either select an existing SDK folder on your machine, or choose the option to download a new SDK to a location you pick (stick to a user-accessible folder, like your home directory, to avoid permission issues).

3. Check folder permissions for the SDK #

If your SDK is stored in a system-protected folder (like C:\Program Files on Windows, or /Library on Mac), Android Studio might not have read/write access to it:

• Fix: Move the entire SDK folder to a user-owned directory, e.g.:
  • Windows: C:\Users\YourUsername\Android\Sdk
  • Mac: ~/Library/Android/sdk
• Then update the SDK path in Android Studio’s settings to point to this new location.

4. Validate environment variables (optional but helpful) #

In some cases, incorrect environment variables can cause SDK detection issues:

• Windows:
  • Open System Properties > Advanced > Environment Variables.
  • Create a new system variable named ANDROID_SDK_ROOT (or ANDROID_HOME) with the path to your SDK folder.
  • Add %ANDROID_SDK_ROOT%\platform-tools and %ANDROID_SDK_ROOT%\tools to the Path variable.
• Mac/Linux:
  • Open your terminal config file (e.g., ~/.zshrc for Mac, ~/.bashrc for Linux).
  • Add these lines:

    export ANDROID_HOME=~/Library/Android/sdk
    export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools
    

  • Save the file and run source ~/.zshrc (or equivalent) to apply changes.

5. Repair a corrupted SDK installation #

If your SDK files are damaged (e.g., incomplete downloads), Android Studio won’t recognize it:

• Open the SDK Manager, go to the SDK Tools tab.
• Check Show Package Details to see specific versions.
• Uninstall the problematic SDK Platforms/Build Tools, then re-download them.
• Alternatively, delete the entire SDK folder and start fresh with a new download via Android Studio.

If none of these steps resolve the issue, feel free to share more details (like your OS, Android Studio version) and we can troubleshoot further! 😊

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