在IDEA中需通过“Add as Library…”显式添加本地Jar包并确保Scope为Compile，检查Dependencies列表；非Maven项目应将Jar置于lib/目录、用相对路径引用并提交至Git；打包时须在Artifacts中配置Extracted Directory或Library Files以包含Jar。
怎么在项目里让IDEA认出本地Jar包
IDEA不会自动扫描你随便丢进文件夹的.jar文件，必须显式告诉它“这个Jar是项目的一部分”。常见错误是把Jar复制到lib/目录就以为完事了——结果编译报错：Cannot resolve symbol XXX，或者运行时抛NoClassDefFoundError。
正确做法是通过模块依赖配置把它“注册”进项目结构：
- 右键项目根目录 → Add as Library…（不是“Add to Libraries”或拖拽）
- 选中你的
xxx.jar文件 → 点击OK - 确认弹窗里勾选的是当前模块（Module），不是“Global libraries”
- 检查
Project Structure → Modules → Dependencies里是否出现该Jar，且Scope是Compile
为什么有时候加了Jar还是编译不过
最常踩的坑是Jar被加到了错误的作用域（Scope），或者路径被IDEA缓存成旧状态。比如你改过Jar文件名但没刷新依赖，IDEA还在用旧的引用路径。
关键判断点：
立即学习“Java免费学习笔记（深入）”；
- 如果
import语句标红但Jar确实在Dependencies列表里 → 检查Scope是不是Provided或Runtime（编译期不可见） - 如果提示
package does not exist→ 右键项目 → Reload project（Maven项目）或 File → Synchronize（传统Java项目） - 如果Jar里有依赖其他Jar（比如某SDK自带
guava-31.1-jre.jar），它不会自动传递进来——你得手动把那些也加一遍
传统Java项目（非Maven）怎么避免路径硬编码
不要把Jar放在src/下，也不要用绝对路径（如C:\dev\libs\abc.jar）。一旦换机器或给同事共享，路径立刻失效。
推荐做法：
- 统一建
lib/子目录（和src/同级），把所有本地Jar放进去 - 添加依赖时，选择“Relative path”，IDEA会自动转成
$PROJECT_DIR$/lib/xxx.jar - 提交代码时，把
lib/目录一起加入Git（除非Jar太大，那就得配.gitignore并写清楚文档）
运行时找不到类？检查Artifact打包设置
加了依赖只是让编译通过，不等于运行时能加载。传统Java项目打Jar包（Build → Build Artifacts）时，默认不会把本地Jar打进输出包。
必须手动配置：
- 进入
Project Structure → Artifacts - 选中你的
jar输出项 → 点击+ → Extracted Directory→ 选中那个本地Jar - 或者选
+ → Library Files→ 找到对应Jar → 设置Output directory为lib/（保持目录结构） - 生成的
out/artifacts/目录下，应该能看到主Jar +lib/xxx.jar，且MANIFEST.MF里有Class-Path: lib/xxx.jar
漏掉这步，哪怕编译全绿，双击运行JAR也会直接崩在NoClassDefFoundError——而且IDEA的Run Configuration里默认不校验这个。
