项目需先确认是否为标准Maven（含pom.xml）或Gradle（含build.gradle）结构；若无则可能为纯Java、Eclipse旧项目或脚本型项目，需手动识别源码路径或导入配置。
确认项目是否为标准 Maven 或 Gradle 结构
Java 项目能否顺利导入，第一关是识别构建工具。IDE（如 IntelliJ IDEA 或 VS Code + Extension）依赖 pom.xml（Maven）或 build.gradle（Gradle）自动配置依赖和源码路径。如果项目根目录下没有这两个文件，大概率不是标准构建项目——可能是纯 .java 文件堆叠、Eclipse 的 .project 旧工程，或手动管理 classpath 的脚本型项目。
实操建议：
- 先用终端进入项目根目录，运行
ls pom.xml build.gradle（macOS/Linux）或dir pom.xml build.gradle（Windows），确认存在哪个 - 若两者皆无，别急着点“Open Project”，先检查是否有
src/main/java目录结构——这是 Maven/Gradle 的约定路径；若只有src/且里面全是.java，可能需手动指定源根 - 遇到 Eclipse 项目（含
.project和.classpath），IntelliJ 可选 “Import Project” → 选该文件，但会提示转换，转换后原 Eclipse 配置即失效
用 IntelliJ IDEA 导入 Maven 项目时的常见卡点
即使有 pom.xml，IDEA 也可能卡在 “Loading project…” 或报错 “Cannot resolve symbol XXX”。这不是代码问题，而是本地环境没对齐。
关键原因和应对：
立即学习“Java免费学习笔记（深入）”；
-
MAVEN_HOME未设置或指向了精简版（如 macOS Homebrew 装的maven包常缺lib下完整 jar）→ 改用官方二进制包，并在 IDEA 的Settings → Build → Build Tools → Maven中手动指定Maven home path - 项目
pom.xml声明了 JDK 17，但 IDEA 默认使用嵌入式 JBR 11 → 进入Project Structure → Project → Project SDK，点击 “New… → JDK”，指向本地已安装的 JDK 17 根目录（不是bin子目录） - 依赖下载失败（尤其国内环境）→ 编辑
~/.m2/settings.xml，加入阿里云镜像配置，确保central https://maven.aliyun.com/repository/public
运行主类前必须核对的三项配置
导入成功 ≠ 能直接右键 Run。Java 启动失败八成出在运行配置（Run Configuration）上，而非代码本身。
务必检查：
-
Main class：不能只写类名（如
App），必须是全限定名（如com.example.App）。IDEA 通常能自动识别并填充，但如果类不在src/main/java下（比如在src/test/java），它不会默认列出 -
Use classpath of module：这个下拉框必须选对模块（module）。多模块项目中，若主类在
app模块，却选了common模块，就会报NoClassDefFoundError -
Working directory：某些项目读取
config.yml或data/目录，依赖相对路径。默认 working directory 是项目根目录，但如果项目期望在target/classes下启动，就得手动改成该路径
非标准项目（无构建文件）的手动编译与运行
遇到只有 src/ 和一堆 .java 的老项目，别删 src 再建新项目。可以靠 javac 和 java 手动走通流程，顺便理清依赖关系。
例如项目结构为：
my-old-app/
├── src/
│ ├── Main.java
│ └── utils/Helper.java
└── lib/
└── gson-2.8.9.jar
操作步骤：
- 编译：
javac -d out -cp "lib/*" src/*.java src/utils/*.java（out是输出目录，lib/*表示引入所有 jar） - 运行：
java -cp "out:lib/*" Main（macOS/Linux 用:分隔 classpath，Windows 用;） - 若报
Unsupported class file major version，说明javac和java版本不一致，统一用java -version和javac -version检查，必要时加-source 8 -target 8降级编译
最易被忽略的是：项目里看似没外部依赖，但某个 .java 文件 import 了 org.apache.commons.lang3.*，而你没配 lib 或没下对应 jar——这时候编译就过不去，得先反向从 import 推出缺什么，再补依赖。环境初始化不是一键的事，是读、试、调的闭环。
