• 在 pom.xml 中添加配置：

  
    
      
        org.apache.ma ven.plugins
        ma ven-assembly-plugin
        3.6.0
        
          
            jar-with-dependencies
          
          
            
              com.example.Main 
            
          
        
        
          
            package
            single
          
        
      
    
  

  执行 mvn clean package 后，target 目录下会生成类似 my-app-jar-with-dependencies.jar 的文件。这个 JAR 在任何安装了 JRE 的系统上都能通过 ja va -jar 直接运行，跨平台分发就这么简单。

4. 兼容性测试：覆盖多环境与架构

打包只是第一步，能否在各种环境下稳定运行，还需要通过测试来验证。传统的“在自己机器上跑一遍”完全不可靠，必须系统性地覆盖不同操作系统、JDK 版本和硬件架构。

• 用 Docker 模拟目标环境：创建一个对应平台的容器，把 JAR 放进去运行。例如测试 ARM 架构下的兼容性：

  docker run -v $(pwd)/target:/app -it arm64v8/openjdk:11-jre-slim bash
  cd /app && ja va -jar your-app.jar

  简单直接，效果明显。
• 在 CI 中配置矩阵测试：GitHub Actions、GitLab CI 等工具都支持多环境并行运行。举例来说，配置一个矩阵，覆盖 Ubuntu、macOS、Windows 三种操作系统，加上 JDK 8/11/17 三个版本——每次提交自动触发，兼容性问题一冒头就能被发现。配置大致如下：

  jobs:
    test:
      runs-on: ubuntu-latest
      strategy:
        matrix:
          os: [ubuntu-latest, macos-latest, windows-latest]
          ja va: ['8', '11', '17']
      steps:
        - uses: actions/checkout@v3
        - name: Set up JDK ${{ matrix.ja va }}
          uses: actions/setup-ja va@v3
          with:
            ja va-version: ${{ matrix.ja va }}
            distribution: 'temurin'
        - name: Build and test
          run: mvn clean test

• 几个常见的兼容性雷区：
  • JDK 版本：编译时使用的 JDK 版本必须 ≤ 运行环境的版本。例如用 JDK 11 编译的 class 文件不能在 JDK 8 上运行，反过来则可以。
  • 依赖冲突：使用 mvn dependency:tree 检查依赖树，发现冲突时用 排除多余的版本。
  • 架构差异：如果要在 ARM 设备（树莓派、Apple Silicon 等）上运行，记得使用对应架构的 JDK（例如 aarch64 版 OpenJDK），否则会直接报错。

5. 跨平台GUI开发（可选）

如果项目涉及桌面 GUI 应用，那么还需要选择一个跨平台的 UI 框架。Java 生态中最成熟的两个选择是 Ja vaFX 和 Swing，各有优势。

• Ja vaFX：现代感更强，支持 CSS 美化、音频和视频，适合制作界面更华丽的应用。一个最简单的例子：

  import ja vafx.application.Application;
  import ja vafx.scene.Scene;
  import ja vafx.scene.control.Button;
  import ja vafx.stage.Stage;
  
  public class HelloJa vaFX extends Application {
      @Override
      public void start(Stage primaryStage) {
          Button btn = new Button("Click Me");
          btn.setOnAction(e -> System.out.println("Clicked"));
          Scene scene = new Scene(btn, 200, 100);
          primaryStage.setScene(scene);
          primaryStage.setTitle("Hello Ja vaFX");
          primaryStage.show();
      }
      public static void main(String[] args) { launch(args); }
  }

• Swing：老牌框架，兼容性极强，几乎任何 Java 平台都能运行。虽然外观朴素，但胜在稳定：

  import ja vax.swing.*;
  import ja va.awt.event.ActionEvent;
  import ja va.awt.event.ActionListener;
  
  public class HelloSwing {
      public static void main(String[] args) {
          JFrame frame = new JFrame("Hello Swing");
          JButton btn = new JButton("Click Me");
          btn.addActionListener(e -> JOptionPane.showMessageDialog(frame, "Clicked"));
          frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
          frame.getContentPane().add(btn);
          frame.setSize(300, 200);
          frame.setVisible(true);
      }
  }

选择哪个，取决于项目需求。如果只是简单的工具界面，Swing 就够用；如果要实现接近原生应用的效果，Ja vaFX 更合适。

综合来看，在 Debian 上完成 Java 跨平台开发并不复杂：环境正确安装、代码规范编写、打包分发、多环境测试，再根据是否需要 GUI 补充对应的框架。每一步都落实到位，代码跨系统运行就是顺理成章的事。