从零开始安装和配置 IntelliJ IDEA 指南
第一步:安装 Java 环境 (JDK)
IntelliJ IDEA 是用来编写 Java 程序的主要工具之一,但它本身不包含 Java 运行环境。所以我们需要先安装 JDK。
1. 下载 JDK
- 访问 Oracle 官方网站的 JDK 下载页面:
https://www.oracle.com/java/technologies/downloads/ - 选择最新的 LTS 版本(目前推荐 JDK 21 )。LTS 版本更稳定,支持时间更长。
- 根据你的操作系统选择正确的安装包:
Windows:
- 下载
x64 Installer版本(文件名为jdk-21_windows-x64_bin.exe类似)
macOS: - Intel 芯片:下载
x64 DMG Installer - Apple Silicon 芯片 (M1/M2/M3):下载
AArch64 DMG Installer - (对于新手,安装器
.exe或.dmg是最简单的选择)
2. 安装 JDK
Windows :
- 双击下载好的
.exe文件。 - 出现安装向导,点击“下一步”。
- 可以默认安装路径(通常是
C:\Program Files\Java\jdk-21\),也可以更改。记住这个路径,后面要用! - 继续点击“下一步”,直到安装完成。
macOS:
- 双击下载好的
.dmg文件。 - 打开后,双击包中的
.pkg图标。 - 根据安装向导的提示,一路点击“继续”,同意许可协议,并输入你的电脑密码完成安装。
- JDK 会自动安装到标准目录(
/Library/Java/JavaVirtualMachines/),无需手动设置路径。
3. 验证 JDK 是否安装成功
- Windows:
- 按下键盘上的
Win + R键,输入cmd,然后按回车,打开命令提示符。 - 输入命令
java -version并按回车。 - 如果显示类似下面的版本信息(版本号和你下载的一致),说明安装成功。
java version "21.0.2" 2024-01-16 LTS
Java(TM) SE Runtime Environment (build 21.0.2+13-LTS-58)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.2+13-LTS-58, mixed mode, sharing)
- macOS:
- 打开“启动台” -> “其他” -> “终端”。
- 输入命令
java -version并按回车。 - 同样检查版本信息是否正确。
第二步:下载并安装 IntelliJ IDEA
1. 选择版本
IntelliJ IDEA 有两个版本:
- Ultimate (旗舰版):功能全面,支持各种语言和框架(如 Spring, Python, JavaScript),但收费(对学生免费)。
- Community (社区版):免费,功能足够用于学习 Java 和 Android 开发。
作为新手,咱们先下载免费的 Community 版本。
2. 下载安装
- 访问 JetBrains 官网下载页:
https://www.jetbrains.com/zh-cn/idea/download/ - 向下滑在“Community”栏目下,点击你的操作系统(Windows, macOS, Linux)对应的 下载 按钮。
- 下载完成后,运行安装程序。 * Windows:
- 双击安装程序
.exe。
- 选择安装路径(默认会安装到C盘,我这边选择的D)。
- 在安装选项界面,勾选如图选项:
64-bit launcher(创建桌面快捷方式)Add "Open Folder as Project"(增加右键菜单).java(关联 Java 文件)- 点击“下一步(Next)”直到安装完成,最后点击“完成(Finish)”。
- macOS:
- 双击下载的
.dmg文件。 - 将 IntelliJ IDEA CE 的图标拖拽到
Applications文件夹中即可完成安装。
第三步:首次运行与基本配置
1. 启动 IDEA
- Windows: 从开始菜单或桌面快捷方式启动。
- macOS: 在“应用程序”中找到并启动它。
首次运行会进行一些初始化配置。
2. 重要初始设置
- 是否导入设置:第一次启动会问你是否导入之前的设置,选择
跳过导入(Do not import settings)(不导入设置,使用默认配置)。
- 接受用户协议:勾选同意,然后点击“Continue”。
- 数据分享:是否发送使用数据给 JetBrains 以帮助他们改进产品,可以选择“Don't Send”不发送。
- UI 主题选择:选择你喜欢的主题,比如
Light(浅色) 或Dark(深色)。之后可以随时更改。 - 插件安装:初始界面会推荐一些插件,作为新手可以先直接点击“Skip Remaining and Set Defaults”(跳过其余并设置默认),后续有需要再安装。
- 激活:社区版不需要激活,直接点击“Start trial”或“Start using IDEA”即可开始使用。
3. 配置 JDK(关键步骤!!!)
现在我们要告诉 IntelliJ IDEA 我们刚才安装的 JDK 在哪里。
- 如果这里自动检测到了你安装的 JDK 21(例如显示
21),那么太好了,你可以直接下一步。 - 如果没有检测到,点击
从磁盘中添加JDK...(Add JDK...)。
3.1. 在弹出的文件选择窗口中,找到你安装 JDK 的路径:
- Windows: 通常是在
C:\Program Files\Java\下,选择你安装的jdk-21这个文件夹。- macOS: 路径是
/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home(请将21替换为你下载的实际版本号)。
第四步:创建并运行你的第一个程序
现在你进入了 IDEA 的主界面。
- 创建Java类:
- 编写代码:
- IDEA 会自动生成类结构。我们写入一个经典的入门程序:
public class Main {
public static void main(String[] args) {
System.out.println("Hello, World! 我终于成功啦!");
}
}- 运行程序:
- 你会看到代码编辑器顶部区域,
当前文件字样的旁边有一个小小的 绿色三角▶️ 图标。 - 点击这个绿色三角。
- 或者,直接在代码编辑器内右键,选择
Run 'Main.main()'。
- 查看结果:
恭喜你!你已经成功完成了从安装到运行的全部步骤!🎉
总结与后续建议
| 步骤 | 内容 | 关键点 |
|---|---|---|
| 1 | 安装 JDK | 去 Oracle 官网下载,并验证 java -version |
| 2 | 安装 IDEA | 下载 Community (社区版),按向导安装 |
| 3 | 配置环境 | 首次创建项目时,通过 Add JDK... 指定 JDK 安装路径 |
| 4 | 创建运行 | 在 src 下新建 Java Class,写代码,点击绿色三角运行 |
- 不要怕出错:编程过程中会遇到无数错误,这是学习过程的必经之路。学会阅读错误信息(通常是红色的)是最重要的技能之一。
- 善用搜索:任何问题,都可以尝试将错误信息复制到百度或 Bing 中搜索,很大概率已经有人遇到过同样的问题并提供了解决方案。
- 熟悉界面:多点点看 IDEA 的各个菜单,了解一下各个窗口(如 Project, Run, Terminal)是干什么的。
Q&A
Q:为什么“不用去配置系统的环境变量”?
A:因为 IntelliJ IDEA 是一个高度集成的开发环境,它在自己内部已经管理了你为项目指定的 JDK。当你按照上一步教程,在创建新项目时通过 >
Add JDK...告诉了 IDEA JDK 的安装路径后,IDEA 就知道去哪里找编译器 (javac) 和运行时 (java) 来编译和运行你的代码了。所以,仅仅在 IDEA 里写代码、点绿色三角运行程序,不配置系统环境变量是完全没问题的。
Q:为什么“强烈建议”配置环境变量?
A:因为配置系统环境变量
JAVA_HOME和PATH是为了让整个操作系统而不仅仅是 IDEA 知道 Java 的存在。这会在很多场景下带来便利:
- 在命令行(终端/CMD)中使用 Java:
- 你想在 IDEA 自带的终端或者系统自带的
cmd或PowerShell中直接输入java -version、javac等命令时,系统需要知道去哪里找这些命令。- 未来你一定会用到,比如使用
Maven、Gradle等构建工具,它们通常依赖于JAVA_HOME这个环境变量来定位 JDK。
- 其他开发工具:
- 很多其他软件(比如服务器软件 Tomcat、构建工具 Gradle 等)在启动时都会查找
JAVA_HOME环境变量来确定使用哪个 Java 环境。
- 避免未来 confusion:
- 提前配置好是一劳永逸的事情,可以避免未来某个时候突然出现“命令找不到”的错误而不知所措。
如何配置系统环境变量 (详细步骤)
下面为你提供 Windows 和 macOS 的详细配置方法。
🔧 对于 Windows 系统
- 确认 JDK 安装路径:
- 通常路径是
C:\Program Files\Java\jdk-21(请将21替换为你安装的实际版本号)。 - 非常重要:请打开文件资源管理器确认这个路径存在。路径中应该包含
bin,lib等文件夹。
- 打开环境变量设置:
- 在开始菜单搜索 “编辑系统环境变量” 并打开。
- 或者按
Win + R,输入sysdm.cpl回车,然后选择“高级”选项卡,点击“环境变量”按钮。
- 新建
JAVA_HOME变量 (系统变量):
- 在下面的“系统变量”区域,点击 “新建...”。
- 变量名:
JAVA_HOME - 变量值:你的 JDK 安装路径,例如
C:\Program Files\Java\jdk-21 - 点击“确定”。
- 修改
Path变量:
- 在“系统变量”区域,找到并选中
Path变量,点击 “编辑...”。 - 点击 “新建”,然后添加一条新记录:
%JAVA_HOME%\bin - 说明:
%JAVA_HOME%会动态引用你上一步设置的路径,\bin是包含所有可执行文件(如java,javac)的目录。 - 点击“确定”保存。
- 验证配置:
- 关闭所有已经打开的命令行窗口,重新打开一个新的
cmd或PowerShell。 - 输入
java -version,应该显示你安装的版本号。 - 输入
javac -version,应该显示同样的版本号。 - 输入
echo %JAVA_HOME%,应该显示你设置的路径。 - 如果这些命令都返回了正确信息,恭喜你,配置成功!
🍎 对于 macOS 系统
macOS 在安装 JDK .dmg 包时,通常会自动在 /usr/libexec/java_home 这个位置创建一个链接,命令行工具已经可以找到 Java。但手动设置 JAVA_HOME 仍然是一个好习惯。
- 打开终端(Terminal)。
- 确定 JDK 的安装路径:
- 在终端中输入以下命令并回车:
/usr/libexec/java_home- 它会输出 JDK 的完整安装路径,例如:
/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home - 复制这个路径。
- 编辑 shell 配置文件:
- macOS 通常使用
zsh(新系统)或bash(旧系统)作为默认 shell。 - 首先判断你用的哪种,在终端输入
echo $SHELL: - 如果输出
/bin/zsh-> 编辑~/.zshrc文件 - 如果输出
/bin/bash-> 编辑~/.bash_profile文件 - (近年来新的 macOS 系统基本都是
zsh)
- 以
zsh为例,在终端输入以下命令来编辑配置文件:
nano ~/.zshrc- 添加环境变量:
- 在打开的文件末尾(如果之前没有内容,就在空文件中),添加以下两行:
export JAVA_HOME=$(/usr/libexec/java_home)
export PATH=$JAVA_HOME/bin:$PATH- 说明:第一行使用
$(/usr/libexec/java_home)命令自动获取当前 JDK 路径并赋值给JAVA_HOME。第二行将 JDK 的bin目录添加到PATH的最前面。
- 保存并退出:
- 按
Ctrl + O回车来保存文件。 - 按
Ctrl + X退出 nano 编辑器。
- 使配置生效:
- 在终端中输入以下命令,让刚修改的配置立即生效:
source ~/.zshrc- 验证配置:
- 关闭终端再重新打开,或直接在新终端中输入:
java -version
javac -version
echo $JAVA_HOME- 如果所有命令都返回正确信息,则配置成功。
总结
| 场景 | 是否需要配置环境变量 |
|---|---|
| 仅使用 IntelliJ IDEA 的图形界面按钮运行程序 | 不需要 |
需要在系统命令行中使用 java, javac 等命令 |
必须 |
| 为了未来使用 Maven、Gradle 等工具做准备 | 必须 |
| 让系统环境更整洁,避免未来可能出现的问题 | 强烈建议 |
给你的最终建议: 既然你已经走到了这一步,花 5 分钟时间把它配置好,这是一项一次性的投资,能为你的后续开发学习省去很多不必要的麻烦。
现在,你已经搭建好了强大的开发环境,可以开始探索精彩的编程世界了!












