
IntelliJ IDEA 安装与环境配置教程:Windows 下配置 JDK、Maven 和 Git本文从软件下载开始,逐步完成 IntelliJ IDEA 安装、JDK 环境变量设置、项目 SDK 配置、Maven 构建和 Git 集成,并通过 Java 程序运行、断点调试及 JAR 打包验证环境是否可用。适用环境:Windows 10/11 的 64 位环境。示例使用 JDK 21 和 Maven 3.9 系列,采用普通 Java 类和标准 Maven 项目,不依赖高级订阅功能。阅读说明:新电脑搭建环境,可按照 JDK、IDEA、Maven、Git 的顺序操作。已有项目时,优先遵守项目 README、pom.xml、构建脚本与团队约定的版本要求。示例命令在 Windows PowerShell 中执行。D:\Dev和D:\Projects是示例目录,没有 D 盘时可替换为实际路径。命令输出是预期示例,是否配置成功应以自己的实际执行结果为准。菜单使用英文名称;中文界面可按对应含义或通过设置搜索定位。1. 准备软件与目录先确认电脑环境在 Windows 设置中打开“系统 → 关于”,确认系统类型。常见 Intel 或 AMD 电脑选 x64 安装包;Windows on ARM 设备按官网提供的 ARM64 包和支持要求选择,不要仅凭“64 位”判断。官方当前列出的 IDEA 硬件要求包括 4 核 CPU、8 GB 总内存、IDE 进程可用内存 3 GB、10 GB 磁盘空间和 1280 × 720 分辨率。实际开发建议使用 16 GB 或更多内存,并为项目与依赖缓存预留额外空间。这是使用建议,不是官方最低要求。认识四个工具工具负责什么是否需要IntelliJ IDEA编辑代码、运行、调试和管理项目必需JDK提供java、javac等运行与编译工具Java 开发必需Maven根据pom.xml下载依赖、编译和打包Maven 项目需要Git记录代码版本,与远程仓库协作按项目需要IDEA 自带 JetBrains Runtime,用于运行编辑器。它与 Java 项目的 JDK 用途不同;不要把 IDEA 安装目录里的jbr当作本文的项目 JDK。单独安装 JDK 也方便在 IDEA 之外编译、运行和构建项目。选择版本和安装方式新手可按本文采用 JDK 21 完成基础示例;需要 JDK 8、17、25 或其他版本的项目,应安装对应 JDK。多个 JDK 可以共存,各项目单独选择 SDK。IDEA 下载稳定版;EAP 是预览版本,不作为本文的默认选择。已有 Maven Wrapper 的项目优先使用项目提供的mvnw.cmd。仅在 IDEA 中学习时也可以先使用 Bundled Maven;若希望系统 PowerShell 能执行mvn,则需要单独安装 Maven。规划目录D:\Dev\Java\jdk-21 JDK 根目录示例 D:\Dev\Maven\apache-maven Maven 解压目录示例 D:\Dev\Maven\repository 可选的依赖缓存目录 D:\Projects 项目目录示例路径尽量简短,项目尽量放在本地磁盘。路径中的空格并非一律不支持,执行命令时需加引号。避免把初学项目放在临时下载目录或容易出现同步冲突的位置。官方下载链接见文末“官方下载与参考资料”。参考:IDEA 安装与系统要求、IDEA SDK 配置。2. 安装 JDK 并设置环境变量下载并安装打开 Adoptium Temurin 下载页面,选择 JDK 21、Windows 和正确的架构,下载 JDK 包。请选择 JDK,不要选择仅提供运行环境的 JRE。x64 电脑可使用 MSI 安装包,按向导安装。安装选项中可以启用 Add to PATH 和设置JAVA_HOME;完成后核对实际安装目录。ARM64 或需要自定义布局时,按官网支持情况选择归档包。如果使用 ZIP,解压后找到同时包含bin、lib等目录的 JDK 根目录。可整理为D:\Dev\Java\jdk-21,确认bin下有java.exe和javac.exe。不要把外层解压目录误当成 JDK 根目录。手动设置 JAVA_HOME 与 Path在开始菜单搜索“编辑账户的环境变量”或“编辑系统环境变量”,进入“环境变量”。个人开发可设置用户变量;需要所有用户使用时,再设置系统变量。新建或修改JAVA_HOME,变量值填写 JDK 根目录,例如D:\Dev\Java\jdk-21。不要填写bin目录,也不要在环境变量值两边加引号。在同一作用域的 Path 中新增%JAVA_HOME%\bin,保留其他已有条目。若安装器已经添加了有效 JDK 路径,不必重复添加。检查旧 Java 路径的优先级。逐级点击确定保存,然后关闭旧终端并重新打开独立的 Windows PowerShell。正在运行的程序不会自动获得新环境变量;IDEA 也可能需要重启。在独立 PowerShell 中验证$env:JAVA_HOMETest-Path"$env:JAVA_HOME\bin\javac.exe"java-version javac-version where.exe java where.exe javac预期:JAVA_HOME是正确根目录;Test-Path返回 True;java与javac显示 21.x;where.exe能定位到对应 JDK 的bin。若列出多个 Java 路径,优先检查实际排在前面的程序。PowerShell 中使用$env:JAVA_HOME读取变量;CMD 中使用echo %JAVA_HOME%。这里写where.exe,是为了明确调用 Windows 路径查找程序,避免与 PowerShell 的别名混淆。多版本 JDK 的临时切换下面只改变当前 PowerShell 会话,关闭窗口后失效。永久切换仍需修改环境变量;IDEA 内的项目 SDK 另行设置。$env:JAVA_HOME ='D:\Dev\Java\jdk-17'$env:Path ="$env:JAVA_HOME\bin;$env:Path"java-version参考:Temurin Windows 安装。3. 安装并首次启动 IDEA从官网获取正确安装包打开 IntelliJ IDEA 官方下载页面,选择 Windows 和对应 CPU 架构,下载稳定版安装程序。也可通过 JetBrains Toolbox App 安装和管理多个版本;本节采用直接安装程序,便于初次操作。从 IDEA 2025.3 开始,Community 与 Ultimate 合并为统一产品。核心功能继续免费,高级工具通过 Ultimate 订阅提供,安装后可获得官方说明的试用机会。试用结束后可继续使用免费功能。阅读旧教程时,注意版本和界面差异。运行安装向导双击安装程序,按向导选择安装位置。通常可以保留默认目录;系统提示权限时,根据安装范围按 Windows 提示处理。在安装选项中按需勾选桌面快捷方式。Add launchers dir to the PATH 用于从终端调用 IDEA 启动器,与 Java 的 Path 设置是两回事。Add Open Folder as Project 便于在资源管理器中直接打开项目;文件关联选项决定 .java、.kt、.pom 等文件默认由谁打开,按自己的使用习惯选择。开始安装,完成后启动 IDEA。若勾选了修改 Path 的选项,请按安装器要求重新打开终端或重启系统。安装器版本不同,选项名称可能略有调整。首次启动与功能选择首次使用时,不导入未知来源的旧配置。若确实需要迁移,选择自己原有版本的设置,并留意插件兼容性。按界面提示阅读相关条款,选择主题和必要的隐私设置。订阅或试用入口以当前界面为准;基础 Java 示例使用免费核心功能即可完成。进入欢迎页,查看 New Project、Open 和 Get from Version Control 等入口。菜单找不到时,可使用 Ctrl+Shift+A 搜索动作名称。核对安装结果使用 Help → About 查看 IDEA 版本和运行时信息,确认打开的是刚安装的版本。能启动欢迎页说明 IDE 已安装成功;是否能开发 Java,还需要完成项目 SDK 配置,再运行第一个 Java 程序进行验证。建议先完成基础示例,再逐个添加确有需要的插件。中文语言支持可在 Settings 中搜索 Language,或在 Plugins 中查找 JetBrains 官方 Chinese Language Pack;按当前版本提供的方式设置并按提示重启。参考:IDEA 安装与系统要求、IDEA 下载与功能说明、IDEA 首次启动。4. 配置项目 JDK 与文件编码配置项目 SDK打开项目后进入 File → Project Structure(Ctrl+Alt+Shift+S),选择 Project Settings → Project。在 SDK 或 Project SDK 中选择安装的 JDK。未识别时使用 Add SDK/Add JDK from Disk,指向 JDK 根目录;也可使用 Download JDK 下载独立 JDK。Language level 选择与项目一致的语言级别。本文示例使用 21 或 SDK default,不开启 Preview。语言级别决定可使用的语法,不能代替 JDK 安装。在 Modules → Dependencies 中检查 Module SDK,通常选择 Project SDK。多模块项目如有特定要求,按模块单独设置。点击 Apply 和 OK。Maven 与 Gradle 项目的编译版本通常由构建脚本管理。不要只在 IDEA 界面修改语言级别:重新同步后,pom.xml或构建脚本中的配置可能会再次生效。配置文本编码进入 File → Settings(Ctrl+Alt+S)→ Editor → File Encodings。新建项目采用下面的设置;已有项目必须先确认原来的文件编码和读取方式。配置项新项目建议说明Global EncodingUTF-8IDE 全局默认编码Project EncodingUTF-8项目默认编码properties 文件编码按读取代码决定现代项目可用 UTF-8;老项目需核对UTF-8 BOM通常不添加脚本及源码一般无需 BOM旧式Properties.load(InputStream)按 ISO-8859-1 读取;使用 Reader 或框架配置时规则可能不同。Transparent native-to-ascii conversion 用于处理字符转义,不是解决所有中文乱码的通用开关。已有文件乱码时先备份,再根据真实编码执行 Reload;确认后如需改变文件编码,再使用 Convert。Reload 改变解码方式,Convert 会改写文件字节,不能随意替换使用。理解 IDEA 终端的 JDK新版 IDEA 的 Terminal 可通过 Add project JDK to PATH 选项把项目 JDK 注入新终端会话。系统 PowerShell 与 IDEA Terminal 因此可能显示不同 Java 版本。请分别执行java -version和mvn -v;切换项目 SDK 后重新创建终端会话。参考:IDEA SDK 配置、IDEA 文件编码、