👋 Java Hello World: Your First Program Guide
This guide covers how to write, compile, and run your first Java program — "Hello World" — using:
- ✅ Command Line (macOS/Linux/Windows)
- 🌀 Eclipse IDE
- 🧠 IntelliJ IDEA
- 💻 Visual Studio Code
💻 Understanding the Java Hello World Program
Let's break down the classic "Hello World" program in Java:
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
📝 Code Explanation
public class HelloWorld: Defines a class named HelloWorld that can be accessed from anywherepublic static void main(String[] args): The entry point method that Java looks for when running a programpublic: Accessible from anywherestatic: Belongs to the class, not an instancevoid: Returns no valuemain: Special method name that Java recognizes as the starting pointString[] args: Command-line arguments passed to the program
System.out.println("Hello, World!");: Prints the text "Hello, World!" to the consoleSystem: A built-in class that provides access to the systemout: The standard output streamprintln(): A method that prints text and adds a new line
🔧 Running Java Hello World from the Command Line
📝 Step 1: Save Your File
Save the code as HelloWorld.java. Important: The filename must match the class name exactly, including capitalization.
💡 Step 2: Compile the Program
Open Terminal (macOS/Linux) or Command Prompt (Windows) and navigate to the directory containing your file:
javac HelloWorld.java
This command invokes the Java compiler (javac), which converts your human-readable code into bytecode that the Java Virtual Machine (JVM) can understand. If successful, it creates a HelloWorld.class file.
▶️ Step 3: Run the Program
java HelloWorld
This command starts the JVM and executes your program. The output should be:
Hello, World!
⚠️ Common mistakes:
- Do not include
.classor.javawhen running with thejavacommand- Make sure you're in the correct directory
- The class name and filename must match exactly (case-sensitive)
🔍 Troubleshooting Java Command Line Issues
| Error | Possible Cause | Solution |
|---|---|---|
'javac' is not recognized... |
Java not installed or not in PATH | Set up your Java environment |
Class not found: HelloWorld |
Wrong directory or filename | Check file location and name |
Public class HelloWorld must be in file HelloWorld.java |
Filename doesn't match class name | Rename file to match class name |
🌀 Running Java in Eclipse IDE
🔧 Step 1: Create a Java Project
- Open Eclipse
- Go to
File→New→Java Project - Enter project name (e.g.,
HelloWorldProject) - Click Finish
📦 Step 2: Add a Java Class
- Right-click on the
srcfolder in the Project Explorer - Select
New→Class - Enter
HelloWorldas the class name - Check the box "public static void main(String[] args)"
- Click Finish
✍️ Step 3: Enter Code
The editor will open with a template. Replace or modify the generated code so it looks like:
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
▶️ Step 4: Run
- Right-click the file in the Project Explorer →
Run As→Java Application - Alternatively, click the Run button (▶️) in the toolbar
- Output appears in the Console view at the bottom of the screen
🔍 Eclipse Tips
- Auto-format code: Press
Ctrl+Shift+F(Windows/Linux) orCmd+Shift+F(macOS) - Quick fix errors: Hover over red underlines and press
Ctrl+1for suggestions - Content assist: Press
Ctrl+Spacefor code completion suggestions
🧠 Running Java in IntelliJ IDEA
🔧 Step 1: Create New Project
- Open IntelliJ IDEA
- Click
New Project - Choose Java from the left panel
- Select your JDK from the dropdown (or set up a new one)
- Click Next
- Set project name (e.g.,
HelloWorldApp) - Click Finish
📂 Step 2: Add Java Class
- Right-click the
srcfolder in the Project view →New→Java Class - Name it
HelloWorld
✍️ Step 3: Enter Code
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
▶️ Step 4: Run
- Click the green run triangle (▶️) in the gutter next to the
mainmethod - Alternatively, right-click anywhere in the editor →
Run 'HelloWorld.main()' - Output shows in the Run tool window at the bottom
🔍 IntelliJ IDEA Tips
- Auto-format code: Press
Ctrl+Alt+L(Windows/Linux) orCmd+Option+L(macOS) - Quick documentation: Press
Ctrl+Q(Windows/Linux) orF1(macOS) to view documentation - Smart code completion: Press
Ctrl+Shift+Spacefor context-aware suggestions
💻 Running Java in Visual Studio Code
🔧 Step 1: Install Extensions
- Open VS Code
- Go to Extensions view (click the square icon on the sidebar or press
Ctrl+Shift+X) - Search for "Extension Pack for Java" and install it
📂 Step 2: Create a Java Project
- Press
Ctrl+Shift+Pto open the Command Palette - Type "Java: Create Java Project" and select it
- Choose "No build tools" for a simple project
- Select a location for your project
- Enter a project name (e.g.,
HelloWorldVSCode)
✍️ Step 3: Create a Java Class
- In the Explorer view, expand your project folder
- Right-click on the
srcfolder →New File - Name it
HelloWorld.java - Enter the Hello World code:
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
▶️ Step 4: Run
- Click the "Run" link that appears above the
mainmethod - Alternatively, right-click in the editor →
Run Java - Output appears in the "Terminal" panel at the bottom
🔍 VS Code Java Tips
- Code actions: Hover over code and click the light bulb 💡 for quick fixes
- Debugging: Set breakpoints by clicking in the gutter and press F5 to debug
- Java Projects view: Click the Java Projects icon in the sidebar for a structured view
🎓 Summary
| Method | Tools/Commands | Key Advantages |
|---|---|---|
| Terminal | javac HelloWorld.java → java HelloWorld |
No additional software needed |
| Eclipse | Create Project → Add Class → Run as Application | Comprehensive IDE with many plugins |
| IntelliJ | Create Project → Add Java Class → Run | Intelligent features, modern interface |
| VS Code | Install Extensions → Create Project → Run Java | Lightweight, customizable editor |
🔍 Common Errors and Solutions
| Error Message | Cause | Solution |
|---|---|---|
error: class HelloWorld is public, should be declared in a file named HelloWorld.java |
Filename doesn't match class name | Rename file to match class name exactly |
error: cannot find symbol |
Using a variable or method that hasn't been declared | Check variable names and imports |
error: ';' expected |
Missing semicolon at the end of a statement | Add the missing semicolon |
error: reached end of file while parsing |
Missing closing brace } |
Check that all opening braces have matching closing braces |
🎯 Next Steps
After mastering the Hello World program, you're ready to:
- Learn about Java variables and data types
- Explore control flow statements like if-else and loops
- Practice with more complex programs that use methods
Happy coding! 🎉