Java跨平台开发需统一构建、依赖和运行时行为，而非操作系统或JDK路径；应使用maven toolchains锁定JDK版本，Paths.get()处理路径，System.lineSeparator()处理换行，System.getProperty("user.home")获取用户目录，ClassLoader.getResourceAsStream()加载资源。
Java 的跨系统开发本身不依赖统一环境——JVM 层已屏蔽大部分差异，真正需要“统一”的是构建、依赖、运行时行为的一致性，而非操作系统或 JDK 安装路径。
用 jdk-toolchains 锁定构建用 JDK 版本
不同开发者本地装的 JDK 可能是 17、21 或非 LTS 版本，javac 编译行为、默认字节码版本、甚至 --enable-preview 支持都可能不一致。Maven 3.8.1+ 提供 toolchains.xml 配置，强制构建使用指定 JDK 路径或版本号。
在项目根目录建 .mvn/toolchains.xml：
<?xml version="1.0" encoding="UTF-8"?>
<toolchains xmlns="http://maven.apache.org/TOOLCHAINS/1.1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/TOOLCHAINS/1.1.0
http://maven.apache.org/xsd/toolchains-1.1.0.xsd">
<toolchain>
<type>jdk</type>
<provides>
<version>17</version>
<vendor>temurin</vendor>
</provides>
<configuration>
<jdkHome>/opt/java/jdk-17.0.1+12</jdkHome>
</configuration>
</toolchain>
</toolchains>
- CI 环境（如 GitHub Actions）可配合
actions/setup-java@v4指定java-version: '17'和distribution: 'temurin'，与 toolchain 匹配 - Windows 开发者不必手动填
C:\Program Files\...\jdk-17，改用<version>17</version>+<vendor>temurin</vendor>，Maven 会自动查找已安装匹配项 - 避免在
pom.xml中硬写<source>17</source>单独控制编译版本——它不保证javac实际来自哪个 JDK
文件路径与行分隔符必须用 Paths.get() 和 System.lineSeparator()
硬写 "src/main/resources/config.json" 或 "\n" 在 Windows 上可能因路径斜杠方向或换行符导致测试失败、资源加载为空、日志错位。
立即学习“Java免费学习笔记（深入）”；
- 路径拼接一律走
Paths.get("src", "main", "resources", "config.json")，它自动适配/（Linux/macOS）或\（Windows） - 生成文本内容时不用
"\n"，改用System.lineSeparator()；写入文件优先用Files.writeString(path, content, StandardCharsets.UTF_8)，它内部已处理换行 -
File.separator已过时，Paths.get()是当前标准
避免依赖系统命令和环境变量的启动逻辑
比如用 Runtime.getRuntime().exec("curl -s ...") 或读取 System.getenv("HOME")，在 Docker 容器、Windows WSL、CI runner 中行为不一致。
- HTTP 请求统一走
HttpClient或OkHttp，别调系统curl/wget - 用户主目录用
System.getProperty("user.home")，它比HOME或USERPROFILE更可靠（JVM 启动时已标准化） - 临时目录统一用
Files.createTempDirectory("myapp")，而非拼接/tmp或%TEMP% - 若必须执行 shell 命令（如调用本地 CLI 工具），先检测
System.getProperty("os.name").toLowerCase()，再选对应二进制名（ffmpeg.exevsffmpeg）
最易被忽略的是 ClassLoader.getResource() 行为：在 IDE（IntelliJ/Eclipse）里路径可能是 file:/.../target/classes/，打包成 .jar 后变成 jar:file:/.../app.jar!/config.json。任何假设路径可直接 new File(...) 的代码，在 jar 包里必然失败——必须用 getResourceAsStream() 或 getResource() 返回的 URL 处理。
