新机器到手装 JDK11、装 IDEA、配环境看着像三步就能搞定的事实际动手经常是另一回事终端里敲java -version输出的是 21javac -version又是 11IDEA 里项目语言级别标红Maven 拉依赖卡在 0% 不动。这跟操作水平关系不大环境配置本身藏着一批隐式规则——安装路径里有没有空格、Path 里多个 java.exe 谁先被命中、多版本 JDK 并存时变量指向哪一个、IDE 自己维护的那套 SDK 配置跟系统变量是不是同一份任何一处对不上就会以报错的形式砸到你脸上。这篇写给三类人看第一次在自己电脑上装 JDK11 和 IDEA 的初学者需要在同一台机器上保留 JDK11 与 JDK21或者 8并随时切换的维护型开发还有带新人的团队负责人可以直接把下面的步骤清单发给同事照做。整篇围绕 JDK11、IDEA、环境配置三个核心词展开从发行版挑选讲到多版本切换脚本从 IDEA 首次启动必须调的几项设置讲到 Maven 依赖下载加速最后落成一份能对着查的故障速查表。JDK11 是个很特殊的分界线版本——它既是大量存量项目的运行基线又恰好是 Spring Boot 3.x 之前那一代框架的标配所以到 2024 年了还有大批项目死死钉在 11 上学会它并把 IDEA 配好属于绕不过去的基本功。1. 动手之前先想清楚这套环境要解决什么问题很多人配置环境的方式是打开搜索引擎抓一篇教程从头照抄抄完能跑就再也不管。问题在于教程默认你只有一份 JDK、只跑一个项目而真实工作场景几乎不满足这个前提。先把目标拆清楚后面每一步选择才有依据。1.1 JDK11 与 JDK21 并存的现实原因我手上维护的项目里老系统跑在 JDK11 上新起的服务直接用 JDK21中间还夹着一个必须用 JDK8 编译的祖传模块。这三份 JDK 要装在同一台机器上共存互不干扰。JDK11 之所以长期不退场是因为它是 LTS 版本很多中间件客户端、老版本构建插件、字节码增强工具比如某些版本的 Lombok、部分 AOP 框架在那时候才真正稳定下来团队不敢轻易动。JDK21 同样是 LTS虚拟线程、模式匹配这些新特性对高并发场景收益明显新项目自然会往它上面靠。共存的技术难点不在安装而在指向。操作系统层面同一时刻只能有一个JAVA_HOME生效但 IDEA 允许每个项目单独指定 SDKMaven 允许单独指定运行用 JDK命令行又完全跟随系统变量。这三套指向如果不统一会出现一个非常典型的症状IDEA 里编译通过命令行mvn package报Unsupported class file major version。理解了这一点你就会明白为什么后面我一直强调系统变量负责命令行IDEA 项目配置负责 IDE两者要能对上号。1.2 IDEA 两个版本线怎么选别一上来就走弯路IntelliJ IDEA 目前分社区版Community Edition和旗舰版Ultimate两条线。社区版免费支持 Java、Kotlin、Groovy、Maven、Gradle、JUnit 这些做纯 Java 后端或者学习完全够用旗舰版额外支持 Spring 全家桶的深度识别、数据库工具、HTTP Client、远程开发、JavaScript/TypeScript 前端能力等属于商业授权。选哪个不取决于哪个好用取决于你的项目需要什么。写 Spring Boot 的话旗舰版对application.yml里配置项的补全和跳转确实香但那属于锦上添花社区版照样能把项目跑起来。我的实际建议是初学者先用社区版把 Java 环境这套流程走通等你确认自己每天都要跟 Spring 打交道再考虑升级或走公司的采购渠道。这里必须把授权问题说清楚。网上流传的所谓第三方授权工具无限试用之类的做法我一律不碰也不推荐原因有两条一是这类工具来源不明很多是打包过的可执行文件或者要你替换核心 jar供应链风险实打实存在二是企业环境下用未授权版本是明确的合规问题出事了是团队背锅。正规路径其实不少——学生和教师可以申请教育授权开源项目可以申请开源授权公司可以批量采购官方也给了 30 天完整功能试用期用来评估。走正规路径心里踏实。1.3 目录约定给后面所有操作省事在真正点安装程序之前先定好目录。我踩过最惨的一次坑是 JDK 装在C:\Program Files\Java\...下面Maven 的本地仓库路径里带了一个中文文件夹名结果构建时随机报字符编码错误查了一整天。从那以后我的约定固定下来JDK 统一放D:\dev\jdk\下面每个版本一个目录例如jdk-11.0.20、jdk-21.0.2Maven 放D:\dev\maven\apache-maven-3.9.6本地仓库放D:\dev\m2repo绝不放在用户目录下带中文的路径里代码工程统一放D:\workspace\下绕开 OneDrive、坚果云这类同步盘的目录。为什么坚持不用 C 盘默认路径一是权限问题某些操作在受保护目录下会被 UAC 拦下二是重装系统时 D 盘的工具链可以直接复用三是路径里没有空格能规避一批脚本拼接引号失败的低级错误。这几条看着琐碎但它们决定了你后面会不会遇到那种网上没人遇到过、只有你报错的问题。2. JDK11 安装与环境变量配置全流程把目标想清楚之后正式进入安装环节。这一步的每一个动作都有它的理由我会把理由一起讲明白这样你遇到变体场景时能自己判断怎么改。2.1 发行版选择同样是 JDK11差别在哪JDK11 不止一个发行版本除了 Oracle 官方那份还有 Eclipse TemurinAdoptium、Azul Zulu、Amazon Corretto、Microsoft Build of OpenJDK、龙井、毕昇等等。它们都基于同一份 OpenJDK 源码构建通过了 TCK 兼容性测试语法层面完全一致差别主要在构建者、更新频率、长期维护承诺和许可证条款上。我的选型逻辑很直接个人学习和中小团队项目优先选 Eclipse Temurin 或 Amazon Corretto两者都免费、更新及时、生态里被验证得多下载页也清晰打开adoptium.net的 releases 页面筛选 version 11、Operating System 和 Architecture 就能下到对应的包。国内下载速度慢的话可以找国内的镜像源或者在能连通的机器上下载后拷过来别为了图快去找来路不明的绿色版 JDK 压缩包——这类包被人动过手脚你根本发现不了。至于 Oracle 那份 JDK个人开发和非生产用途没问题商用场景建议先看清楚当时的许可条款嫌麻烦就直接选一个明确免费商用的发行版省心。版本号上认准 11.0.x 的最后一个补丁版本比如 11.0.2x 系列别去下 11 的早期构建早期版本有几个已知的 TLS 和 GC 问题白白给自己找事。2.2 Windows 安装与 JAVA_HOME、Path 的正确写法Windows 上 Temurin 提供.msi安装包双击一路下一步即可唯一要改的是安装目录指向你规划好的D:\dev\jdk\jdk-11.0.20这类路径。装完之后关键来了——配环境变量。很多人卡在这一步是因为教程只给了结果没讲机制。先解释机制Windows 环境变量分用户变量和系统变量两层系统变量对所有账户生效用户变量只对当前用户生效查找 Path 时用户变量会拼在系统变量之后。多个 java.exe 同时在 Path 里的时候谁排前面谁生效。这就是为什么你明明改了JAVA_HOMEjava -version还是老版本——很可能是 Oracle 安装程序往 Path 里塞了一条C:\Program Files\Common Files\Oracle\Java\javapath它排在前面把我们的路径挡住了。具体操作按顺序来打开此电脑 → 属性 → 高级系统设置 → 环境变量在系统变量区域新建JAVA_HOME值填 JDK 的根目录例如D:\dev\jdk\jdk-11.0.20。注意不要带\bin不要带结尾分号不要带引号这三个错误非常常见Maven 会因为JAVA_HOME格式不对而直接报错退出在系统变量里找到Path双击编辑新增一条%JAVA_HOME%\bin把这条新记录选中用上移按钮挪到包含javapath或旧 JDK 的那几条之前全部确定保存然后关闭所有已经打开的终端窗口——环境变量对已启动的进程不刷新不关等于没改。验证用三条命令缺一条都不算配好java -version javac -version where javajava -version和javac -version必须都显示 11 这个分支很多人只查第一条结果编译期才发现javac指向另一个版本。where java会列出 Path 里所有命中的 java.exe按优先级排列它应该只输出你刚才配的那一条如果上面还有别的回去继续挪顺序。注意不要把CLASSPATH一起配上。网上流传的老教程会写.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar那是 JDK5 时代的东西配在现代 JDK 上不但没用还会覆盖默认类路径导致一些依赖加载异常。还有一个容易忽略的细节setx命令虽然能在脚本里改环境变量但它对超长变量值有长度限制Path内容一多就可能被截断截断后你丢的是整条路径而不是最后一段排查起来极其痛苦。改 Path 我坚持用图形界面或者用 PowerShell 的[Environment]::SetEnvironmentVariable方法不用setx碰 Path。2.3 macOS 与 Linux 上的配置方式macOS 上装 JDK 最省事的方式是用包管理器装完之后系统自带的/usr/libexec/java_home工具能列出所有已安装的 JDK参数-V看清单-v 11直接拿到对应版本的路径。配置写进~/.zshrcexport JAVA_HOME$(/usr/libexec/java_home -v 11) export PATH$JAVA_HOME/bin:$PATH注意这里的顺序把$JAVA_HOME/bin放在$PATH前面是刻意的跟 Windows 上上移是一个道理。改完执行source ~/.zshrc或者新开一个终端窗口。macOS 上另一个坑是 Apple 芯片和 Intel 芯片的架构区分下载时要选对 arm64 或者 x64装错了会提示无法运行。Linux 上惯用两种做法。传统做法是把解压后的 JDK 放到/usr/lib/jvm/jdk-11.0.20然后在/etc/profile.d/下建一个jdk11.sh脚本写JAVA_HOME和PATH这样对所有用户生效。更规范的做法是用update-alternatives注册好处是可以在多个 JDK 之间用一条命令切换sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-11.0.20/bin/java 1100 sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/jdk-11.0.20/bin/javac 1100 sudo update-alternatives --config java最后一条命令会列出所有已注册的候选版本输入编号即可切换。数字1100是优先级数字越大默认优先级越高一般用版本号*100的规则来设这样 JDK11 就是 1100JDK21 是 2100一眼能看出对应关系。服务器上部署时记得JAVA_HOME也要跟着改光切java命令不够。2.4 不装虚拟机也能在 JDK11 和 JDK21 之间来回切Windows 上没有update-alternatives这种工具手工改图形界面又太慢。我用的方案是锚点目录 目录联接思路是让JAVA_HOME永远指向一个固定位置D:\dev\jdk\current而这个current是一个目录联接junction指向当前想用的那个真实 JDK 目录。切换的时候只需要重建这个联接环境变量一个字都不用动。先手工创建一次联接然后写一个批处理方便后续切换echo off setlocal if %~111 set TARGETD:\dev\jdk\jdk-11.0.20 if %~121 set TARGETD:\dev\jdk\jdk-21.0.2 if not defined TARGET ( echo 用法: switch-jdk 11 ^| 21 exit /b 1 ) rmdir D:\dev\jdk\current 2nul mklink /J D:\dev\jdk\current %TARGET% echo 当前指向: %TARGET% echo 请重新打开命令行窗口使配置生效把这个文件存成switch-jdk.bat放到D:\dev\jdk\下并加进 Path以后敲switch-jdk 11就能切成 11。这里解释两个细节rmdir删除目录联接时只删链接本身不会动真实 JDK 目录里的文件所以是安全的mklink /J需要管理员权限或者开启开发者模式普通权限下会提示您没有足够的权限执行此操作这一点提前知道免得以为脚本写错了。Linux 和 macOS 上对应的是符号链接原理一样。macOS 上也可以写个 shell 函数丢进~/.zshrc用jdk11、jdk21两个短命令来切换当前会话的JAVA_HOME切换后只影响当前终端窗口和从它启动的程序对系统全局没有副作用适合临时测试。3. IDEA 安装与首次配置的关键动作JDK 就位之后轮到 IDEA。安装本身没有技术含量真正影响后续体验的是首次启动那一堆设置而这些设置大部分教程都略过了。3.1 安装落盘位置与安装选项安装包从 JetBrains 官网下载进下载页选好操作系统和版本社区版 / 旗舰版拿到.exe或者.dmg。Windows 安装向导里有几个选项值得说一下安装路径同样避开中文和空格我放在D:\dev\jetbrains\下Create Desktop Shortcut 和 Update PATH Variable 建议勾上后者会把 IDEA 的命令行启动器加进 Path方便以后在终端里用命令打开工程目录Update Context Menu 会在右键菜单加Open Folder as Project日常用得上勾上文件关联那几项.java、.kt 等按需我一般不全勾避免双击文件时被强制用 IDEA 打开。装完第一次启动会让你选主题、导入设置。如果之前用过 IDEA 并且有配置备份可以在这里导入全新开始就选不导入从零配一份干净的。IDE 还支持导入已有安装的配置如果你同时装了多个 JetBrains 产品统一配置能省不少重复劳动。3.2 第一次启动必调的几项设置打开设置面板快捷键CtrlAltS按下面的顺序过一遍第一步绑定 JDK。进入Build, Execution, Deployment → Build Tools → Maven → Runner把 JRE 设成 11别用 IDEA 内置的 JBR。同一条线进入Project Structure → Platform Settings → SDKs点Add JDK路径指向D:\dev\jdk\jdk-11.0.20。IDEA 会自己扫一遍这个目录并生成一个 SDK 条目之后建项目时就能直接选。如果你用锚点目录方案这里也可以直接指D:\dev\jdk\current切换后 IDEA 重启一下就跟着切了。第二步调内存。菜单Help → Change Memory Settings把最大堆调大一点我一般设 2048 到 4096 MB。这台机器内存 16G 的话给 4096 比较舒服8G 内存的机器给 2048再大反而会挤压操作系统。改完要重启 IDEA。这一步直接影响索引速度和运行流畅度很多人抱怨IDEA 卡八成是默认堆偏小加上项目索引量大。第三步统一编码。进Editor → File Encodings把Global Encoding、Project Encoding、Default encoding for properties files三处都设成 UTF-8并勾上Transparent native-to-ascii conversion。这最后一项是针对 properties 文件的配置文件的转义显示靠它。控制台输出中文乱码的问题光靠这一处不一定够后面排查章节会讲完整方案。第四步关掉不必要的自动行为。Appearance Behavior → System Settings里可以取消勾选自动更新检查避免工作到一半弹窗打断Save files on frame deactivation保持勾选切窗口时自动保存比手动按CtrlS更省心。IDEA 本身基于内存中的文档状态运行编译时用的是内存里的内容所以没保存就编译其实不会出问题但保持这个勾选能让磁盘上的文件与内存一致方便你切到命令行构建。第五步把项目目录和索引目录加进杀毒软件白名单。这条是实打实的提速经验。Windows Defender 或者第三方杀软会实时扫描 IDEA 的索引缓存目录一般在%LOCALAPPDATA%\JetBrains\下面和你的工程目录项目一大索引速度会被拖到怀疑人生。把这两类目录加入排除项重新索引时间能明显下降。3.3 Maven 与依赖下载加速如果项目用 Maven 构建IDEA 内置了一份 Maven但我更推荐本机单独装一份版本可控命令行和 IDE 用的是同一套行为和同一份配置排查问题时不至于出现命令行能跑 IDE 不能跑的分裂状态。本地装好 Maven 后重点是settings.xml。这个文件一般放在conf/目录下全局或者~/.m2/目录下用户级我习惯用用户级那份重装 Maven 不受影响。核心是配镜像和本地仓库位置settings localRepositoryD:/dev/m2repo/localRepository mirrors mirror idaliyun-public/id namealiyun public/name urlhttps://maven.aliyun.com/repository/public/url mirrorOfcentral/mirrorOf /mirror /mirrors /settingsmirrorOf写central表示只接管中央仓库的请求其他私服、快照仓库仍然走各自配置这样不会误伤公司内网的依赖源。配完之后回到 IDEA 的 Maven 设置页三处都要显式指定并勾上覆盖Maven home path指向本地 Maven 目录User settings file指向刚才那份settings.xmlLocal repository确认已经识别成你设定的路径。很多人只改了前两项本地仓库还是默认的用户目录结果配置看着对、依赖还是往老地方下白白疑惑半天。顺带说一句同类工具的共性Node.js 环境配置也有换源的环节npm registry 指向国内镜像Python 环境配置要处理 pip 索引地址Anaconda 配 PyTorch 要处理 CUDA 版本匹配。这些工具链的配置思路是一致的——下载源、安装目录、版本绑定这三件事理清楚环境就稳了。3.4 插件与中文界面只装必要的那几个插件这块我的态度是克制。每装一个插件IDEA 启动时都要加载它的类内存占用和启动时间都会增加插件之间有冲突时排查成本更高。日常 Java 后端开发我固定装这几个Lombok项目用了 Lombok 就必装否则Data生成的 getter/setter 在 IDE 里全部标红看着像编译错误MyBatisX或类似的 Mapper 跳转插件写 MyBatis 项目时 XML 和接口之间来回跳提升非常明显官方中文语言包在Plugins → Marketplace里搜Chinese (Simplified)这是 JetBrains 官方维护的本地化插件装完重启界面就变中文。注意只认这一个别去装来路不明的第三方汉化包按需再加.env files支持、Rainbow Brackets 这类纯视觉插件看个人喜好。插件安装后如果 IDE 启动变慢或者出现莫名崩溃第一件事就是进Help → Show Log in Explorer看日志里面会记录是哪个插件抛的异常。同时按住Ctrl双击启动图标可以进安全模式禁用所有插件启动用来判断问题是不是插件引起的。这个排查手法比重新安装 IDE 高效得多。4. 实战用 JDK11 从零跑通一个能打包的项目配置都调好了得有个实际项目验证一下不然你不知道自己配的环境是不是真的能出活。下面用一个标准 Maven 工程走完全流程。4.1 建工程时容易被忽略的三个选项File → New → Project左侧选New Project中间选Maven这时候右边会出现几个关键项第一个是 JDK 选择框一定要选到 11。这里如果显示的是Project SDK: no SDK或者指向了 21先点下拉框选到正确的 JDK缺了就点Add JDK现场加。这一项决定了 IDEA 用哪个 JDK 去做语法分析和编译选错了后面全错。第二个是Add sample code初学者建议勾上IDEA 会生成一个带main方法的Main类方便你立刻点绿色三角运行起来验证环境。第三个容易被忽略的是项目位置。Location里的路径不要有中文、不要有空格、不要放在同步盘目录。这个限制不是 IDEA 的毛病而是构建工具链在传递路径参数时对特殊字符的处理不够健壮出现问题时现象千奇百怪不如一开始就避免。如果建的是 Spring Boot 项目走Spring Initializr那条路那有个硬性约束必须知道Spring Boot 3.0 开始要求 Java 17 作为最低版本JDK11 环境下只能选 2.7.x 及以下的版本线。在 Initializr 页面上把 Spring Boot 版本切到 2.7.xJava 版本选 11这样生成出来的骨架才能正常编译。选错了会直接报类文件版本不兼容新手很容易在这里卡住。4.2 release、source/target 到底怎么填Maven 项目编译版本的控制在pom.xml的maven-compiler-plugin里。老项目里常见两种写法一种是配source和target都是 11另一种是配release11/release。这两种不是等价的差别值得讲清楚。source只告诉编译器按哪个版本的语法解析源代码target只告诉它生成哪个版本的字节码两者都不检查你调用的 API 在这个版本里到底存不存在。问题就出在这里你在 JDK21 环境下编译一份source/target都设为 11 的代码代码里顺手用了一个 JDK21 才有的方法编译能过字节码版本也对但拿到 JDK11 的运行环境里就炸了报NoSuchMethodError。这种错误在开发机上永远复现不了只在上线时冒出来相当难查。release参数解决了这个问题它会让编译器同时用对应版本的 API 签名快照也就是ct.sym做校验调用了高版本 API 会直接编译报错把问题拦在构建阶段。所以我推荐统一用这个写法plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId version3.11.0/version configuration release11/release encodingUTF-8/encoding /configuration /pluginencoding也顺手写上避免源码里的中文注释在处理时出问题。为了让你对照着判断字节码版本是否匹配下面这张表建议存下来Java 版本字节码 major 版本常见报错提示852Unsupported class file major version 521155Unsupported class file major version 551761Unsupported class file major version 612165Unsupported class file major version 65看到报错里的数字比你的运行环境高就说明是拿高版本 JDK 编译、拿低版本运行的组合按表一查就知道该改哪边。4.3 编译、打包、运行三步验证工程建好之后按顺序验证每一步都确认结果比一口气打包完再排查高效。第一步在 IDEA 里执行Build → Rebuild Project看底部 Build 面板有没有报错。这一步检验的是语法分析和编译配置对不对。如果报语言级别相关的问题去Project Structure → Project看一眼Language level是不是 11再看Modules里每个模块的Language level有没有被单独覆盖成别的值。这两个地方的设置优先级不一样模块级会覆盖项目级是常见的坑点。第二步切到命令行在项目根目录执行mvn -v mvn clean package -DskipTests第一条确认 Maven 用的 JDK 是不是 11会打印Java version: 11.x.x第二条正常应该输出BUILD SUCCESS并在target目录下生成 jar。这一步检验的是系统环境变量和 Maven 配置是否一致。如果mvn -v显示的 Java 版本不对说明JAVA_HOME没生效或者被其他路径抢先如果依赖下不下来回到 3.3 检查镜像。第三步运行产物java -jar target/your-app-1.0-SNAPSHOT.jar跑起来没报UnsupportedClassVersionError说明字节码版本匹配。想更严谨的话可以拿javap看一眼类文件的实际版本javap -verbose target/classes/com/example/Main.class | findstr major输出major version: 55就对了55 正是 Java 11 的字节码版本号。5. 常见问题与排查技巧实录前面都是顺利路径实际动手时大概率会撞上几个报错。下面这些是我这些年被问得最多、也最容易浪费时间的几类。5.1 环境变量类的怪问题改了变量但完全不生效。最常见的原因是没有重开终端。Windows 下环境变量是在进程启动时读取的已经打开的 cmd、PowerShell、IDEA 都拿的是旧快照。改完变量后命令行窗口全部关掉重开IDEA 要从菜单完全退出不是点右上角那个叉确认托盘和后台进程都没了再启动否则它继承的环境还是老的。java -version对了但javac -version不对。这说明 Path 里存在两个不同来源的 JDKjava.exe命中了新的javac.exe还命中旧的。用where java和where javac分别查一遍把优先级调对。有些 JDK 安装程序只往 Path 里写了自己的一部分没写 javac这种情况只能手工补。JAVA_HOME的值写法错误。带了\bin、带了结尾分号、带了引号这三种都会让 Maven 或 Gradle 在解析时报错提示信息往往跟invalid directory有关看着跟路径不存在一样实际上是格式问题。正确写法就是纯目录D:\dev\jdk\jdk-11.0.20这个形式。IDEA 里能跑但命令行报错。这几乎可以确定是 IDEA 的项目 SDK 和系统JAVA_HOME指向不同版本。检查Project Structure → SDKs和系统变量把两者统一。5.2 IDEA 里的 JDK 相关报错语言级别不匹配的红色波浪线。提示类似Language level 8 does not support...或者反过来代码里用了 11 的语法但语言级别设的是 8。三个地方要一起看Project Structure → Project → Language level、Project Structure → Modules → Sources → Language level、以及pom.xml里的maven-compiler-plugin配置。三处任意一处不对都可能触发最省事的做法是把它们设成同一个值。IDEA 找不到 JDK 或者提示 SDK 无效。通常是因为 JDK 目录被移动、重命名或者用了锚点目录但联接被删了。重新进SDKs编辑路径即可。顺带提一句如果看到Cannot determine path to tools.jar这种提示这是老版本 IDEA 配合新版本 JDK 的典型症状tools.jar在 JDK9 之后就已经从 JDK 里移除了解决办法是升级 IDEA 版本而不是去网上找一个tools.jar塞进去。IDEA 自己突然关闭或者启动很慢。内存不足是首要怀疑对象去Help → Change Memory Settings把堆调大并重启。其次是插件冲突用Help → Show Log in Explorer看日志里的异常栈。还有一种情况是项目放在同步盘目录里文件被同步进程频繁读写索引一直重算表现出来就是卡和崩把工程挪到本地目录就能解决。至于网上那些关于IDEA 自动关闭是为了让你重新授权的说法来源不明我不做评价遇到异常老老实实看日志比猜原因靠谱。5.3 编码、依赖、索引这三类高频故障控制台中文乱码。这个要分两层看。编译期源码编码靠pom.xml里的encodingUTF-8/encoding和 IDEA 的 File Encodings 设置保证运行期的输出编码取决于 JVM 的file.encoding参数。JDK11 下这个参数的默认值跟随操作系统区域设置中文 Windows 上通常是 GBK而 IDEA 控制台期望 UTF-8两边对不上就出乱码。解决办法是在运行配置的 VM options 里加-Dfile.encodingUTF-8命令行运行时可以配合chcp 65001切换控制台代码页。注意这是 JDK11 的情况JDK18 之后默认改成 UTF-8 了所以你会看到有的教程说不用配那是针对新版本的环境和结论要对应。Maven 依赖拉不下来。先看是不是网络问题——把镜像配好之后还失败的去本地仓库目录找到对应的文件夹删掉里面的*.lastUpdated文件和_remote.repositories再重新mvn clean package -U。那些后缀文件是失败记录的缓存不删的话 Maven 会认为这个依赖已经尝试过并放弃了。另外检查一下公司有没有代理设置需要配置settings.xml里的proxies节点可以处理。索引一直卡在扫描中。前面提过杀软白名单的思路另一个常见原因是项目里有大量node_modules、target、build这类目录被当成源码扫描了。在Project Structure → Modules里把构建产物目录标记为Excluded索引量会立刻降下来。5.4 一张速查表收尾把上面的排查经验整理成表格遇到问题时从上往下对照着查大部分场景能在几分钟内定位现象最可能的原因处理动作java -version版本不对Path 里旧路径排在前面用where java查顺序把%JAVA_HOME%\bin上移javac -version与java不一致两套 JDK 混在 Path 里分别查where java和where javac清理多余条目Maven 报 invalid JAVA_HOME变量值带了 bin、引号或分号改成纯 JDK 根目录编译通过但运行报 UnsupportedClassVersion编译用高版本、运行用低版本统一release与运行 JDK 版本IDEA 里标红但命令行能编译项目 Language level 设置偏低检查 Project 与 Modules 两处语言级别控制台中文乱码运行期file.encoding与终端不一致VM options 加-Dfile.encodingUTF-8依赖反复下载失败本地仓库有失败缓存删除*.lastUpdated后加-U重试索引卡顿、IDE 变慢杀软扫描或构建目录被索引加白名单、把输出目录标记 Excluded最后分享一个我自己坚持了很多年的习惯每换一台新机器先把这套环境配好然后写一个env-check命令里面依次执行java -version、javac -version、mvn -v、where java全部输出到一个文本文件里存档。下次遇到诡异问题时把这份快照跟出问题时的输出一对比差异点往往就是问题所在。环境配置这件事配一次只值一次让它可查、可比、可复制才值很多次。