遇到 NoClassDefFoundError，先别急着怀疑 Jar 包损坏，多半是 Build Path 配置在背后作祟。比如 External JAR 未启用、Source Folder 设置不当、Order and Export 顺序混乱、甚至 Source attachment 路径填写错误——编译时一切正常，运行时类却“人间蒸发”。
外部 Jar 添加不进去、添加后报错 NoClassDefFoundError、点开类却看不到源码——这些问题的根源通常并非 Jar 本身，而是 Build Path 的配置顺序或 Source Folder 路径未能正确匹配。
为什么 Add External JARs 后仍然找不到对应的类
很多人以为点击 Add External JARs 就万事大吉，但 IDE 是否真的将其纳入编译和运行时类路径，往往被忽略。在 MyEclipse 的 Libraries 标签页中，Jar 必须出现在 Referenced Libraries 下并且前面带有勾选标记（即已启用），否则 IDE 不会将其纳入编译流程。
- 检查
Libraries列表中该 Jar 是否位于Modulepath或Classpath分组下（Ja va 9+ 项目需注意分组差异） - 若 Jar 出现在
Modulepath但项目采用 Ja va 8 编译级别，则可能导致静默失效 - 右键点击 Jar →
Properties→ 确认Path是有效的绝对路径，而非临时下载目录或已删除的 ZIP 文件 - 在 Web 项目中，如果 Jar 已放置在
WEB-INF/lib下，又手动通过Add External JARs重复添加，可能引发类加载冲突
Source Folder 设置错误会导致 package 报红
src 文件夹若未被设为 Source Folder，IDE 就不会将其视为源码根目录，package com.example; 会被当作子包处理，进而导致所有 import 和类名解析失败。这种情况在新建项目或从外部导入时尤为常见。
- 右键点击项目 →
Properties→Ja va Build Path→Source标签页 - 确保
src（或src/main/ja va）出现在Source folders on build path列表中；若不在，点击Add Folder手动添加 Output folder应指向bin（Ja va 项目）或WEB-INF/classes（Web 项目），不能设置为src自身或其子目录- 存在多个 Source Folder（如
src+src/test/ja va）时需分别配置，且不能嵌套（src/ja va不能同时将src和src/ja va都加入）
Source attachment 失效的典型场景
点开 String 能查看 JDK 源码，但点开第三方 Jar 中的类却弹出 “Source not found”——绝大多数原因在于 Source attachment 路径指向了错误类型文件或权限受限。
- 右键点击 Jar →
Properties→ 展开Source attachment→ 点击Edit... - 不要使用
External File指向未解压的.jar，除非该 Jar 明确附带-sources.jar（例如commons-lang3-3.12.0-sources.jar） - 若只有源码 ZIP，选择
External File；若已解压为文件夹，选择External Folder—— 两者不可混用 - 通过 MyEclipse 自带能力（如 Spring、Hibernate Capabilities）添加的 Jar，必须经由
Window → Preferences → MyEclipse → Project Capabilities进入对应框架版本页面配置源码，直接在项目 Build Path 中配置无效
Order and Export 顺序影响运行时行为
Build Path 中库的上下顺序决定了类加载优先级，尤其当多个 Jar 包含同名类（如不同版本的 slf4j-api.jar）时，位置靠上的会优先生效。这个细节在大型项目或依赖冲突排查时最容易被忽略。
- 选中某个 Jar → 点击右侧
Up/Down调整顺序；JRE System Library 建议保留在最上方 Export列的勾选控制该库是否随项目导出：勾选后，使用Export → Runnable JAR file才会将该 Jar 打包进去- 在 Web 项目中，
WEB-INF/lib下的 Jar 默认不勾选Export，因为容器会自动加载；手动添加的 External Jar 若勾选了 Export，可能导致重复加载报错
真正让人卡住的往往不是“怎么添加”，而是添加之后未验证路径有效性、未检查 Source Folder 是否被识别、也未留意 Order and Export 的隐式行为——这些细节在大型项目或跨团队协作时最容易被忽略。
