Java Lanterna示例代码在NetBeans IDE可运行，Linux终端运行JAR失败

Hey there, let's break down why your Lanterna-based terminal GUI works smoothly in NetBeans 8.2 but throws errors when running the compiled JAR in a Linux terminal. First, let's recap your code (I'll fill in the truncated part for clarity):

package com.glasses.lanternatest;
import com.googlecode.lanterna.TerminalFacade;
import com.googlecode.lanterna.screen.Screen;
import com.googlecode.lanterna.terminal.Terminal;

public class Main { 
    public static void main(String[] args) throws InterruptedException {
        // Typical Lanterna initialization flow
        Terminal terminal = TerminalFacade.createTerminal();
        Screen screen = new Screen(terminal);
        
        screen.startScreen();
        screen.putString(5, 5, "Hello Lanterna!", Terminal.Color.WHITE, Terminal.Color.BLUE);
        screen.refresh();
        Thread.sleep(3000);
        screen.stopScreen();
    }
}

Common Causes & Fixes #

1. Missing Dependencies in the JAR

NetBeans automatically loads all required libraries (like Lanterna's JARs) when running the app from the IDE, but a standard build might generate a JAR that only contains your code—not the Lanterna dependencies. This leads to ClassNotFoundException when running the JAR standalone.

Fixes:

• Build a "Fat JAR" (with dependencies) in NetBeans:
  1. Right-click your project → Properties → Build → Packaging
  2. Check the box labeled "Copy Dependent Libraries"
  3. Rebuild the project. Your dist folder will now have a lib directory with Lantern jars, and you can run the app with:

     java -jar dist/lanternatest.jar
     

• Run with explicit classpath:
  If you don't want to build a fat JAR, specify the Lanterna JAR path when running:

  java -cp "dist/lanternatest.jar:/path/to/lanterna.jar" com.glasses.lanternatest.Main
  

2. Terminal Environment Compatibility Issues

Lanterna relies on the TERM environment variable to detect terminal features. If your Linux terminal uses an incompatible TERM value (e.g., vt100 instead of xterm-256color), Lanterna might fail to initialize.

Fixes:

• Check your TERM variable:

  echo $TERM
  

  If it's not xterm-256color or similar, set it temporarily before running the JAR:

  export TERM=xterm-256color
  java -jar dist/lanternatest.jar
  

• Force Lanterna to use a specific terminal type in code:
  Modify your terminal initialization to explicitly specify the implementation:

  Terminal terminal = TerminalFacade.createTerminal(System.in, System.out, Terminal.TerminalType.XTERM);
  

3. Permissions or Terminal Access Issues

In some cases, the user running the JAR might lack permissions to access the terminal device, or the JAR file itself doesn't have execute permissions.

Fixes:

• Grant execute permissions to the JAR:

  chmod +x dist/lanternatest.jar
  

• Run the JAR from a proper interactive terminal. Avoid non-interactive shells (like some SSH sessions without terminal support) or lightweight GUI terminals that lack required features.

4. Java Version Mismatch

NetBeans might be using a different Java version than the one in your Linux terminal's PATH. Lanterna has version requirements (most versions need Java 8+), so a mismatch can cause unexpected failures.

Fix:
Check the Java version in both environments:

• In NetBeans: Help → About → Look for the Java version listed
• In terminal:

  java -version
  

If they differ, either adjust NetBeans to use the terminal's Java version, or update the terminal's Java to match NetBeans.

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