必须先配置JDK路径、统一UTF-8编码、正确创建src目录,才能使IDEA正常编译运行Java项目;否则会出现红标、No SDK、中文乱码等问题。

你需要在本地电脑上快速搭起一个能写、能跑、能调试的Java开发环境,而不是被各种红标、报错、No SDK提示卡在第一步。IDEA不是装完就能用的工具,它依赖明确的JDK路径、正确的编码设置和项目结构认知——这三步漏掉任何一环,后续所有操作都会变成徒劳的排查。
安装IDEA并选择合适版本
访问 https://www.jetbrains.com/idea/download/,根据操作系统下载对应安装包。Windows用户双击.exe文件,macOS用户拖拽.app到Applications文件夹,Linux用户解压后运行bin/idea.sh即可启动安装向导。
安装过程中,路径建议避开C盘或系统根目录,例如设为D:\IntelliJ IDEA Community 2025.2;勾选“Add Launchers to Path”和“Update PATH when launching from command line”,否则后续无法在终端直接输入idea命令启动。
社区版(Community Edition)完全免费,支持Java SE、Gradle、Maven、JUnit等核心功能,【学习Java和做课程项目时无需安装Ultimate版】。旗舰版仅在开发Spring Boot微服务、前端混合项目或需数据库工具时才真正必要。
配置JDK:项目能编译的前提
首次启动IDEA后,在欢迎界面点击“New Project”。左侧选择“Java”,右侧立即检查“Project SDK”是否显示版本号。若显示“No SDK”,说明IDEA没找到JDK,必须手动指定。
点击下拉框旁的“Add JDK…”,在文件选择器中定位到JDK安装根目录:
• Windows常见路径:C:\Program Files\Java\jdk-17.0.2
• macOS常见路径:/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
• Linux常见路径:/usr/lib/jvm/java-17-openjdk-amd64
【必须选JDK根目录,不能选bin子目录,也不能选JRE目录】。选错会导致新建项目后src下所有.java文件全标红,且无法识别main方法。
确认SDK添加成功后,在同一窗口下方勾选“Create module with sources root”,再点击“Create”。这一步会自动生成src文件夹,避免你手动建包时因路径错误导致类无法被识别。
统一编码设置:防止中文乱码的硬性操作
菜单栏选择 File → Settings(macOS为IntelliJ IDEA → Preferences),进入 Editor → File Encodings。
将以下三项全部设为UTF-8:
• Global Encoding
• Project Encoding
• Default encoding for properties files
勾选“Transparent native-to-ascii conversion”。这一步看似简单,但不执行就会导致properties文件里的中文变成\uXXXX格式,控制台输出中文变问号,甚至Spring Boot配置文件加载失败。
完成后点击OK,重启IDEA使设置全局生效。此时新建的Java类中写System.out.println("你好世界");,运行结果将正确显示中文。
创建第一个可运行的Java项目
步骤一:右键项目名 → New → Package,命名为demo(不要用中文或特殊符号)。
步骤二:右键刚建的demo包 → New → Java Class,类名填HelloWorld,回车确认。
步骤三:在自动生成的类中,光标定位到大括号内,输入psvm后按Tab键,IDEA会自动补全public static void main(String[] args) {}结构。
步骤四:在main方法内输入System.out.println("Hello, IntelliJ IDEA!");,然后右键编辑区 → Run 'HelloWorld.main()'。
控制台出现预期输出即表示环境已通。此时你已越过90%新手卡住的第一道门槛——后续所有功能(Maven依赖、Git集成、单元测试)都建立在此基础之上。


















