很多朋友搜“eclipse配置sdk”时，其实是想把Eclipse调教成一个能写安卓或Java的IDE，但核心答案很简单：90%的报错都不是代码问题，而是JDK路径和SDK路径没配对。这里说的配对，指的是Eclipse里配置的JRE版本、SDK版本和你电脑环境变量里的路径必须指向同一个位置，今天咱们就把这事儿彻底捋顺，保证你看完照着做，半小时内让Eclipse乖乖认到SDK。
为什么你的Eclipse不认SDK：先分清两种“sdk”
大家嘴上说“eclipse配置sdk”，实际上遇到的困境分两种，多数人自己都没区分清楚，第一种是配置Java开发环境，也就是JDK；第二种是配置安卓开发环境，也就是Android SDK，这俩不是一个东西，混淆了就容易出现“我明明下载了sdk为什么Eclipse不认我”的尴尬。
认准JDK：Eclipse跑起来的“发动机”
Eclipse本身就是个Java程序,没有JDK它连启动都费劲，很多朋友直接从网上下载了一个Eclipse绿色版，双击打不开，或者报错“Failed to create the Java Virtual Machine”，十有八九是JDK没装或者环境变量没配好。
配置JDK的步骤极其简单,但细节坑人：
- 去甲骨文官网下载JDK,注意千万别下成JRE，JRE是运行环境，Eclipse开发需要的是编译环境。
- 安装时记住安装路径,比如
C:\Program Files\Java\jdk-21，后面配置路径时要用。 - 右键“此电脑” →“属性”→“高级系统设置”→“环境变量”，在“系统变量”里新建
JAVA_HOME，变量值填你的JDK安装根目录。
行业共识认为,Java开发环境配置中最容易翻车的不是变量名，而是Path这个变量，很多人把%JAVA_HOME%\bin直接追加在Path后面，结果前面有个别的Java路径先被找到了，导致版本错乱，在cmd里输入java -version验证一下最稳妥，如果显示的版本和你装的不一样，那就是Path顺序问题。
认识Android SDK：Eclipse做安卓的“原料库”
如果你是要用Eclipse写安卓老项目,那配置的步骤又不一样，Android SDK是一大堆工具包、平台文件、构建工具的总称，Eclipse本身不认识这些，需要通过ADT插件（Android Development Tools）来搭桥。
这里有个关键背景信息需要说明：谷歌早就停止了对Eclipse ADT插件的官方维护，主流安卓开发早换到Android Studio了，所以现在还在折腾“eclipse配置android sdk”的朋友，大概率是学校课程要求、公司老项目维护，或者单纯的怀旧，既然是现实需求，我们还是要给出能用、可验证的方案。
第一步：下载旧版SDK，别用新版命令行工具
去安卓开发者官网下载commandlinetools，注意要选Windows版本，下载完解压后，里面的目录结构是这样的：cmdline-tools文件夹里有一个latest目录，bin目录下是sdkmanager.bat。
这一步很多人会卡住,因为新版SDK管理器默认装的是最新API，而Eclipse ADT插件对API级别有兼容性限制，不支持太新的平台，业内专家的建议是，如果你打算用Eclipse，最好下载API 30或更早的Android平台，方法是在命令行里运行：
sdkmanager --list
sdkmanager "platform-tools" "platforms;android-30" "build-tools;30.0.3"
这条命令会下载你指定的SDK平台到默认目录,默认目录一般是%LOCALAPPDATA%\Android\Sdk，这个路径记好，后面要在Eclipse里用。
第二步：设置ANDROID_HOME环境变量
和JDK一样,Android SDK也需要环境变量：
- 新建系统变量
ANDROID_HOME，变量值填你的SDK安装路径。 - 在Path里追加
%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools。
这样做的意义在于,Eclipse插件在找SDK位置时，很多时候会优先读环境变量，而不是等你手动指定，配置完记得重启Eclipse，因为环境变量的读取时机是Eclipse启动时。
Eclipse内部配置：菜单里的“人肉对接”
环境变量配好了,Eclipse不一定会自动识别，你需要告诉Eclipse“我的JDK在哪”“我的SDK在哪”，这就像新舍友来了得先登记一下。
Window → Preferences 里的关键设置
依次打开Window→Preferences，在左侧列表里找到Java相关的选项：
- 展开
Java→Installed JREs，点击Add，选择Standard VM，在JRE home里填你的JDK路径（比如C:\Program Files\Java\jdk-21），Eclipse会扫描到这个目录下的bin文件夹，自动识别。 - 这里有一个实操细节：如果你是64位系统，却装了32位的JDK，Eclipse启动时会报“Failed to load the JNI shared library”，所以安装JDK的位数必须和Eclipse版本一致
。
告诉Eclipse去哪找Android SDK
在Preferences里展开左侧的Android（前提是你已经装了ADT插件），右侧面板第一个输入框就是SDK Location，把刚才下载SDK的路径填进去，比如C:\Users\你的用户名\AppData\Local\Android\Sdk，Eclipse马上会列出可用的平台API。
如果你在Preferences里压根找不到Android这个选项，别急，这说明ADT插件还没装成功，安装ADT的正确姿势是这样的：
- 在Eclipse顶部菜单栏选
Help→Install New Software。 - 在
Work with输入框里填入ADT插件的更新站点地址。 - 勾选
Developer Tools，一路Next，接受协议，等它装完重启Eclipse。
这里有个反直觉的地方：虽然谷歌停止维护了，但老版本Eclipse玩家里仍流传着覆盖性说法，即从在线仓库安装稳定性更高，因为你在本地下载的ADT ZIP可能和Eclipse版本不兼容。
配置完成后必做的验证动作
别急着写代码,先做三件事验证你的“eclipse配置sdk”是否真正成功：
- 在Eclipse里新建一个
Android Application Project，看能不能正常走完向导，如果新建项目时的图标是灰色的，说明SDK路径没被识别。 - 在项目上右键,选择
Run As→Android Application，让模拟器跑起来，很多新手卡在模拟器起不来，但这不是SDK配置的锅，是AVD（安卓虚拟设备）的CPU/ABI设置问题，跟本文无关。 - 用cmd打开命令行,全部路径用绝对路径执行
adb devices，如果能看到List of devices attached，说明SDK工具链和Eclipse之间的通讯没问题。
常见报错速查表：遇到这些提示别慌
| 报错信息 | 原因 | 解决办法 |
|---|---|---|
SDK location not found |
Preferences里的路径填错，或环境变量未生效 | 检查路径是否为SDK根目录，确认后重启Eclipse |
Failed to find target android-XX |
你指定了API级别，但SDK Manager里没下载对应平台 | 用sdkmanager命令下载缺失的platform |
Unsupported major.minor version |
JDK版本太高，和Eclipse版本不匹配 | 换用JDK 8或JDK 11，或升级Eclipse版本 |
java.lang.NullPointerException 在ADT插件里报错 |
安卓项目里用了太新的构建工具 | 降低build-tools版本到30.0.3或以下 |
为什么用Eclipse配置sdk这么折腾？聊点实在的
环境变量、插件、路径……一套流程走下来，你可能觉得太繁琐了，说实话，现在新学安卓的朋友完全没必要这样做，直接装Android Studio自带SDK，省事得多，但这不意味着“eclipse配置sdk”的知识就没用了它负责解决兼容性这个老问题，Eclipse在JSP、SSM框架项目研发上的熟练度是安卓虚拟机方案替代不了的，你搜“eclipse配置android sdk报错”时翻到的帖子多半来自2015年以前，内容过时了但地址还挂在首页，这就是一个典型陷阱。
据不完全统计,网络上关于Eclipse的教程有较大比例是照搬旧版本的，连Eclipse版本号和ADT版本的对应关系都没讲清楚，给你的建议是：先看Eclipse的About Eclipse界面，确认版本号是以20xx开头的，再去匹配对应的ADT版本，总之你只需要记住一个原则能用Android Studio解决的事，不推荐用Eclipse硬刚；但如果你必须用Eclipse，就用最笨的版本组合：Eclipse 4.5 + JDK 8 + API 30以下的SDK，这是成功率最高的配伍。
最后的收尾结论很简单：eclipse配置sdk的成败核心在于三个路径的精确匹配JDK安装路径、SDK存放路径、Eclipse内部偏好设置路径，三者同时指向正确位置才能跑通安卓开发，否则就是白折腾。
常见问题：配置过程中大家反复问的事
eclipse配置sdk时，环境变量配了没反应是什么情况？
优先级最高的排查方向是检查你是在“用户变量”还是“系统变量”里配的，两者的区别在于用户变量只对当前登录用户生效，如果你的Eclipse是另一个用户身份安装的，自然读不到，另外改完环境变量必须重新打开cmd，因为在修改前已经打开的终端持有旧的环境变量快照，不会自动刷新。
eclipse配置sdk路径时，选了路径但一直提示不是有效目录，为什么？
出现这个提示,多数情况是路径指到了SDK根目录的上一层或下一层，举个例子，你已经下载好的SDK里应该能看到platforms、build-tools、platform-tools这些文件夹，如果看不到，说明你的cmdline-tools只是SDK管理器，不是SDK本体，需要先运行sdkmanager命令下载平台文件，你的指定路径下才会有这些目录，这个操作是绕不开的。