Java多类协同编译运行方法解析

本文深入解析Java多类协同开发中的核心痛点——当多个public类相互依赖时频繁出现的“cannot find symbol”编译错误，直击Java 11+单文件执行模式（java FileName.java）无法自动编译被引用类的根本缺陷；不仅系统对比了手动编译（javac/java两步法）的局限与风险，更重点推荐并手把手演示了Maven和Gradle两大现代构建工具的标准实践：从IDE一键创建项目、规范目录结构、精准配置依赖（含本地JAR处理），到一键编译、运行与测试，真正帮你告别类路径混乱、编译顺序错乱和工程不可复现的困境——无论你是刚接触多类协作的新手，还是希望提升项目健壮性的开发者，这篇文章都为你铺就一条从“能跑通”迈向“可维护、可协作、可持续演进”的专业Java开发之路。

本文讲解如何在Java开发中正确处理同一项目内多个public类之间的依赖关系，解决“cannot find symbol”编译错误，重点介绍现代构建工具（Maven/Gradle）的标准化用法，并对比说明传统手动编译的注意事项。

在Java中，当一个.java文件引用了同项目下另一个public类（例如 Main.java 调用 Utils.java），直接使用 java FileName.java（即Java 11+的单文件执行模式）无法自动识别并编译被依赖的类——因为该模式仅编译并运行指定文件，不会递归解析、编译同目录下的其他源文件。这正是你遇到 error: cannot find symbol 的根本原因。

✅ 推荐方案：使用标准构建工具（Maven 或 Gradle）

现代Java开发应摒弃手动管理类路径（-cp）和零散编译的方式，转而采用约定优于配置（Convention over Configuration）的构建系统。IntelliJ IDEA 原生深度集成 Maven 和 Gradle，能自动处理源码组织、依赖解析、编译顺序与类路径构建。

▶ 创建 Maven 项目（推荐新手入门）

1. 在 IntelliJ 中选择 New Project → Maven（勾选 “Create from archetype” 可选 maven-archetype-quickstart）；

2. 项目结构自动遵循标准布局：

   my-project/
   ├── pom.xml                     ← 依赖与插件配置中心
   └── src/
       └── main/
           └── java/
               ├── Main.java       ← public class Main { ... }
               └── Utils.java      ← public class Utils { ... }

3. 在 pom.xml 中声明所需外部库（如你的 .jar）：

   <dependencies>
       <dependency>
           <groupId>com.example</groupId>
           <artifactId>my-library</artifactId>
           <version>1.0.0</version>
           <scope>system</scope>
           <systemPath>${project.basedir}/lib/your-lib.jar</systemPath>
       </dependency>
   </dependencies>

   ? 提示：优先使用中央仓库坐标（groupId:artifactId:version）；若必须用本地 JAR，请配合 system 和 ，但注意该方式不参与传递依赖管理。

4. 点击 IDE 右侧 Maven 工具窗口 → Lifecycle → compile，或执行命令：

   mvn clean compile

   所有 src/main/java/ 下的 .java 文件将被自动编译为 .class，并正确解析相互引用。

5. 运行主类（IDEA 内右键 Main.java → Run 'Main.main()'），或通过 Maven 执行：

   mvn exec:java -Dexec.mainClass="Main"

▶ Gradle 方式（更灵活，DSL 更简洁）

创建 Gradle 项目后，build.gradle 示例：

plugins {
    id 'java'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation files('lib/your-lib.jar') // 本地 JAR 引用
    // 或使用远程依赖：implementation 'org.apache.commons:commons-lang3:3.12.0'
}

application {
    mainClass = 'Main'
}

执行：

./gradlew build
./gradlew run

⚠️ 备选方案：手动编译（仅限学习理解，不建议长期使用）

若暂不引入构建工具，需严格分两步操作（以 JDK 17+ 为例）：

1. 先编译所有相关源文件（确保 Utils.java 和 Main.java 同时参与编译）：

   javac -cp ".;path/to/your-lib.jar" Utils.java Main.java

   ? Windows 使用分号 ; 分隔类路径，Linux/macOS 用冒号 :
   ? -cp 必须包含当前目录 .（以便找到生成的 .class），以及你的第三方 JAR

2. 再运行主类（此时 .class 已就绪，JVM 可正常加载）：

   java -cp ".;path/to/your-lib.jar" Main

⚠️ 注意事项：

• java FileName.java 是 Java 11 引入的便捷单文件执行模式，仅适用于无跨文件依赖的独立脚本；
• public 类名必须与文件名完全一致，且每个 .java 文件最多声明一个 public 类；
• 手动管理类路径易出错，尤其在项目扩大、依赖增多时，维护成本急剧上升。

✅ 总结

掌握构建工具不是增加负担，而是获得可复现、可协作、可持续演进的工程能力。从第一个多类项目开始，就让 Maven 或 Gradle 成为你 Java 开发的“默认起点”。

好了，本文到此结束，带大家了解了《Java多类协同编译运行方法解析》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！