企业官网建设流程全解析

P17 · 程序包不存在 / 找不到符号：依赖没引进来

场景还原：项目里用 fastjson 写 JSON，代码是同事给的，明明看着没问题，一编译：

错误: 程序包com.alibaba.fastjson不存在 错误: 找不到符号 String json = JSON.toJSONString("hello");

“找不到符号”——你要用的这个类/方法，编译器的 classpath 里根本没有。绝大多数情况是：依赖没加、加了没刷新、或者干脆 import 错了。

一、问题现象

直接编译一个引用了 fastjson 却没有引入该依赖的类，真实报错：

DepMissingDemo.java:1: 错误: 程序包com.alibaba.fastjson不存在 import com.alibaba.fastjson.JSON; ^ DepMissingDemo.java:7: 错误: 找不到符号 String json = JSON.toJSONString("hello"); ^ 符号: 类 JSON

二、出错代码

importcom.alibaba.fastjson.JSON;// fastjson 是第三方库，没引依赖它就不存在publicclassDepMissingDemo{publicstaticvoidmain(String[]args){// 没有在项目里引入 fastjson 依赖（IDEA 里通常是 Maven/Gradle 没下载/没刷新）Stringjson=JSON.toJSONString("hello");System.out.println("结果: "+json);}}

三、为什么会这样

Java 用全限定类名（如com.alibaba.fastjson.JSON）识别类。编译器编译时，会拿着这个类名去 classpath（依赖路径）里找对应的 .class——找不到就报"程序包不存在"或"找不到符号"。

同一个报错，背后通常是这几种情况，排查方向完全不同：

关键区分：“程序包不存在”→ 整个包都没找到（通常是没加依赖或依赖没刷新）；“找不到符号”→ 包找到了但类/方法名不对（或类没编译进来）。

四、怎么解决

第一步（90% 的情况）：把依赖加进项目并刷新。

Maven 项目在pom.xml加依赖后，右侧 Maven 面板点刷新按钮（Reload All Maven Projects）：

<dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.83</version></dependency>

Gradle 项目同理，改完build.gradle后在 Gradle 面板点刷新。

刷新后去Project Structure → Libraries（或 External Libraries）确认 jar 已经出现——肉眼可见才算数。

第二步：确认 import 写对了：对照 Maven 仓库里真实的包名/类名（比如 fastjson 1.x 的类是com.alibaba.fastjson.JSON，2.x 换成了com.alibaba.fastjson2.JSON——版本大升级包名也变了，这是常见的"复制老代码在新版本炸"）。

第三步：手动管理 jar 的老项目，编译运行都要显式加 classpath：

javac-encodingUTF-8-cplib/fastjson-1.2.83.jar YourClass.javajava-cp.:lib/fastjson-1.2.83.jar YourClass

第四步：多模块 Maven 项目——A 模块用到的依赖要在 A 自己的 pom.xml 里声明（依赖不会自动跨模块继承，除非配了 parent 管理）。

第五步：还不行就"兜底三板斧"：

1. File → Invalidate Caches / Restart重启 IDEA；
2. 删除本地仓库里损坏的 jar：rm -rf ~/.m2/repository/<groupId路径>后重新刷新下载；
3. 命令行验证依赖能不能解析：mvn dependency:resolve。

五、防坑总结

• "程序包不存在"先查依赖：加没加、刷新没刷新、External Libraries 里有没有；
• 抄代码时把依赖声明一起抄过来（pom/gradle），这是"找不到符号"的第一大来源；
• 库的大版本升级可能改包名（fastjson1 → fastjson2），import 要跟着改；
• 多模块项目每个模块各自声明自己用到的依赖；
• IDEA 刷新后仍报错，Invalidate Caches 重启是最后的大招。

下一篇：P18 · 中文乱码：控制台输出乱码、文件编码不一致