Android Studio新手求助：无法解析符号'R'问题如何解决？

Hey there! I’ve been right where you are—staring at that annoying red squiggle under R when you’re just getting started with Android development, and the usual fixes (importing, cleaning/building) aren’t cutting it. Let’s dive into some deeper troubleshooting steps that often resolve this:

• First, hunt down XML errors (they’re the #1 culprit)
  The R class is auto-generated from your project’s XML resources, so even a tiny syntax mistake in any XML file will break it. Check every XML file:

  • Layouts (res/layout/): Look for unclosed tags, typos in attribute names (like android:layout_width misspelled), or invalid resource references.
  • res/values/ files (strings, colors, styles): Ensure resource names only use lowercase letters, underscores, and numbers—no spaces, uppercase, or special characters.
  • AndroidManifest.xml: Confirm your package name matches the one in your Java files (e.g., if your Java file starts with package com.example.andro.myapp;, the manifest’s package attribute should be the same).

• Double-check your module-level build.gradle
  Open the build.gradle file for your app module (not the project-level one) and verify:

  • compileSdkVersion and targetSdkVersion match an SDK Platform you’ve installed (check in SDK Manager). For example, if you’re targeting Android 14, both should be set to 34.
  • There are no typos or invalid dependencies. A broken dependency can prevent the R class from generating.

• Invalidate Caches & Restart (this is magic sometimes)
  Android Studio’s cache can get corrupted, which messes up auto-generated files like R. Do this:

  1. Go to File → Invalidate Caches...
  2. Check the box for "Invalidate and Restart"
  3. Let Studio restart and rebuild—this clears out stale cache files that clean/build doesn’t touch.

• Make sure you’re importing the right R
  If you accidentally imported android.R (the system’s default resource class), that’ll cause this error. Delete any line that says import android.R;, then let Android Studio auto-import your project’s R (or manually add import com.example.andro.youractualpackagename.R; replacing with your real package name).

• Verify your project structure is correct

  • Your Java files should live in src/main/java/com/example/andro/...—not in test or other non-source directories.
  • All resource files (layouts, drawables, etc.) must be in src/main/res/ with correct folder names (e.g., drawable, layout—no typos like drawablev24 instead of drawable-v24).

• Check your SDK setup
  Open Tools → SDK Manager and confirm:

  • You have the SDK Platform installed for your compileSdkVersion.
  • Your Build Tools version is compatible (usually, Studio will suggest the latest compatible one if there’s an issue).

If none of these work, try creating a brand new blank Android project. If the new project generates R correctly, compare its configuration files (build.gradle, AndroidManifest.xml) with your original project—you’ll likely spot a misconfiguration that’s breaking things.

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