A01 开发环境与第一个 Java 程序（IDEA / JDK / Maven 基础）

【本节目标】

学完这一篇，你应该能做到：

1）知道 JDK/JRE/JVM 分别是什么，选哪个版本更合适

2）在 IntelliJ IDEA 正确配置 Project SDK / Language Level

3）理解 Maven 的作用、目录结构，以及常见配置（本地仓库/镜像）

4）创建一个 Maven 项目并成功运行第一个 Java 程序（HelloWorld）

5）知道"运行成功但环境不对"的常见坑怎么排查

一、你需要准备什么（最少配置清单）

建议你用下面这套"稳定组合"（适合长期写专栏、做项目）：

1）JDK：推荐 JDK 17（LTS，兼容性好）

2）IDE：IntelliJ IDEA（你已经在用）

3）构建工具：Maven（IDEA 自带也行，但建议理解配置）

4）（可选）Git：后面你整理代码和专栏配套仓库会用到

说明：

如果你公司项目仍然用 JDK 8，也没问题。你可以本机装多个 JDK，IDEA 项目级别选择即可。
你专栏建议统一用 JDK 17（更主流，也能覆盖很多新特性），遇到 JDK 8 差异时单独说明。

二、JDK / JRE / JVM 到底是什么（别背概念，记住关系）

很多初学者会混，这里用一句话说清：

JVM：Java 虚拟机，负责"运行字节码 .class"
JRE：运行环境 = JVM + 运行所需核心类库（能跑程序）
JDK：开发工具包 = JRE + 编译/调试等工具（能写能编译）

你写代码、编译代码，需要的是 JDK。

所以"开发环境"一定要装 JDK，而不是只装 JRE。

三、IDEA 里必须确认的 3 个设置（最容易踩坑）

你打开 IDEA 后，建议检查这三个地方：

1）Project SDK

路径：File → Project Structure → Project

Project SDK：选你安装的 JDK（例如 17）
Project language level：建议和 JDK 对齐（17 对应 17）

2）Module SDK（有些项目会单独设模块）

路径：Project Structure → Modules

确认每个模块 SDK 没乱掉

3）Maven 使用的 JDK

路径：Settings → Build, Execution, Deployment → Build Tools → Maven

Maven 的 JDK（或 Runner 的 JRE）建议也选同一个 JDK

否则会出现：项目用 JDK17，但 Maven 编译用 JDK8，导致各种奇怪报错。

四、Maven 是干什么的（你先抓住它的"核心价值"）

Maven 在项目里主要解决三件事：

1）依赖管理：你不用手动拷贝 jar 包，写在 pom.xml 里就能自动下载

2）统一项目结构：src/main/java、src/test/java、resources 等

3）构建与打包：编译、测试、打包成 jar/war

你现在先把 Maven 当作"Java 项目统一管理工具"，后面我们再深入生命周期、插件、依赖冲突排查。

五、创建第一个 Maven 项目（建议步骤）

在 IDEA 中：

1）New Project

2）选择 Maven

3）GroupId：建议用你自己的统一命名，例如：com.cz (你也可以换成自己的)

4）ArtifactId：例如：java-a01-hello

5）选择 JDK（刚才说的 Project SDK）

创建后，你会看到类似结构：

src
- main
  - java（写主代码）
  - resources（放配置文件）
- test
  - java（写测试代码）
pom.xml（Maven 配置核心文件）

六、第一个 Java 程序：HelloWorld（最小可运行）

操作步骤：

1）在 src/main/java 下新建包（例如 com.cz.hello）

2）新建类 HelloWorld

3）写入下面代码

4）右键运行 main 方法

java 复制代码

package com.cz.hello;

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello Java!");
    }
}

运行成功的标志：控制台输出一行文本（例如 Hello Java!）

七、你必须知道的"编译与运行"区别

很多人只会点 IDEA 的绿色三角，但不理解背后发生了什么。

你写的 .java 文件，不是直接运行的。

过程是：

1）编译：javac 把 .java → .class（字节码）

2）运行：java 把 .class 交给 JVM 执行

IDEA 帮你把这一步封装了，但你知道这一点，后面理解 Maven、JVM、部署会轻松很多。

八、常见坑

坑 1：能运行，但版本不对（比如用到了 var，却报错）

原因：Language Level 或 Maven 编译版本没对齐

解决：统一 Project SDK + Language Level + Maven JDK

坑 2：Maven 下载依赖很慢 / 卡住

原因：默认中央仓库慢、网络问题

解决：A01-扩展

坑 3：中文乱码

原因：文件编码、控制台编码不一致

解决：IDEA 里统一 UTF-8，并在运行配置里确认编码

坑 4：同一个项目在别人电脑能跑，你的不能

原因：JDK 路径不同、Maven 环境不同、缓存问题

解决：先从版本与路径一致开始排查，再清理 Maven 缓存/重导入

九、本节小结

1）开发必须装 JDK（不是 JRE）

2）IDEA 至少要确认：Project SDK / Language Level / Maven JDK

3）Maven 解决依赖管理、统一结构、构建打包

4）HelloWorld 不重要，重要的是你理解"编译 → 运行"的链路

下一篇预告

《A02 Maven 基础配置：本地仓库、镜像、项目编码与常见问题（IDEA实战）》