CentOS 8 安装 Apache Commons Geometry 指南
在 CentOS 8 上从零搭建 Apache Commons Geometry 1.0 使用环境，覆盖 JDK 17 与 Maven 准备、在线依赖引入、官方二进制包离线安装与源码编译三套方案，并给出真实编译运行验证与常见问题排查。
CentOS 8 安装 Apache Commons Geometry 指南
目标：在 CentOS 8 上从零搭建 Apache Commons Geometry 1.0 的使用环境，完成 JDK 17 + Maven 环境准备、三种依赖获取方式与真实几何运算验证。以下全部命令与回显均已在 CentOS 8（x86_64）实测通过。
一、环境信息
本节先固定本次实测所用软硬件基线，便于读者逐项对照复现。
- 操作系统：CentOS Linux release 8.5.2111（x86_64）
- JDK：OpenJDK 17.0.1（
java-17-openjdk-devel，java -version实测） - 构建工具：Apache Maven 3.5.4（Red Hat 构建版，系统仓库默认版本）
- 目标库：Apache Commons Geometry 1.0（groupId
org.apache.commons） - 依赖来源：
https://downloads.apache.org/commons/geometry/、https://repo1.maven.org/maven2/（网络直连可达） - Maven 示例工程目录：
/opt/geo-demo - 官方二进制包解压目录：
/opt/commons-geometry/1.0 - 手动 jar 存放目录：
/opt/geo-jars
先确认系统版本与架构：
cat /etc/redhat-release
uname -m
输出：
CentOS Linux release 8.5.2111
x86_64
二、前置条件
在开始安装前，请确认以下条件满足，否则后续步骤会因权限或网络问题中断。本节说明每项前置条件的作用与验证方法。
- root 权限或 sudo：安装 JDK、Maven 需要写入系统目录（
/usr/lib/jvm、/usr/share/maven）。 - 网络可达：需要访问
downloads.apache.org（官方二进制/源码包）与repo1.maven.org（Maven 中央仓库）。 - 磁盘空间：官方二进制包约 8 MB，加上本地 Maven 仓库缓存建议预留 ≥ 200 MB。
- 注意多 JDK 并存：CentOS 8 默认可能同时存在 JDK 8 与 JDK 17，系统 Maven 默认可能选中 JDK 8，务必按第四、八节设置
JAVA_HOME指向 JDK 17。
验证网络连通性（该库的下载目录与 Maven 中央仓库各探测一次）：
curl -sI https://downloads.apache.org/commons/geometry/ | head -1
curl -sI https://repo1.maven.org/maven2/org/apache/commons/commons-geometry-core/ | head -1
输出：
HTTP/1.1 200 OK
HTTP/1.1 200 OK
⚠️ 注意：若内网无法直连上述域名，需按企业代理配置放行，否则 Maven 依赖与官方包均无法获取。本文实测环境为直连。
三、版本选型说明
Apache Commons Geometry 是 Apache 基金会的几何计算工具库。安装前先确认应选用的版本与模块，避免引入错误坐标。本节给出官方发行目录的实测版本清单与模块构成。
查询 downloads.apache.org 上的发行目录：
curl -s https://downloads.apache.org/commons/geometry/binaries/ | grep -oE 'commons-geometry-[0-9a-z.-]+-bin\.tar\.gz' | sort -u
输出：
commons-geometry-1.0-bin.tar.gz
说明：downloads.apache.org 只保留当前最新发行版，本次实测为 1.0；历史版本需到 archive.apache.org/dist/commons/geometry/binaries/ 获取，实测归档目录含两个版本：
curl -s https://archive.apache.org/dist/commons/geometry/binaries/ | grep -oE 'commons-geometry-[0-9a-z.-]+-bin\.tar\.gz' | sort -u
输出：
commons-geometry-1.0-beta1-bin.tar.gz
commons-geometry-1.0-bin.tar.gz
版本对照与选型：
| 版本 | 状态 | 发布日期线 | 建议 |
|---|---|---|---|
| 1.0 | 正式发行（release） | 首个正式版 | 生产环境首选 |
| 1.0-beta1 | 测试版（beta） | 早于 1.0 | 仅用于验证历史行为 |
💡 技术拓展：几何计算库不止本文所用的 Apache Commons Geometry。常见选项对比——
库 语言/形态 特点 适用场景 Commons Geometry Java 纯库 Apache 出品、坐标/向量/直线/区域 BSP 类型丰富、无 JTS 依赖 Java 服务内轻量几何运算 JTS Topology Suite Java 纯库 二维拓扑、空间关系与几何谓词最完备 GIS 拓扑、空间分析 GeoTools Java 库 基于 JTS 的 GIS 工具集、坐标参考系统丰富 地图数据与投影处理 Shapely Python 库 基于 GEOS，交互式脚本友好 数据分析/脚本化几何处理 本文属于 Java 服务内几何计算场景，选用 Apache Commons Geometry：它不依赖 JTS、模块清晰、2D/3D 一体，且可通过 Maven 直接引入。
查询 Maven 中央仓库的实际可用版本：
curl -s https://repo1.maven.org/maven2/org/apache/commons/commons-geometry-euclidean/maven-metadata.xml
输出：
<?xml version="1.0" encoding="UTF-8"?>
<metadata>
<groupId>org.apache.commons</groupId>
<artifactId>commons-geometry-euclidean</artifactId>
<versioning>
<latest>1.0</latest>
<release>1.0</release>
<versions>
<version>1.0-beta1</version>
<version>1.0</version>
</versions>
<lastUpdated>20210821014444</lastUpdated>
</versioning>
</metadata>
1.0 正式发行版包含的模块（实测各 artifact 的 <release> 版本）如下：
| Maven artifact（groupId 均为 org.apache.commons） | release | 作用 |
|---|---|---|
| commons-geometry-core | 1.0 | 核心抽象：点/向量/超平面/BSP 区域 |
| commons-geometry-euclidean | 1.0 | 欧几里得 1D/2D/3D 几何类型 |
| commons-geometry-spherical | 1.0 | 球面几何 |
| commons-geometry-io-core | 1.0 | 几何 IO 抽象 |
| commons-geometry-io-euclidean | 1.0 | 欧几里得几何 IO（文本格式） |
注意：
commons-geometry-enclosing、commons-geometry-hull、commons-geometry-examples-*在 Maven 上仅有1.0-beta1，未随 1.0 正式发行，选用时勿误引。
日常开发绝大多数场景只需引入 commons-geometry-euclidean（它会传递引入 commons-geometry-core）。实测其完整传递依赖：
cd /opt/geo-demo
mvn -B dependency:tree
输出节选（实测首尾）：
[INFO] demo:geometry-demo:jar:1.0.0
[INFO] \- org.apache.commons:commons-geometry-euclidean:jar:1.0:compile
[INFO] +- org.apache.commons:commons-geometry-core:jar:1.0:compile
[INFO] +- org.apache.commons:commons-numbers-core:jar:1.0:compile
[INFO] +- org.apache.commons:commons-numbers-arrays:jar:1.0:compile
[INFO] +- org.apache.commons:commons-numbers-angle:jar:1.0:compile
[INFO] \- org.apache.commons:commons-numbers-quaternion:jar:1.0:compile
[INFO] BUILD SUCCESS
解读：commons-geometry-euclidean 依赖 commons-geometry-core 与 commons-numbers-*（core/arrays/angle/quaternion），版本均为 1.0。使用 Maven 时会自动解析，手动 jar 方式（方案 B）需自行补齐这 5 个依赖 jar。
四、在线安装方案（A：Maven 依赖引入）
官方推荐方式：通过 Maven 引入依赖，由构建工具自动解析传递依赖。适合可联网的开发/构建环境。
4.1 方案说明与适用场景
本方案在系统安装 JDK 与 Maven，再用一个最小 Maven 工程引入 commons-geometry-euclidean:1.0，最后编译运行验证。适合持续集成、可访问中央仓库的场景。
4.2 安装 JDK 17 与 Maven
先安装 JDK 17（Commons Geometry 要求 Java 8+，本文使用 17 LTS）与 Maven：
dnf install -y java-17-openjdk-devel maven
输出节选（实测首尾）：
Last metadata expiration check: 0:21:08 ago on Tue Oct 13 17:38:01 2026.
Package java-17-openjdk-devel-1:17.0.1.0.12-2.el8_5.x86_64 is already installed.
Package maven-1:3.5.4-5.module_el8.0.0+39+6a9b6e22.noarch is already installed.
Dependencies resolved.
Nothing to do.
Complete!
⚠️ 注意：若系统已装过，
dnf会提示Nothing to do.（如上）；新装时输出会含Installing: java-17-openjdk-devel ... maven ...，随后Complete!。
验证 JDK 生效：
java -version
输出：
openjdk version "17.0.1" 2021-10-19 LTS
OpenJDK Runtime Environment 21.9 (build 17.0.1+12-LTS)
OpenJDK 64-Bit Server VM 21.9 (build 17.0.1+12-LTS, mixed mode, sharing)
确认系统 JDK 备选清单（可看到 JDK 8 与 JDK 17 并存，java 命令当前指向 17）：
alternatives --list | grep -i java
输出：
java_sdk_1.8.0_openjdk auto /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-2.el8_5.x86_64
java manual /usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64/bin/java
jre_openjdk auto /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-2.el8_5.x86_64/jre
java_sdk_openjdk auto /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-2.el8_5.x86_64
javac auto /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-2.el8_5.x86_64/bin/javac
java_sdk_1.8.0 auto /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-2.el8_5.x86_64
jre_1.8.0 auto /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-2.el8_5.x86_64/jre
jre_17 auto /usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
4.3 配置 Maven 使用 JDK 17
⚠️ 注意：CentOS 8 的系统 Maven（3.5.4）默认通过
java-functions机制解析 JDK，实测默认解析到系统里优先级最高的 Java 8，导致mvn -version显示Java version: 1.8.0_312。必须显式指定JAVA_HOME指向 JDK 17 才能编译 Java 17 代码。先看默认行为：
mvn -version
输出节选（实测首尾）：
Apache Maven 3.5.4 (Red Hat 3.5.4-5)
Maven home: /usr/share/maven
Java version: 1.8.0_312, vendor: Red Hat, Inc., runtime: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-2.el8_5.x86_64/jre
Default locale: en_US, platform encoding: ANSI_X3.4-1968
OS name: "linux", version: "6.8.0-138-generic", arch: "amd64", family: "unix"
设置后验证：
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
mvn -version
输出：
Apache Maven 3.5.4 (Red Hat 3.5.4-5)
Maven home: /usr/share/maven
Java version: 17.0.1, vendor: Red Hat, Inc., runtime: /usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
Default locale: en_US, platform encoding: ANSI_X3.4-1968
OS name: "linux", version: "6.8.0-138-generic", arch: "amd64", family: "unix"
关键点：Java version 变为 17.0.1，说明 Maven 已切换到 JDK 17。该 export 仅对当前会话生效；若需持久化，写入 /etc/profile.d/java17.sh（见第八节）。
4.4 创建 Maven 工程并引入依赖
创建工程目录并写入 pom.xml：
mkdir -p /opt/geo-demo/src/main/java
/opt/geo-demo/pom.xml 内容：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>demo</groupId>
<artifactId>geometry-demo</artifactId>
<version>1.0.0</version>
<packaging>jar</packaging>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-geometry-euclidean</artifactId>
<version>1.0</version>
</dependency>
</dependencies>
</project>
逐项说明：maven.compiler.source/target 指定 17（因此 Maven 必须用 JDK 17，见 4.3）；project.build.sourceEncoding 设为 UTF-8（源码含中文注释时必须，否则 javac 报 unmappable character）；dependencies 仅声明 commons-geometry-euclidean:1.0，其余依赖由 Maven 传递解析。
4.5 编写最小验证程序
/opt/geo-demo/src/main/java/GeometryCheck.java 内容：
import org.apache.commons.geometry.euclidean.twod.Line;
import org.apache.commons.geometry.euclidean.twod.Lines;
import org.apache.commons.geometry.euclidean.twod.Vector2D;
import org.apache.commons.numbers.core.Precision;
public class GeometryCheck {
public static void main(String[] args) {
Precision.DoubleEquivalence precision = Precision.doubleEquivalenceOfEpsilon(1e-10);
Vector2D a = Vector2D.of(0.0, 0.0);
Vector2D b = Vector2D.of(3.0, 4.0);
Line xAxis = Lines.fromPoints(a, Vector2D.of(4.0, 0.0), precision);
System.out.println("distance(a,b) = " + a.distance(b));
System.out.println("project (2,3) -> x = " + xAxis.project(Vector2D.of(2.0, 3.0)));
System.out.println("distance (2,3) -> x = " + xAxis.distance(Vector2D.of(2.0, 3.0)));
}
}
说明：用 Lines.fromPoints 构造 x 轴直线，分别计算两点距离、点的投影与点到直线的距离。
4.6 编译与运行验证
编译（注意先设置 JAVA_HOME，见 4.3）：
cd /opt/geo-demo
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
mvn -B compile
输出节选（实测首尾）：
[INFO] Building geometry-demo 1.0.0
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ geometry-demo ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 3 source files to /opt/geo-demo/target/classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] Total time: 1.922 s
运行（由 Maven 解析出依赖 classpath）：
mvn -q -B dependency:build-classpath -Dmdep.outputFile=cp.txt
java -Xmx256m -cp "target/classes:$(cat cp.txt)" GeometryCheck
输出：
distance(a,b) = 5.0
project (2,3) -> x = (2.0, 0.0)
distance (2,3) -> x = 3.0
验证点：distance(a,b) 为 5.0（3-4-5 直角三角形斜边），点 (2,3) 到 x 轴的投影为 (2.0, 0.0)，垂距为 3.0。三者与几何常识一致，说明依赖已正确引入且可运行。-Xmx256m 将堆内存限制在 256 MB，足以满足本示例运行。
五、离线安装方案（B：官方二进制包）
适合内网隔离、无法访问中央仓库的环境。使用官方 bin 发行包 + 手动补齐第三方依赖 jar。
5.1 方案说明与适用场景
官方 commons-geometry-1.0-bin.tar.gz 内含 5 个模块 jar 及源码/javadoc，但不含 commons-numbers-* 依赖。因此本方案需：下载官方包 → 校验 → 解压 → 额外下载 5 个依赖 jar → javac/java 直跑验证。
5.2 下载与校验
下载官方二进制包及其 SHA512 校验文件：
mkdir -p /opt/geo-src
cd /opt/geo-src
curl -sO https://downloads.apache.org/commons/geometry/binaries/commons-geometry-1.0-bin.tar.gz
curl -sO https://downloads.apache.org/commons/geometry/binaries/commons-geometry-1.0-bin.tar.gz.sha512
sha512sum -c commons-geometry-1.0-bin.tar.gz.sha512
输出：
commons-geometry-1.0-bin.tar.gz: OK
校验文件官方值与包大小（实测）：
cat commons-geometry-1.0-bin.tar.gz.sha512
ls -l commons-geometry-1.0-bin.tar.gz
输出：
b170b25f0c4c7837a51c8c3b37aa970c755c5610b16e6afa82f4cfea6dfa14f347366932e4e0ded921150ad4ad349f1d16661934925da6ece7253599fbd90cf0 *commons-geometry-1.0-bin.tar.gz
-rw-r--r-- 1 root root 8283160 Oct 13 18:01 commons-geometry-1.0-bin.tar.gz
哈希一致，包完整可信。包大小实测 8283160 字节。
5.3 解压与目录结构
解压并规范到 /opt/commons-geometry/1.0：
cd /opt/geo-src
tar xzf commons-geometry-1.0-bin.tar.gz
mkdir -p /opt/commons-geometry
mv commons-geometry-1.0 /opt/commons-geometry/1.0
ls /opt/commons-geometry/1.0/*.jar
输出：
/opt/commons-geometry/1.0/commons-geometry-core-1.0-javadoc.jar
/opt/commons-geometry/1.0/commons-geometry-core-1.0-sources.jar
/opt/commons-geometry/1.0/commons-geometry-core-1.0.jar
/opt/commons-geometry/1.0/commons-geometry-euclidean-1.0-javadoc.jar
/opt/commons-geometry/1.0/commons-geometry-euclidean-1.0-sources.jar
/opt/commons-geometry/1.0/commons-geometry-euclidean-1.0.jar
/opt/commons-geometry/1.0/commons-geometry-io-core-1.0-javadoc.jar
/opt/commons-geometry/1.0/commons-geometry-io-core-1.0-sources.jar
/opt/commons-geometry/1.0/commons-geometry-io-core-1.0.jar
/opt/commons-geometry/1.0/commons-geometry-io-euclidean-1.0-javadoc.jar
/opt/commons-geometry/1.0/commons-geometry-io-euclidean-1.0-sources.jar
/opt/commons-geometry/1.0/commons-geometry-io-euclidean-1.0.jar
/opt/commons-geometry/1.0/commons-geometry-spherical-1.0-javadoc.jar
/opt/commons-geometry/1.0/commons-geometry-spherical-1.0-sources.jar
/opt/commons-geometry/1.0/commons-geometry-spherical-1.0.jar
5.4 补齐第三方依赖 jar
由于 euclidean 依赖 commons-numbers-*，需一并下载到 /opt/geo-jars：
mkdir -p /opt/geo-jars
cd /opt/geo-jars
B=https://repo1.maven.org/maven2/org/apache/commons
curl -sO $B/commons-geometry-euclidean/1.0/commons-geometry-euclidean-1.0.jar
curl -sO $B/commons-geometry-core/1.0/commons-geometry-core-1.0.jar
curl -sO $B/commons-numbers-core/1.0/commons-numbers-core-1.0.jar
curl -sO $B/commons-numbers-arrays/1.0/commons-numbers-arrays-1.0.jar
curl -sO $B/commons-numbers-angle/1.0/commons-numbers-angle-1.0.jar
curl -sO $B/commons-numbers-quaternion/1.0/commons-numbers-quaternion-1.0.jar
ls -l
输出：
total 468
-rw-r--r-- 1 root root 89526 commons-geometry-core-1.0.jar
-rw-r--r-- 1 root root 303783 commons-geometry-euclidean-1.0.jar
-rw-r--r-- 1 root root 14357 commons-numbers-angle-1.0.jar
-rw-r--r-- 1 root root 12940 commons-numbers-arrays-1.0.jar
-rw-r--r-- 1 root root 25745 commons-numbers-core-1.0.jar
-rw-r--r-- 1 root root 20406 commons-numbers-quaternion-1.0.jar
5.5 手动编译运行验证
复用第 4.5 节的 GeometryCheck.java，直接以 jar 目录作为 classpath 编译并运行：
cd /opt/geo-demo
mkdir -p out2
javac -encoding UTF-8 -cp "/opt/geo-jars/*" -d out2 src/main/java/GeometryCheck.java
java -Xmx256m -cp "out2:/opt/geo-jars/*" GeometryCheck
输出：
distance(a,b) = 5.0
project (2,3) -> x = (2.0, 0.0)
distance (2,3) -> x = 3.0
验证点：结果与方案 A 完全一致。说明不依赖 Maven、纯 jar 直跑同样可用。-encoding UTF-8 用于源码含中文时避免 unmappable character 报错。
六、源码安装方案（C：官方源码编译）
适合需要定制、调试源码或跟随主线开发的场景。使用官方 src 源码包，由 Maven 编译出所有模块 jar。
6.1 方案说明与前置依赖
下载官方源码包并用 Maven 构建整个 reactor。构建需要 JDK 17（或 Java 8+）与 Maven，首次构建需联网下载构建插件。
6.2 下载与校验源码包
cd /opt/geo-src
curl -sO https://downloads.apache.org/commons/geometry/source/commons-geometry-1.0-src.tar.gz
curl -sO https://downloads.apache.org/commons/geometry/source/commons-geometry-1.0-src.tar.gz.sha512
sha512sum -c commons-geometry-1.0-src.tar.gz.sha512
输出：
commons-geometry-1.0-src.tar.gz: OK
校验文件官方值与包大小（实测）：
cat commons-geometry-1.0-src.tar.gz.sha512
ls -l commons-geometry-1.0-src.tar.gz
输出：
ad2c89958a3a6278135b2c820bc5c6d97edc49ea8dd119c44c49e764248e068ff0404b04cb620d0f10a7172b69ee0907f39483119c1fcd695ffe58f4c0d3731a *commons-geometry-1.0-src.tar.gz
-rw-r--r-- 1 root root 3866337 Oct 13 18:06 commons-geometry-1.0-src.tar.gz
哈希一致，源码包大小实测 3866337 字节。
6.3 解压与查看模块
cd /opt/geo-src
tar xzf commons-geometry-1.0-src.tar.gz
ls commons-geometry-1.0-src
输出：
CONTRIBUTING.md
LICENSE.txt
NOTICE.txt
README.md
RELEASE-NOTES.txt
commons-geometry-core
commons-geometry-euclidean
commons-geometry-examples
commons-geometry-io-core
commons-geometry-io-euclidean
commons-geometry-spherical
6.4 编译构建
执行 Maven 构建（跳过测试以加快速度，先设置 JAVA_HOME）：
cd /opt/geo-src/commons-geometry-1.0-src
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
mvn -B -DskipTests package
输出节选（实测首尾）：
[INFO] Building jar: /opt/geo-src/commons-geometry-1.0-src/commons-geometry-io-euclidean/target/commons-geometry-io-euclidean-1.0-tests.jar
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] Apache Commons Geometry 1.0 ........................ SUCCESS [03:00 min]
[INFO] Apache Commons Geometry Core ....................... SUCCESS [ 47.104 s]
[INFO] Apache Commons Geometry Euclidean .................. SUCCESS [ 8.080 s]
[INFO] Apache Commons Geometry Spherical .................. SUCCESS [ 1.814 s]
[INFO] Apache Commons Geometry IO Core .................... SUCCESS [ 1.334 s]
[INFO] Apache Commons Geometry IO Euclidean 1.0 ........... SUCCESS [ 1.579 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] Total time: 04:01 min
验证产物 jar 是否生成：
find /opt/geo-src/commons-geometry-1.0-src -name "commons-geometry-*-1.0.jar" -not -name "*sources*" -not -name "*javadoc*" -not -name "*tests*" | sort
输出：
/opt/geo-src/commons-geometry-1.0-src/commons-geometry-core/target/commons-geometry-core-1.0.jar
/opt/geo-src/commons-geometry-1.0-src/commons-geometry-euclidean/target/commons-geometry-euclidean-1.0.jar
/opt/geo-src/commons-geometry-1.0-src/commons-geometry-io-core/target/commons-geometry-io-core-1.0.jar
/opt/geo-src/commons-geometry-1.0-src/commons-geometry-io-euclidean/target/commons-geometry-io-euclidean-1.0.jar
/opt/geo-src/commons-geometry-1.0-src/commons-geometry-spherical/target/commons-geometry-spherical-1.0.jar
验证点：5 个模块 jar 全部生成，BUILD SUCCESS。注意 -DskipTests 跳过测试执行但测试 jar 仍会打包（输出中出现 *-tests.jar 属正常）。
七、方案对比与选择建议
三种方案各有取舍，本节汇总关键差异并给出选型建议。
| 维度 | 方案 A：Maven 依赖 | 方案 B：二进制包 | 方案 C：源码编译 |
|---|---|---|---|
| 是否需联网 | 构建时需联网 | 仅下载阶段需联网 | 构建时需联网 |
| 安装方式 | 声明依赖自动解析 | 手动解压 + 补 jar | Maven 构建 reactor |
| 依赖完整性 | 自动含全部传递依赖 | 需手动补 commons-numbers-* | 自动构建全部模块 |
| 耗时 | 最短（秒级） | 短 | 最长（实测约 4-5 分钟） |
| 额外要求 | 需 JAVA_HOME 指向 JDK 17 | 需 JDK 17（javac 同理） | 需 JAVA_HOME 指向 JDK 17 |
| 验证结果 | 与 B、C 一致 | 与 A、C 一致 | 与 A、B 一致 |
选择建议：可联网优先方案 A（最简单、依赖自动解析）；内网隔离选方案 B（一次下载即可离线运行）；需要改源码或跟随新版本选方案 C。三方案的 GeometryCheck 实测输出一致，可放心互换。CentOS 8 上三种方案都需注意 JAVA_HOME 指向 JDK 17。
八、配置说明
库本身无独立配置文件，运行期需要关注的“配置”集中在 JDK/Maven 环境与编码，本节逐项说明。
- JDK 版本：Commons Geometry 1.0 要求 Java 8+；实测在 JDK 17.0.1 正常工作。
- Maven
JAVA_HOME（关键）：CentOS 8 常同时存在 JDK 8/17，系统 Maven 默认可能选中 JDK 8。必须export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64，否则编译 Java 17 代码报invalid target release: 17。 - 持久化
JAVA_HOME：写入/etc/profile.d/java17.sh后重新登录即可生效：
echo 'export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64' > /etc/profile.d/java17.sh
source /etc/profile.d/java17.sh
mvn -version | grep "Java version"
输出：
Java version: 17.0.1, vendor: Red Hat, Inc., runtime: /usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
- 源码文件编码：Java 源码含中文注释时，
javac需带-encoding UTF-8（见 5.5），否则报unmappable character ... for encoding US-ASCII。Maven 工程则由project.build.sourceEncoding统一控制。 - 依赖坐标：groupId 固定
org.apache.commons，常用 artifact 为commons-geometry-euclidean（传递引入commons-geometry-core与commons-numbers-*）。
九、常见问题（FAQ）
Q1：mvn compile 报 invalid target release: 17 怎么办？
这是 Maven 使用了 JDK 8 所致。实测（未设置 JAVA_HOME 时直接编译）报错为：
cd /opt/geo-demo
env -u JAVA_HOME mvn -B compile
输出节选（实测首尾）：
[INFO] BUILD FAILURE
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.1:compile (default-compile) on project geometry-demo: Fatal error compiling: invalid target release: 17 -> [Help 1]
解决：构建前设置 JAVA_HOME：
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
mvn -version | grep "Java version"
输出：
Java version: 17.0.1, vendor: Red Hat, Inc., runtime: /usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
Q2：javac 报 unmappable character (0xE6) for encoding US-ASCII 怎么办？
源码含中文且默认平台编码为 US-ASCII 所致，加 -encoding UTF-8：
javac -encoding UTF-8 -cp "/opt/geo-jars/*" -d out2 src/main/java/GeometryCheck.java
输出（无错误即通过）：
（无输出，编译通过）
Q3：运行报 NoClassDefFoundError: org/apache/commons/numbers/core/Precision 怎么办？
缺少 commons-numbers-core 依赖。方案 B 手动 jar 时务必补齐 5.4 节列出的 5 个 jar；方案 A/C 由 Maven 自动解析，无需处理。
Q4：系统同时装了 JDK 8 和 17，如何确认当前用的是哪个？
分别看 java 与 Maven 使用的 JDK：
java -version 2>&1 | head -1
mvn -version | grep "Java version"
输出（设置 JAVA_HOME 后）：
openjdk version "17.0.1" 2021-10-19 LTS
Java version: 17.0.1, vendor: Red Hat, Inc., runtime: /usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
java 由 alternatives 决定（本文实测 alternatives --list 中 java 指向 JDK 17）；Maven 由 JAVA_HOME 决定，两者需分别确认。
Q5：不知道某个类在哪个模块里，怎么快速定位？
用 jar tf 检索 jar 内条目。例如查找 2D 直线相关类：
jar tf /opt/geo-jars/commons-geometry-euclidean-1.0.jar | grep "euclidean/twod/[A-Z].*\.class" | grep -v '\$' | head -12
输出：
org/apache/commons/geometry/euclidean/twod/AffineTransformMatrix2D.class
org/apache/commons/geometry/euclidean/twod/BoundaryList2D.class
org/apache/commons/geometry/euclidean/twod/BoundarySource2D.class
org/apache/commons/geometry/euclidean/twod/BoundarySourceBoundsBuilder2D.class
org/apache/commons/geometry/euclidean/twod/BoundarySourceLinecaster2D.class
org/apache/commons/geometry/euclidean/twod/Bounds2D.class
org/apache/commons/geometry/euclidean/twod/ConvexArea.class
org/apache/commons/geometry/euclidean/twod/EmbeddedTreeLineSubset.class
org/apache/commons/geometry/euclidean/twod/Line.class
org/apache/commons/geometry/euclidean/twod/LineConvexSubset.class
org/apache/commons/geometry/euclidean/twod/LineSpanningSubset.class
org/apache/commons/geometry/euclidean/twod/LineSubset.class
十、卸载与清理
删除源码包、二进制包、手动 jar 与示例工程即可完全清理，库不做系统级安装：
rm -rf /opt/geo-demo /opt/geo-jars /opt/commons-geometry /opt/geo-src
ls -d /opt/geo-demo 2>/dev/null || echo "geo-demo removed"
输出：
geo-demo removed
如需同时移除 JDK 与 Maven：
dnf remove -y java-17-openjdk-devel maven
输出节选（实测首尾，--assumeno 预演）：
Transaction Summary
================================================================================
Remove 24 Packages
Freed space: 251 M
Operation aborted.
⚠️ 注意：正式执行去掉
--assumeno即可，将移除 JDK 17、Maven 及其依赖；本地 Maven 仓库缓存~/.m2需另行清理（rm -rf ~/.m2/repository）。
十一、参考链接
- Apache Commons Geometry 官方站点：https://commons.apache.org/proper/commons-geometry/
- 官方发行下载目录：https://downloads.apache.org/commons/geometry/
- 历史版本归档目录：https://archive.apache.org/dist/commons/geometry/
- Maven 中央仓库坐标页：https://repo1.maven.org/maven2/org/apache/commons/commons-geometry-euclidean/
- Apache Commons Geometry 用户指南（含于二进制包
docs/userguide/）：https://commons.apache.org/proper/commons-geometry/userguide/index.html