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 去哪找类。这是纯命令行环境下最常出错的地方。

Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。

下载

• -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 脚本封装编译运行逻辑——但那是下一步的事了。