运行生成子类的Java代码时‘找不到主类’错误的解决方法

问题场景 #

尝试运行Java脚本生成子类，目标目录为/home/ankit/Dev/Zealot/com/piscan/Zealot，执行命令后报错。

执行命令：

cd "/home/ankit/Dev/Zealot/com/piscan/tool/" && javac GenerateAst.java && java GenerateAst

错误信息：

Error: Could not find or load main class GenerateAst
Caused by: java.lang.NoClassDefFoundError: GenerateAst (wrong name: com/piscan/tool/GenerateAst)

相关代码（GenerateAst.java）：

package com.piscan.tool;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Arrays;
import java.util.List;


// 生成语法树子类的代码
public class GenerateAst {
    public static void main(String[] args) throws IOException {
        if (args.length != 1) {
            System.out.println("Usage: generate_ast <output directory>");
            System.exit(64);
        }
        String outputDir = args[0];
        defineAst(outputDir, "Expr", Arrays.asList(
                "Binary : Expr left , Token operator, Expr right",
                "Grouping : Expr expression",
                "Literal : Object value",
                "Unary : Token operator, Expr right"));
    }

    // 创建Expr.java文件并写入基础代码
    private static void defineAst(String outputDir, String baseName, List<String> types) throws IOException {
        String path = outputDir + "/" + baseName + ".java";
        PrintWriter writer = new PrintWriter(path, "UTF-8");

        writer.println("package com.piscan.Zealot;");
        writer.println();
        writer.println("import java.util.List;");
        writer.println();
        writer.println("abstract class " + baseName + "{");

        // AST类生成逻辑
        for (String type : types) {
            String className = type.split(":")[0].trim();
            String fields = type.split(":")[1].trim();
            defineType(writer, baseName, className, fields);

        }

        writer.println("}");
        writer.close();
    }

    private static void defineType(PrintWriter writer, String baseName, String className, String fieldList) {
        writer.println("  static class " + className + " extends " + baseName + " {");

        // 构造方法
        writer.println("    " + className + "(" + fieldList + ") {");

        // 将参数赋值给字段
        String[] fields = fieldList.split(", ");
        for (String field : fields) {
            String name = field.split(" ")[1];
            writer.println("      this." + name + " = " + name + ";");
        }

        writer.println("    }");

        // 字段定义
        writer.println();
        for (String field : fields) {
            writer.println("    final " + field + ";");
        }

        writer.println("  }");
    }

}

报错原因 #

代码开头声明了package com.piscan.tool;，说明该类的完整类名是com.piscan.tool.GenerateAst，而非单独的GenerateAst。直接在tool目录下运行java GenerateAst时，JVM会尝试寻找无包名的GenerateAst类，导致匹配失败。

解决方法 #

方法一：规范包结构运行（推荐） #

1. 编译类时指定输出目录，让class文件自动匹配包结构：

cd "/home/ankit/Dev/Zealot/com/piscan/tool/" && javac GenerateAst.java -d "/home/ankit/Dev/Zealot"

-d参数将编译后的class文件输出到包的根目录/home/ankit/Dev/Zealot，会自动创建com/piscan/tool/子目录存放class文件。

2. 回到包根目录，使用全限定类名运行，同时传入目标目录参数：

cd "/home/ankit/Dev/Zealot" && java com.piscan.tool.GenerateAst /home/ankit/Dev/Zealot/com/piscan/Zealot

方法二：不切换目录运行 #

编译后直接指定类路径为包根目录，用全限定类名运行：

cd "/home/ankit/Dev/Zealot/com/piscan/tool/" && javac GenerateAst.java && java -cp "../../.." com.piscan.tool.GenerateAst /home/ankit/Dev/Zealot/com/piscan/Zealot

-cp "../../.."指定类路径为/home/ankit/Dev/Zealot，确保JVM能找到带包名的类文件。

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