配置Java环境后需验证java和javac版本一致、JAVA_HOME指向JDK根目录、手动编译运行Main.java成功,再通过VS Code过渡理解classpath与package机制。

确认 java -version 和 javac -version 能正常输出
环境变量配完不是终点,而是验证起点。很多人卡在看似配置成功、实则 JAVA_HOME 指向了 JRE 而非 JDK,或 PATH 里混入了旧版本路径。
- 打开终端(Windows 用 CMD/PowerShell,macOS/Linux 用 Terminal),执行
java -version—— 应输出类似17.0.2或21.0.1的版本号,且明确带Java(TM) SE Runtime Environment - 再执行
javac -version—— 必须能返回相同主版本号(如javac 21.0.1),否则说明javac不在PATH中,或指向了独立安装的 JRE - 检查
echo $JAVA_HOME(macOS/Linux)或echo %JAVA_HOME%(Windows):值必须是 JDK 安装根目录(如/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home),不能是.../jre子目录
写一个 Main.java 并用 javac + java 手动编译运行
跳过 IDE,先用命令行跑通“写 → 编译 → 运行”闭环。这是检验环境是否真正可用的唯一硬标准,也是理解 Java 工具链的第一步。
- 新建文件
Main.java,内容仅含最简结构:public class Main { public static void main(String[] args) { System.out.println("Hello, Java!"); } } - 确保当前目录是
Main.java所在路径,执行javac Main.java—— 成功则生成Main.class;失败常见原因:文件名与类名不一致、大小写错误、源文件编码非 UTF-8(Windows 记事本易中招) - 执行
java Main(注意:不加.class后缀)—— 输出Hello, Java!即通过;若报错Could not find or load main class Main,大概率是当前目录不对,或CLASSPATH被意外覆盖
选择并配置一个轻量编辑器(别急着装 IntelliJ)
初学阶段用重型 IDE 反而掩盖基础问题。VS Code + Extension Pack for Java 是目前最平衡的选择:有语法高亮、简单补全、点击跳转,又不自动帮你建项目、改配置、藏 javac 命令。
- 安装 VS Code 后,只启用三个核心插件:
Extension Pack for Java、Debugger for Java、Project Manager for Java;禁用所有 Maven/Gradle 自动导入类插件 - 在 VS Code 中打开
Main.java所在文件夹(不是单个文件),它会提示“是否信任此文件夹”——选是,否则 Java 功能不激活 - 右键菜单里会有
Run Java选项,它底层仍调用javac和java,但会自动处理-cp和类路径。可借此过渡,但要清楚它每一步在做什么
下一步不是学语法,而是搞懂 classpath 和 package 怎么一起工作
90% 的“类找不到”“NoClassDefFoundError”都源于对这两者的误解。环境配好后立刻碰这两个概念,比死记 for 循环语法重要得多。
立即学习“Java免费学习笔记(深入)”;
- 把
Main.java移到子目录src/com/example/下,并声明package com.example;;此时必须用javac -d out src/com/example/Main.java编译,再用java -cp out com.example.Main运行 - 观察
-d参数如何控制字节码输出结构,-cp如何让 JVM 在指定目录下按包路径查找类;手动删掉out/com/example/Main.class再运行,看报什么错 —— 错误信息就是你理解类加载机制的入口 - 不要依赖 IDE 的“Add to Build Path”按钮,先手敲三遍
javac -cp和java -cp,直到能脱离图形界面解释清楚“为什么这个路径要加、那个不用加”
javac 编译时默认使用系统 locale 解码源文件。中文 Windows 上用记事本保存的 .java 文件,若未另存为 UTF-8 编码,javac 会按 GBK 解析,导致中文字符串乱码或编译失败 —— 这个细节,连很多教程都不提。










