作为一名开发者或DevOps工程师，掌握在不同操作系统上搭建开发环境是一项基础但至关重要的技能。

Windows系统作为最常见的开发环境之一，其文件系统和命令行与Linux/macOS有着本质区别。很多新手在配置Java开发环境时，常常卡在Path环境变量、JAVA_HOME配置这些细节上。

今天这篇文章，我将手把手带你完成Windows系统上Java开发环境的完整配置，包括：

• 理解Windows与类Unix系统的核心差异

• 安装IntelliJ IDEA并导入Git项目

• 配置JDK并解决代码标红问题

• 运行第一个Spring Boot应用

• 配置Path环境变量让java命令全局可用

• 设置JAVA_HOME为Maven安装做准备

无论你是Windows 10还是Windows 11，这篇指南都适用。

一、Windows vs 类Unix：你必须知道的核心差异

在开始安装之前，先花几分钟理解Windows和Linux/macOS的几个关键区别。这能帮你避免很多配置中的困惑。

1. 文件系统差异

特性	Windows	Linux/macOS
根结构	多根（C:、D:等驱动器）	单根树形结构（/）
路径分隔符	反斜杠（\）	正斜杠（/）
设计哲学	设备、驱动为独立对象	一切皆文件
应用安装	集中在Program Files目录	分散到多个系统目录

Windows将每个硬盘分区视为独立的驱动器（C:、D:），而Unix系统只有一个根目录（/），所有存储设备都挂载在这个根目录下。

2. 命令行差异

Windows使用不同的Shell程序（CMD或PowerShell），因此大部分命令和Linux不兼容。只有cd、echo等少数命令是通用的。

功能	Windows命令	Unix/Linux命令
显示当前目录	chdir	pwd
显示时间	time	date
切换目录	cd	cd
创建目录	md	mkdir
打印输出	echo	echo

Windows原生更优化图形界面体验，命令行使用体验相对较差。很多开发者会选择安装第三方终端工具（如Git Bash、WSL）来获得更接近Unix的命令行体验。

二、安装IntelliJ IDEA并导入项目

1. 下载安装IntelliJ IDEA

IntelliJ IDEA是Java开发的首选IDE，社区版完全免费，满足所有开发需求。

• 打开浏览器搜索“IntelliJ download”

• 选择免费的Community版本下载

• 运行安装包，一路点击“下一步”，保持默认配置即可

2. 从Git克隆项目

启动IntelliJ后，我们可以直接从Git仓库克隆项目：

• 在欢迎界面选择“Get from VCS”（从版本控制系统获取）

• 输入Git仓库地址（课程提供的示例地址）

• 如果本地未安装Git，IntelliJ会提示自动下载，无需手动操作

• 点击“Clone”，等待项目拉取到本地

• 选择“Trust Project”（信任项目）

3. Maven项目自动识别

IntelliJ会自动识别这是一个Maven项目。检测到pom.xml文件后，它会：

• 自动开始解析和下载依赖

• 自动生成标准的Maven项目结构

• 自动集成Maven面板，可以查看依赖、插件和执行Maven生命周期操作

目前你不需要理解pom.xml的作用，只需保证项目可以正常打开即可。

三、配置JDK：解决代码标红问题

打开Java源文件后，你可能会发现代码全部标红，提示"Project JDK is not defined"。这是因为本地没有安装Java开发工具包（JDK）。

JDK是什么？ JDK全称Java Development Kit，是开发和运行Java应用的基础。没有JDK，IntelliJ无法解析Java语法，也无法运行Java程序。

1. 通过IntelliJ快捷安装JDK

IntelliJ提供了非常方便的JDK下载功能：

• 点击提示中的“Setup SDK”

• 选择“Download JDK”

• 版本选择：不要选最新版，因为部分新版JDK与后续要使用的Gradle不兼容

• 供应商保持默认（如Amazon Corretto）

• 点击下载，等待完成

2. 验证JDK配置

下载完成后，点击“Apply”应用设置。等待IntelliJ完成文件索引，所有代码标红会自动消失，说明JDK配置成功。

四、运行第一个Java应用

配置完成JDK后，我们就可以运行项目了：

• 找到入口类（带有@SpringBootApplication注解的Application.java）

• 点击左侧绿色的三角形

• 选择“Run”

IntelliJ会先构建项目，然后启动应用。启动日志会输出在Run控制台中，看到Spring Boot成功启动的信息，说明整个流程配置正确。

点击红色方块可以停止应用。

五、配置Path环境变量：让java命令全局可用

IntelliJ虽然安装了JDK，但JDK的路径没有自动添加到系统环境变量。这意味着在命令行中输入java -version会提示“命令无法识别”。

为什么需要配置Path？ 系统在查找命令时，会搜索Path变量中列出的所有目录。把java.exe所在的目录添加到Path后，你就可以在任何位置直接使用java命令。

1. 打开环境变量配置窗口

• 在Windows搜索框中输入“高级系统设置”

• 打开后点击“环境变量”

2. 理解用户变量和系统变量

• 用户变量：仅对当前用户生效

• 系统变量：对整台电脑所有用户生效

配置Java路径一般修改系统变量即可。

3. 编辑Path变量

• 在系统变量中找到“Path”，双击编辑

• 点击“新建”，填入JDK安装目录下的bin目录的完整路径

• 关键点：必须是bin目录，而不是JDK根目录。java.exe就存放在bin目录中

• 点击确定保存

4. 验证配置

配置完成后需要重启终端或IntelliJ才能生效。打开新的终端窗口，输入java -version，如果显示Java版本信息，说明配置成功。

六、配置JAVA_HOME：为Maven安装做准备

Maven是Java生态主流的项目构建工具，它本身基于Java开发，因此需要知道Java的安装位置。Maven通过JAVA_HOME环境变量来定位JDK。

1. 新建JAVA_HOME变量

• 再次打开环境变量配置窗口

• 在系统变量中点击“新建”

• 变量名：JAVA_HOME

• 变量值：填写JDK的根目录（不包含bin目录）

• 常见错误点：很多人误填成bin目录，这是错误的。JAVA_HOME需要的是JDK的根目录

2. 验证配置

配置完成后重启终端会话，输入以下命令验证：

echo %JAVA_HOME%

如果显示正确的JDK根目录路径，说明配置成功。

七、总结：Windows开发环境配置要点

步骤	操作	关键点
1	安装IntelliJ IDEA	选择Community版本
2	克隆Git项目	IntelliJ内置Git支持
3	安装JDK	不要选最新版，避免与Gradle冲突
4	配置Path	必须添加bin目录路径
5	配置JAVA_HOME	必须填写根目录，不是bin目录
6	验证运行	运行Spring Boot应用，确认成功

环境配置是每个开发者必须跨过的第一道门槛。遇到问题不要慌，按照步骤仔细检查，特别是路径和环境变量这些细节。掌握了这些，后面的开发之路就会顺畅很多。