Java开发需先配置JDK环境:JAVA_HOME指向JDK根目录,PATH包含$JAVA_HOME/bin;验证用java -version和javac -version;Hello World需文件名、类名一致,编译javac Hello.java,运行java Hello;依赖用-cp指定jar路径;常见错误包括命令未找到、类名文件名不匹配、NoClassDefFoundError等。

确认系统已安装 JDK 并正确配置 JAVA_HOME
命令行 Java 开发的前提是系统能识别 javac 和 java 命令。很多人卡在这一步,不是没装 JDK,而是环境变量没生效或指向了 JRE。
- 运行
java -version和javac -version,输出版本号且一致才说明可用 -
JAVA_HOME必须指向 JDK 根目录(如/usr/lib/jvm/java-17-openjdk-amd64或C:\Program Files\Java\jdk-17.0.2),不能是jre子目录 - Linux/macOS:在
~/.bashrc或~/.zshrc中添加:export JAVA_HOME=/path/to/your/jdk export PATH=$JAVA_HOME/bin:$PATH
然后执行source ~/.zshrc - Windows:通过「系统属性 → 高级 → 环境变量」设置,注意用英文分号分隔
PATH,且不要有多余空格
编写、编译、运行 Hello World 的最小闭环
不依赖 IDE、不依赖构建工具,只用终端完成一次完整流程。关键在于理解源文件名、类名、包声明三者的关系。
- 新建文件必须叫
Hello.java(类名首字母大写 +.java后缀) - 若含
package声明(如package com.example;),则文件必须放在对应子目录:com/example/Hello.java - 编译命令始终是
javac Hello.java,成功后生成Hello.class - 运行命令是
java Hello(不加.class后缀),如果报NoClassDefFoundError,大概率是当前目录不在CLASSPATH,可显式指定:java -cp . Hello
处理依赖:不用 Maven,只靠 -cp 手动引入 jar
一旦需要第三方库(比如 gson-2.10.1.jar),就必须用 -cp(或 -classpath)告诉 JVM 去哪找类。这是纯命令行环境下最常出错的地方。
-
-cp后的路径是“类路径”,不是源码路径;它包含所有.jar和.class所在的根目录 - 多个路径用冒号(Linux/macOS)或分号(Windows)分隔,例如:
java -cp ".:gson-2.10.1.jar" Main - 如果 jar 在子目录
lib/gson-2.10.1.jar,路径就得写成lib/gson-2.10.1.jar,不能漏掉lib/ - 运行时若提示
ClassNotFoundException,先检查 jar 名字是否拼错、是否在当前目录下、-cp是否遗漏了当前目录(即.)
调试与常见错误定位技巧
没有 IDE 的栈追踪容易看晕,但命令行本身已提供足够线索。重点盯住错误类型和第一行提示。
立即学习“Java免费学习笔记(深入)”;
-
javac: command not found→JAVA_HOME或PATH没配对,或根本没装 JDK(不是 JRE) -
error: class Hello is public, should be declared in a file named Hello.java→ 类名和文件名大小写/拼写不一致(Linux 对大小写敏感) -
Exception in thread "main" java.lang.NoClassDefFoundError: xxx→ 编译时用了-cp,但运行时忘了加,或 jar 路径写错 -
Could not find or load main class Main→ 类名写错、没加-cp .、或Main类里没有public static void main(String[] args)方法签名 - 临时加
-verbose:class可看 JVM 加载了哪些类,用于验证 jar 是否真被读取:java -cp ".:gson.jar" -verbose:class Main 2>&1 | grep gson
-cp 很快就会失控。哪怕只是三个 jar,路径一多就容易漏、容易错位。真正需要长期维护的命令行 Java 项目,建议尽早用 javac -d out/ 分离源码与 class,并写个简单 shell/bat 脚本封装编译运行逻辑——但那是下一步的事了。










