idea常见问题需针对性排查：1.“cannot resolve symbol”先maven重载，再检查模块sources标记和maven路径；2.运行按钮灰需配置jdk而非jre；3.“找不到主类”应核对运行配置、编译输出路径并重建项目；4.启动卡死需调vm参数、禁用冗余插件、清理缓存。
刚打开IDEA就看到满屏红色报错、运行按钮灰色不可点、控制台疯狂刷“找不到主类”或“JDK not configured”，这种场景对Java新手来说几乎每天都在发生。问题往往不是代码写错了，而是IDEA的配置、缓存、路径或Maven状态在后台悄悄脱节，需要针对性地切片排查，而不是盲目重启或重装。
项目一打开就爆红：“Cannot resolve symbol”
这是Maven项目导入后最典型的视觉冲击，连String都标红，说明IDEA根本没把依赖和源码结构识别成有效模块。
第一步：右键项目根目录 → 选择 【Maven → Reload project】。这一步强制IDEA重新读取pom.xml，触发依赖下载与模块映射重建。如果网络慢或仓库地址异常，会卡在“Resolving dependencies”状态，此时不要关掉窗口，等30秒以上再看结果。
第二步：若重载后仍全红，点击顶部菜单 File → Project Structure → Modules，确认每个模块的Sources文件夹是否被正确标记为蓝色（即已设为源码根目录）。常见坑是IDEA自动把src/main/java识别为普通文件夹而非Sources，导致编译输出路径失效，所有类都无法解析。
第三步：检查Maven设置是否指向本地正确安装的Maven。进入 File → Settings → Build, Execution, Deployment → Build Tools → Maven，确认Maven home path不是IDEA自带的bundled版本，而是你手动安装的、且能正常执行mvn -v的版本。很多新手用bundled Maven，但本地settings.xml配置（如镜像、认证）只对独立Maven生效，导致依赖拉不下来。
运行按钮灰色，提示“Project SDK is not defined”
没有SDK，IDEA连javac都调不动，自然无法编译更无法运行——这是所有Java项目启动前必须跨过的门槛。
方法一：快速补救（适用于本机已装JDK）
点击右下角提示栏的【Configure → Add JDK…】 → 在弹出窗口中选择JDK安装路径，例如Windows下是C:\Program Files\Java\jdk-17，Mac下是/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home。选完立刻生效，运行按钮马上变亮。
方法二：从全局配置入口设置（更稳妥）
按 Ctrl + Alt + Shift + S 打开Project Structure → 左侧选Project → 在Project SDK下拉框中选择已识别的JDK。若下拉框为空，点击右侧【New… → JDK】，手动浏览到JDK根目录。注意：Language level必须与JDK版本匹配，比如JDK 17对应Language level 17，否则会出现“Unsupported class file major version”错误。
⚠️关键提醒：不要选JRE路径。JRE只有运行环境，没有javac编译器，IDEA无法用它构建项目。JDK路径里一定包含bin/javac.exe（Windows）或bin/javac（Mac/Linux）。
使用 idealista CLI 按位置（城市、城镇、地区、街道）搜索 Idealista 房源并获取详情。适用于用户请求 Idealista 市场数据或需要 idealista‑cli 命令/标志时。
点击运行报“错误: 找不到或无法加载主类”
主类明明存在、包名也对、public static void main写得标准，IDEA却坚称找不到——这通常不是代码问题，而是运行配置与编译输出路径错位。
方法1：检查运行配置中的主类是否拼错
点击右上角运行配置下拉框 → 选择【Edit Configurations…】 → 左侧选中你的Application配置 → 确认Main class字段填写的是完整类名，例如com.example.demo.DemoApplication，不能漏掉包名，也不能带.java后缀。
方法2：验证编译输出是否真实生成
打开项目目录，查看target/classes（Maven）或out/production/模块名（非Maven）路径下是否存在对应包路径和.class文件。如果该目录为空或缺失，说明编译根本没成功，要先解决Maven重载或模块Sources设置问题。
方法3：强制重建输出目录
菜单栏选择Build → Rebuild Project。这会清空旧class文件并重新编译全部源码。比单纯Build Project更彻底，尤其适合刚修复SDK或模块配置后的验证环节。
IDEA启动卡死、假死、5分钟打不开
启动时进度条停在“Loading plugins”或“Indexing…”不动，内存占用飙升到3GB以上，这是典型资源过载表现，不是硬件不行，而是配置失衡。
编辑idea64.exe.vmoptions（Windows）或idea.vmoptions（Mac），将以下三行粘贴到底部并保存：
-Xms1024m
-Xmx2048m
-XX:ReservedCodeCacheSize=512m
改完必须彻底关闭IDEA（任务管理器里确认java进程消失），再双击图标启动才生效。
禁用非必要插件：打开Settings → Plugins，取消勾选Angular、Python、JavaScript Debugger、Database Tools等与Java开发无关的插件。保留仅Core Java、Maven、Git Integration、Spring Boot这几个刚需项即可。插件越多，启动时扫描耗时越长，且部分插件存在兼容性冲突。
清理损坏索引：菜单栏File → Invalidate Caches and Restart → Invalidate and Restart。这会清除IDEA本地缓存、符号索引和历史记录，强制重建。虽然耗时1–3分钟，但比反复重启十几次更高效。
