Debian Java编译时依赖库怎么管理

Debian Java 编译时依赖管理

一 准备环境

• 安装 JDK（编译必需）：例如安装 OpenJDK 11 或 OpenJDK 17。
  • 命令：sudo apt update && sudo apt install openjdk-11-jdk（或 openjdk-17-jdk）
  • 验证：java -version、javac -version
• 可选 配置 JAVA_HOME（便于工具链统一）
  • 编辑 /etc/environment：JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"
  • 使生效：source /etc/environment；验证：echo $JAVA_HOME
• 如需切换 JDK 版本：sudo update-alternatives --config java（按提示选择默认 java/javac）

二 推荐方式 使用构建工具管理依赖

• 使用 Maven
  • 安装：sudo apt install maven
  • 在 pom.xml 的 <dependencies> 中声明依赖，执行 mvn compile 自动下载依赖并编译
  • 常用：mvn compile、mvn package、mvn exec:java
• 使用 Gradle
  • 安装：sudo apt install gradle
  • 在 build.gradle 的 dependencies 中声明依赖，执行 ./gradlew build 自动解析并编译
  • 常用：./gradlew build、./gradlew run
• 说明：Maven/Gradle 会从远程仓库（如 Maven Central）下载依赖，避免手动维护 JAR，适合中大型项目。

三 使用 Debian 系统包管理 APT 安装依赖

• 适用场景：依赖已被 Debian 打包 为 -java 类库（如数据库驱动、常用框架的打包版本）
• 安装示例：sudo apt-get install libmysql-java
• 查找可用包：apt search openjdk- 或 apt search <关键词>-java
• 优点：与系统其他软件包一致，依赖解析与升级由 APT 统一管理
• 局限：版本可能滞后于上游；若仓库未提供所需库，应改用构建工具从中央仓库拉取。

四 无构建工具时的手动管理

• 将第三方 JAR 放入项目 lib/ 目录
• 编译与运行通过 -cp 指定类路径
  • 编译：javac -cp ".:lib/*" YourJavaFile.java
  • 运行：java -cp ".:lib/*" YourJavaFile
• 注意：Linux 类路径分隔符为 :，Windows 为 ;。

五 常见问题与排查

• 依赖冲突或版本不一致
  • 优先使用构建工具的 依赖收敛/排除 机制（如 Maven 的 <exclusions>）
  • 避免同一依赖同时来自 APT 与 Maven/Gradle 造成重复
• 构建时报 “依赖找不到”
  • 确认仓库中存在该构件（Maven/Gradle 输出详细依赖树排查）
  • 若只能用系统包，改用 apt search 查找对应 -java 包
• APT 依赖错误
  • 更新索引：sudo apt update
  • 修复破损依赖：sudo apt-get -f install
  • 安装构建依赖：sudo apt-get build-dep <package-name>
• 多 JDK 并存导致编译用错版本
  • 使用 update-alternatives --config java 统一 java/javac 版本
• 需要模块化（Java 9+）
  • 使用 JPMS，在 module-info.java 中声明 requires，与构建工具配合使用