跨Windows/Linux运行带依赖Java类的通用命令行方案及排障

一、编译阶段解决依赖问题（javac + -cp 示例） #

假设你的项目目录结构如下：

project-root/
├── src/
│   └── my/
│       └── package/
│           ├── APITestRunner.java
│           └── OtherClasses.java
└── lib/
    ├── dep1.jar
    ├── dep2.jar
    └── *.jar  # 所有外部依赖

跨平台编译命令 #

Windows和Linux的classpath分隔符不同（Windows用;，Linux用:），可借助Java通配符特性简化命令，同时适配不同Shell：

Linux/macOS

javac -cp "lib/*:src" src/my/package/APITestRunner.java -d out/classes

• -cp "lib/*:src"：指定依赖库目录（所有jar）和源码目录作为classpath
• -d out/classes：指定编译后的class文件输出目录

Windows（CMD）

javac -cp "lib/*;src" src\my\package\APITestRunner.java -d out\classes

• 注意分隔符为;，路径用反斜杠（Java也支持正斜杠）

Windows（PowerShell）

需给classpath加单引号避免通配符被提前解析：

javac -cp 'lib/*;src' src/my/package/APITestRunner.java -d out/classes

二、运行阶段解决主类找不到问题 #

方案1：直接指定classpath和主类运行（跨平台） #

编译完成后，用java命令明确指定classpath（包含编译后的class文件和依赖库）与主类全限定名：

Linux/macOS

java -cp "out/classes:lib/*" my.package.APITestRunner

Windows（CMD）

java -cp "out/classes;lib/*" my.package.APITestRunner

Windows（PowerShell）

java -cp 'out/classes;lib/*' my.package.APITestRunner

方案2：生成可执行Jar包（推荐，跨平台统一命令） #

手动打包需确保Jar的MANIFEST.MF包含主类信息和依赖路径，更省心的方式是用构建工具自动生成：

手动生成可执行Jar

1. 创建manifest.mf文件：

Main-Class: my.package.APITestRunner
Class-Path: lib/dep1.jar lib/dep2.jar

• Main-Class：指定主类全限定名
• Class-Path：列出所有依赖Jar的相对路径（空格分隔）

2. 执行打包命令：

jar cvfm test.jar manifest.mf -C out/classes .

• -C out/classes .：将编译后的class文件加入Jar

运行时确保test.jar与lib目录在同一层级，直接执行：

java -jar test.jar

用Maven自动构建（跨平台无差异）

在pom.xml中配置maven-shade-plugin生成包含依赖的可执行Jar：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.5.1</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <transformers>
              <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                <mainClass>my.package.APITestRunner</mainClass>
              </transformer>
            </transformers>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

执行mvn package后，直接用java -jar target/xxx.jar运行，Windows/Linux通用。

三、Jenkinsfile适配跨平台 #

用isUnix()条件判断切换分隔符，或直接用Maven构建简化逻辑：

pipeline {
  agent any
  stages {
    stage('Compile') {
      steps {
        script {
          if (isUnix()) {
            sh 'javac -cp "lib/*:src" src/my/package/APITestRunner.java -d out/classes'
          } else {
            bat 'javac -cp "lib/*;src" src\\my\\package\\APITestRunner.java -d out\\classes'
          }
        }
      }
    }
    stage('Run') {
      steps {
        script {
          if (isUnix()) {
            sh 'java -cp "out/classes:lib/*" my.package.APITestRunner'
          } else {
            bat 'java -cp "out/classes;lib/*" my.package.APITestRunner'
          }
        }
      }
    }
  }
}

四、IntelliJ本地运行配置 #

1. 创建Application类型的Run/Debug Configuration
2. Main class填写my.package.APITestRunner
3. Classpath of module确保包含项目编译输出目录和所有外部依赖库
4. 运行时IntelliJ会自动处理跨平台classpath逻辑

内容的提问来源于stack exchange，提问作者Serega Ilushenko