运行Swing桌面应用时为何出现HelpSetException-NoClassDefFoundError？

看起来你遇到的核心问题是用java -jar启动时，JVM没有正确加载JavaHelp的依赖jar包——哪怕你配置了系统CLASSPATH也没用，因为java -jar模式会忽略系统CLASSPATH，只读取主jar包的MANIFEST.MF文件里的Class-Path配置。下面是具体的排查和解决步骤：

1. 检查并修复MANIFEST.MF的Class-Path配置 #

这是最常见的原因：NetBeans默认不会自动把编译路径里的依赖jar添加到打包后的MANIFEST中。

• 打开你项目的dist目录，找到主jar包（Newdawn.jar），用压缩工具打开它，查看里面的META-INF/MANIFEST.MF文件
• 看有没有一行类似这样的配置：

  Class-Path: lib/jh.jar lib/jhall.jar lib/jhbasic.jar
  

• 如果没有，回到NetBeans里配置：
  1. 右键你的项目 -> 属性 -> 打包
  2. 在右侧的「Class-Path」输入框中，添加这三个jar的路径（因为你的lib文件夹和主jar在同一目录下，所以路径是lib/jh.jar lib/jhall.jar lib/jhbasic.jar，多个jar用空格分隔）
  3. 重新打包项目（右键项目 -> 清理并构建）

2. 用手动指定classpath的方式临时测试 #

如果不想修改MANIFEST，可以直接在命令行里指定完整的类路径来启动，确认依赖是否能被正确加载：

java -cp "Newdawn.jar;lib/jh.jar;lib/jhall.jar;lib/jhbasic.jar" com.yourpackage.YourMainClass

注意把com.yourpackage.YourMainClass替换成你实际的主类全限定名（可以从MANIFEST.MF的Main-Class行里找到）。

3. 验证依赖jar的路径和完整性 #

• 确保lib文件夹和Newdawn.jar在同一个目录下（你现在的启动目录是C:\Program Files (x86)\NewDawn4，要确认这个目录下既有Newdawn.jar，又有lib文件夹，且lib里确实有三个JavaHelp的jar）
• 可以尝试重新复制一遍JavaHelp的jar到lib目录，避免jar包损坏导致加载失败

4. 放弃依赖系统CLASSPATH #

系统级的CLASSPATH在java -jar启动模式下是不生效的，而且这种全局配置很容易引发版本冲突问题，建议完全依赖MANIFEST或者启动命令的classpath参数来管理依赖。

按照上面的步骤操作后，应该就能解决javax.help.HelpSetException的找不到类问题了。

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