IntelliJ中Java项目默认配置异常及ClassNotFoundException问题解析

默认配置编译器输出路径错误的原因 #

IntelliJ默认编译器输出路径一般是基于项目根目录的相对路径（比如out/production/[模块名]），出现错误的常见诱因包括：

• 路径包含中文、空格或特殊字符，导致IDEA无法正常解析或创建目录
• D盘目录存在权限限制（如开启BitLocker加密、只读权限），IDEA无法写入输出文件
• 项目导入时路径映射异常，默认路径指向了不存在的位置

切换模块输出路径后出现ClassNotFoundException的原因 #

切换模块编译器输出路径选项后，IDEA的运行配置大概率没同步更新类路径。此时JVM通过-classpath参数查找类文件时，仍指向旧的输出路径，找不到新编译的.class文件，因此抛出异常。

手动指定输出路径后解决问题的逻辑 #

手动指定编译器输出路径后，IDEA会自动更新运行配置中的-classpath参数，将指定的输出目录纳入类路径范围。JVM执行主方法时，就能通过这个参数准确定位到编译后的.class文件，问题自然解决。

Java和IntelliJ安装在D盘的影响 #

正常情况下，安装位置在D盘不会直接引发配置问题，但如果D盘存在以下情况则可能出问题：

• 目录路径包含中文、空格或特殊符号
• 系统对D盘目录设置了严格的读写权限
• 磁盘空间不足，无法创建输出目录

为何需要手动设置源码根目录 #

IntelliJ是基于目录类型管理项目的，只有将文件夹标记为源码根目录（Sources Root），IDEA才会：

• 识别该目录下的.java文件为可编译的源码文件
• 按照包结构编译这些文件到指定输出目录
• 生成运行配置时，将该目录对应的输出路径纳入-classpath参数
• 提供代码补全、语法检查等针对源码的开发支持

如果不手动设置，IDEA会把该目录当作普通文件夹处理，不会编译其中的Java文件，必然出现找不到类的问题。

内容的提问来源于stack exchange，提问作者anshu_anand