如何在IDEA中创建第一个Java项目：从零开始的完整指南
对于Java初学者来说，选择一款趁手的开发工具至关重要。IntelliJ IDEA（简称IDEA）凭借其智能的代码补全、强大的重构能力和丰富的插件生态，已经成为全球Java开发者最钟爱的集成开发环境之一。掌握在IDEA中创建第一个Java项目的方法，就像是拿到了通往Java世界的钥匙，后续所有的学习和开发都将以此为基础展开。
本文将从环境准备、项目创建、代码编写到常见问题排查，一步步带你走完整个过程。无论你是完全零基础的新手，还是刚接触IDEA的转行者，读完这篇文章后都能独立创建并运行自己的第一个Java程序。
一、创建前的环境准备：打好地基才能盖高楼
在正式创建项目之前，有两样东西必须提前准备好：JDK和IDEA本身。缺少任何一个，都无法顺利完成开发环境的搭建。
1.1 安装JDK并配置环境变量
JDK（Java Development Kit）是Java开发工具包，它包含了编译Java源代码的javac命令、运行Java程序的java命令，以及一系列核心类库。没有JDK，IDEA就无法编译和执行你的代码。
建议安装JDK 8或更高版本。JDK 8虽然发布多年，但依然是目前企业中使用最广泛的版本，稳定性极佳；如果你希望体验新特性，可以选择JDK 11或JDK 17这样的长期支持版本。安装过程很简单，从Oracle官网或OpenJDK镜像站下载对应操作系统的安装包，一路点击“下一步”即可。
安装完成后，最关键的一步是配置环境变量。为什么要配置？因为操作系统需要知道JDK安装在哪里，才能在任意目录下执行java和javac命令。具体操作如下：
- Windows系统：右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”。在“系统变量”中点击“新建”，变量名填
JAVA_HOME，变量值填JDK的安装路径（例如C:\Program Files\Java\jdk1.8.0_301）。然后在Path变量中新增一行%JAVA_HOME%\bin。配置完成后，打开命令提示符输入java -version，如果显示出版本信息，说明配置成功。 - macOS系统：通常JDK安装后会自动配置，但为了保险起见，可以在终端输入
/usr/libexec/java_home -v 1.8查看路径，然后将其添加到~/.bash_profile或~/.zshrc文件中。 - Linux系统：通过包管理器安装OpenJDK后，同样需要设置JAVA_HOME环境变量，通常写在
/etc/profile或用户家目录的配置文件中。
为什么要强调这一步？很多初学者在IDEA中创建项目时找不到JDK选项，或者在运行程序时提示“无法找到主类”，往往就是因为JDK没有正确配置。所以请务必在命令行中验证java -version和javac -version都能正常输出。
1.2 安装IntelliJ IDEA
IDEA分为两个版本：Ultimate（旗舰版）和Community（社区版）。旗舰版功能更全面，支持Java EE、Spring、数据库工具等，但需要付费；社区版免费开源，对于学习基础Java开发完全够用，甚至可以用来开发小型桌面应用和Android项目。
从JetBrains官网下载对应系统的安装包，安装过程同样是傻瓜式操作。安装完成后，第一次启动IDEA会弹出欢迎界面，你可以选择导入之前的设置（如果有的话），或者直接开始新的旅程。如果后续需要汉化，可以在插件市场中搜索“Chinese”安装中文语言包，不过对于开发者来说，建议保留英文界面，以便更好地适应国际化的开发环境。
二、创建Java项目的详细步骤：一步步走向成功
环境准备就绪后，我们就可以正式开始创建第一个Java项目了。整个过程分为几个清晰的阶段，每个阶段都有其目的和注意事项。
2.1 进入项目创建界面
打开IDEA后，你会看到两种情况：
- 首次打开：直接显示欢迎界面，中间有一个醒目的“New Project”按钮，点击它即可进入项目创建向导。
- 已经打开过其他项目：IDEA会显示上次的项目界面。此时你需要点击顶部菜单栏的“File” → “New” → “Project”，同样可以进入创建页面。
这两种方式殊途同归，选择你觉得顺手的一种即可。如果你是第一次使用IDEA，建议直接从欢迎界面开始，因为那里的布局更简洁，不容易被其他窗口干扰。
2.2 配置项目基础参数
进入项目创建页面后，左侧有一列项目类型选项，包括Java、Maven、Gradle、Spring Initializr等。对于最基础的Java项目，我们选择“Java”即可。右侧会出现对应的配置区域，这里有四个关键设置需要你认真填写：
Project SDK（项目SDK）：这是最重要的设置。点击下拉框，如果里面已经列出了你安装的JDK版本（例如“1.8”或“17”），直接选中即可。如果下拉框是空的，说明IDEA没有自动检测到JDK，你需要点击旁边的“Add SDK”按钮，手动选择JDK的安装目录。Windows下典型路径是C:\Program Files\Java\jdk1.8.0_301，macOS下是/Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Home。选择正确后，下方会显示JDK的版本号。
Additional Libraries and Frameworks（附加库和框架）：对于基础Java项目，这里保持默认的“None”即可。如果你将来需要开发Web应用或使用Spring框架，可以在这里勾选对应的选项，但现在不必画蛇添足。
Project name（项目名称）：给你的项目起一个有意义的名字，比如“FirstJavaProject”或“HelloWorld”。名字中不要包含中文或特殊符号，以免引起不必要的路径问题。
Project location（项目存放路径）：IDEA默认会将项目放在用户目录下的IdeaProjects文件夹中，你也可以点击文件夹图标自定义路径。建议选择一个容易记住的位置，比如桌面上新建一个“JavaWorkspace”文件夹。
Project template（项目模板）：这里有两个选项：“Generate project from scratch”和“Create project from template”。新手建议选择后者，然后在下方的模板列表中勾选“Command Line App”。这样做的好处是，IDEA会自动为你创建一个包（package）和一个包含main方法的主类，省去了手动创建的麻烦。当然，如果你喜欢从零开始，也可以选择不勾选模板。
所有参数配置完毕后，点击“Next”进入下一个页面。这里通常会让你确认模块名称和内容根目录，保持默认设置直接点击“Finish”即可。IDEA会花几秒钟时间初始化项目，然后展现在你面前的就是一个完整的Java项目结构了。
2.3 认识项目结构：不要被一堆文件夹吓到
项目创建完成后，左侧的“Project”面板会显示整个项目的目录树。初次看到这么多文件夹，你可能会有点懵，但其实核心结构非常简单：
- src：这是源代码的根目录，所有Java文件都放在这里面。IDEA按照Maven标准布局，将源代码分为
main（主代码）和test（测试代码）两部分。对于基础项目，我们只需要关心src/main/java这个目录。 - src/main/java：在这个目录下，你会看到一个以项目名命名的包（例如
com.example.firstjavaproject），包里面有一个Main.java文件。包的作用是组织类，避免命名冲突，就像文件系统中的文件夹一样。 - External Libraries：这里显示了项目所依赖的所有外部库，最核心的就是你选择的JDK。随着学习的深入，你还会在这里看到各种第三方Jar包。
其他如.idea文件夹（存放IDEA的配置信息）和项目根目录下的pom.xml或build.gradle（如果选择了Maven/Gradle项目）暂时不用理会。对于基础Java项目，你只需要在src/main/java下编写代码就够了。
三、编写并运行第一个Java程序：见证奇迹的时刻
项目骨架搭好后，接下来就是激动人心的编码环节。我们将修改自动生成的Main类，让它输出一句问候语和当前的JDK版本信息。
3.1 修改Main类代码
双击打开src/main/java下的Main.java文件，你会看到类似下面的初始代码：
public class Main {
public static void main(String[] args) {
// write your code here
}
}这里的main方法是Java程序的入口点，JVM（Java虚拟机）启动时会从这个方法开始执行。现在我们把注释替换成真正的代码：
public class Main {
public static void main(String[] args) {
// 输出Hello World到控制台
System.out.println("Hello World");
// 输出当前Java版本信息
System.out.println("当前JDK版本：" + System.getProperty("java.version"));
}
}System.out.println是Java中最基本的输出语句，它会将括号内的内容打印到控制台，并在末尾换行。System.getProperty("java.version")则用于获取当前运行的JDK版本号。这两行代码虽然简单，却能验证你的开发环境是否一切正常。
3.2 运行程序
代码写完后，运行方式有多种：
- 最直观的方法：在代码编辑区的任意位置右键单击，在弹出的菜单中选择“Run 'Main.main()'”。
- 使用工具栏按钮：点击编辑区上方绿色三角形的运行按钮（通常位于右上角）。
- 快捷键：Windows/Linux下按
Shift+F10，macOS下按Control+R。
无论哪种方式，IDEA都会先编译源代码（调用javac），然后启动JVM执行编译后的字节码。如果一切顺利，底部会弹出“Run”面板，显示如下输出：
Hello World
当前JDK版本：1.8.0_301看到这个结果，恭喜你！你的第一个Java项目已经成功创建并运行。这标志着你已经掌握了Java开发最基本的环境搭建和项目创建流程，后续所有的Java学习都将以此为起点。
四、常见问题及解决方法：避开那些坑
在学习过程中，难免会遇到各种问题。下面列出新手最容易碰到的三个典型问题，并给出详细的解决方案。
4.1 创建项目时找不到JDK选项
现象：在Project SDK下拉框中没有任何选项，也无法点击“Add SDK”添加。
原因：IDEA没有自动检测到JDK，通常是因为JDK没有正确安装，或者安装后没有配置JAVA_HOME环境变量。
解决方法：首先在命令行中执行java -version，如果提示“不是内部或外部命令”，说明JDK确实没有配置好。请按照前面“安装JDK并配置环境变量”的步骤重新配置，然后重启IDEA。如果命令行能正常显示版本，但IDEA依然找不到，可以尝试手动添加：点击“Add SDK” → 选择JDK的安装目录（不是bin目录，而是上一级目录，例如C:\Program Files\Java\jdk1.8.0_301）。
4.2 运行程序时报错“找不到主类”
现象：点击运行后，控制台输出“错误: 找不到或无法加载主类 Main”。
原因：IDE没有正确识别到包含main方法的类。可能的原因有：main方法的签名写错了（比如写成public void main或static public void main），或者类没有被编译。
解决方法：检查Main类中的main方法签名，必须严格遵循public static void main(String[] args)的格式，任何一个单词都不能少，也不能改变顺序。另外，确保你运行的是正确的文件——右键点击Main.java文件再选择运行，而不是运行整个项目。如果问题依旧，可以尝试点击菜单栏的“Build” → “Rebuild Project”重新编译所有文件。
4.3 控制台输出中文乱码
现象：程序中的中文字符在控制台显示为乱码，例如“????”或“涓枃”。
原因：IDEA的默认编码与控制台的编码不一致。Windows系统的命令行默认使用GBK编码，而IDEA通常使用UTF-8编码，两者冲突导致乱码。
解决方法：点击顶部菜单“Help” → “Edit Custom VM Options...”，在打开的配置文件中添加一行-Dfile.encoding=UTF-8，然后保存并重启IDEA。如果问题依然存在，还可以在运行配置中设置编码：点击运行按钮旁边的下拉箭头 → “Edit Configurations” → 在“VM options”中添加-Dfile.encoding=utf-8。两种方法任选其一即可。
五、后续项目扩展建议：迈出第一步后怎么走
第一个Java项目成功运行后，你可能会觉得意犹未尽。这里给你几条实用的进阶建议，帮助你巩固所学知识：
- 创建多个包和类：在
src/main/java下新建不同的包（例如com.example.utils），在每个包里编写不同的类，练习类之间的相互调用。这样可以加深你对包机制的理解。 - 添加外部Jar包依赖：学习如何在IDEA中导入第三方库。例如，你可以下载一个JSON处理库（如Gson或Jackson），然后通过“File” → “Project Structure” → “Modules” → “Dependencies”添加Jar包，体验真实项目中依赖管理的流程。
- 尝试Maven项目：当你对基础Java项目足够熟悉后，可以尝试创建Maven项目。Maven是Java世界最流行的项目管理工具，它能自动管理依赖、编译、测试和打包。IDEA对Maven有完美的支持，创建时选择“Maven”类型即可。
- 编写有交互的程序：尝试编写一个简单的计算器或猜数字游戏，使用
Scanner类从控制台读取用户输入，进一步锻炼逻辑思维和代码组织能力。
总之，IDEA只是一个工具，真正的成长来自于不断的练习和探索。希望这篇指南能帮你顺利迈出Java开发的第一步，祝你在编程的道路上越走越远！
IDEAJava项目Java开发IntelliJ_IDEA修改时间：2026-08-21 02:55:50