Java基础入门：从环境搭建到第一个程序全解析

很多刚开始学Java的朋友都会纠结一个问题：Java基础到底先学什么？是直接背语法，还是先跑通第一个程序？我做了十多年Java开发，也带过不少新人，我的答案始终是——先把开发环境搭好，亲手跑通一个最简单的程序，把编译运行这条链路走通，后面学什么都顺。这篇Java基础第一篇，就带你把环境、第一个程序、核心语法地基一次搞清楚，适合完全零基础、刚准备转行或者自学到一半卡住的人。

1. 先搭台子还是先学语法？——Java基础第一课的思路拆解

1.1 为什么先搞定环境，而不是先啃语法书

我见过太多人一上来就抱着几百页的语法书，从第一章“Java简介”开始看，看到面向对象就崩溃了。原因很简单：语法是抽象的，环境是具体的。如果你连代码在哪写、怎么跑起来都不知道，那些概念就是空中楼阁。

反过来，你先把JDK装好，写一个最简单的HelloWorld，看到屏幕上输出那一行字，你大脑里就会建立一条完整的链路：源文件 -> 编译 -> 字节码 -> JVM执行 -> 结果输出。这条链路一旦建立，后面学的每一个语法点，都能挂在这条链路上，理解起来快得多。

所以“Java基础-1”这门课，核心不是让你记住多少语法，而是让你知道Java程序从诞生到运行的完整过程，并且自己亲手操作一次。这就是我把它放在第一课的原因。

1.2 JDK、JRE、JVM到底谁是谁

很多新手被这三个缩写绕晕，我习惯用一个生活化的类比：JVM是汽车发动机，JRE是装好发动机的整车，JDK是生产整车的工厂。

• JVM（Java Virtual Machine）：Java虚拟机，负责把字节码翻译成当前操作系统能懂的机器指令。Java能跨平台，就是因为它在不同系统上都装了对应的JVM。
• JRE（Java Runtime Environment）：Java运行环境，包含JVM和运行时需要的核心类库。如果你只是跑别人写好的Java程序，装JRE就够了。
• JDK（Java Development Kit）：Java开发工具包，包含JRE，还额外带了javac（编译器）、javadoc（文档工具）、jar（打包工具）这些开发工具。你要写代码，必须装JDK。

记住一句话：写代码装JDK，跑代码有JRE，运行靠JVM。三者是包含关系：JDK > JRE > JVM。

1.3 Java版本怎么选

Java现在已经不是当年只有Java 8的年代了，版本号一路涨，Oracle还改成了每半年发一版的节奏。很多新手一上来就问：我该装Java 8还是Java 17还是Java 21？

我的建议是如果你是零基础入门，直接装最新的稳定LTS版本（长期支持版），比如Java 17或者Java 21。原因有两个：

第一，新版本有更好的性能和更友好的语法特性，比如增强的switch表达式、var关键字，这些会让你的早期代码更简洁。 第二，你现在学的是基础，API和语法核心变化不大，只要避开一些废弃用法，以后企业用老版本也能很快适应。

但如果你所在的公司或学校明确要求Java 8，那你就装Java 8，配合IDE使用差别不会太大。切记不要同时装一堆版本在PATH里混着用，环境变量指向哪个就生效哪个，这会造成很多莫名其妙的坑。

2. 手把手搭好Java开发环境

2.1 JDK安装与下载注意事项

先说下载渠道。最权威的是Oracle官网，但国内访问有时候慢。如果网络不方便，也可以选OpenJDK发行版。这里多说一句，不要随便去第三方网站下“绿色版”、“精简版”，你永远不知道里面的javac被改动过什么，老老实实用官方构建。

下载时注意选对系统版本。Windows下就是.exe或.msi安装包，macOS有.dmg，Linux一般用压缩包.tar.gz。另外注意操作系统是32位还是64位，现在基本都是64位，但老电脑要确认一下。

安装过程本身没什么难度，一路下一步就行。但要注意两点：

一是安装路径不要带空格和中文，比如C:\Program Files\Java\jdk-21其实没问题，但为了后续命令行操作方便，我习惯装到D:\Java\jdk-21这类简单路径，反正别装到像C:\Users\张三\Java这种带中文的路径，环境变量和IDE识别都可能出问题。

二是安装完成后别急着走，确认一下Java安装目录下的关键文件在不在。比如javac.exe和java.exe，一个负责编译，一个负责运行，后面全靠它们。

2.2 环境变量配置详解

这一步是新手翻车重灾区。你要配两个东西：JAVA_HOME和PATH。

JAVA_HOME是给系统和Java相关工具看的，指向JDK的安装根目录。PATH是给操作系统命令识别器用的，让系统在全局任何目录下都能找到java和javac命令。

Windows下的配置步骤我给你写清楚：

右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量。在“系统变量”里点击“新建”，变量名填JAVA_HOME，变量值填你的JDK安装目录，比如D:\Java\jdk-21。

然后在“系统变量”里找到Path，双击编辑，点击“新建”，填%JAVA_HOME%\bin，确定保存。

这里有个容易弄错的地方：如果你直接新建一行只是JAVA_HOME\bin而不带百分号，在Windows环境下会无法解析。百分号是引用变量的语法，表示“动态读取JAVA_HOME变量的值”，这样以后换JDK版本，只要改JAVA_HOME就够了，Path不用动。

macOS用户通常不用手动配，JDK安装后会在/Library/Java/JavaVirtualMachines里注册。Linux用户可以在/etc/profile或~/.bashrc里追加export语句，不展开说了。

2.3 验证环境与IDE安装

配置完环境变量，一定要验证，不要急着写代码。打开命令行终端，按下Win+R输入cmd回车，或者直接在终端里敲：

java -version javac -version

如果看到类似下面这样的输出，说明JDK和PATH都配好了：

java version "17.0.9" 2023-10-17 LTS Java(TM) SE Runtime Environment (build 17.0.9+11-LTS) Java HotSpot(TM) 64-Bit Server VM (build 17.0.9+11-LTS, mixed mode, sharing)

注意javac -version也有输出，不只是java -version。很多人卡在这一步就是javac报“不是内部或外部命令”，说明Path里的bin目录没配对。

至于IDE（集成开发环境），新手阶段我建议用IntelliJ IDEA的社区版，免费且是最主流的Java开发IDE。安装没什么好说的，就是下载安装包一路下一步。重点是装完之后你要创建一个新项目，但初期不要过度依赖IDE的智能提示，尤其是前几课，你最好还是在命令行里手动编译运行几次，理解底层发生了什么，再回到IDE里享受自动化的便利。

3. 第一个Java程序：跑通编译与运行

3.1 HelloWorld怎么写才对

环境搞定后，新建一个文本文件，命名为HelloWorld.java，注意扩展名是.java，然后用任何文本编辑器打开，写入以下代码：

public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, Java!"); } }

这里有几个硬性要求，第一课必须记住：

• 文件名必须和public class后面的类名完全一致，包括大小写。也就是说文件名是HelloWorld.java，类名是HelloWorld，不能写helloworld.java或helloWorld.java。
• 大括号要成对出现。public class HelloWorld后要有一个类体大括号，main方法后也要有一个方法体大括号。如果括号不匹配，编译直接报错。
• public、static、void这三个关键字，现在先照着写，后面章节会专门讲它们的含义。

写好后，打开命令行，切到文件所在目录，执行：

javac HelloWorld.java

这条命令的作用是编译。如果代码没有语法错误，它会在相同目录下生成一个HelloWorld.class文件，这就是字节码文件。你可能会觉得奇怪，为什么生成的文件后缀是.class而不是.exe？这涉及Java跨平台的原理，我们接下来说。

3.2 编译与运行背后的原理

编译完成后，运行命令是：

java HelloWorld

注意这里不要再写.class后缀，也不要写文件名前面的路径，直接写类名。很多人写成java HelloWorld.class，会报找不到或无法加载主类，因为java命令期望的是类名，不是文件路径。

运行后，你会在终端看到输出：

Hello, Java!

到这里，第一个Java程序就成功跑通了。这个过程中发生了什么，我建议你认真理解一下：

1. .java源文件是给人看的，JVM看不懂。
2. javac把源文件编译成.class字节码文件。字节码是一种中间语言，不针对任何具体操作系统。
3. java启动JVM，JVM加载.class文件并逐行执行字节码，把它翻译成当前操作系统能懂的指令，最终输出结果。

这就是Java“一次编写，到处运行”的秘密：你的.class文件到任何装有JVM的系统上都能运行，而C++编译出来的.exe只能运行在特定系统上。

3.3 代码结构里的几个关键点

class HelloWorld表示声明一个类，Java程序的代码必须放在类里。类名推荐使用大驼峰命名法，即每个单词首字母大写，比如HelloWorld、CustomerOrder、PaymentService。这只是约定，不强制，但你要养成好习惯。

public static void main(String[] args)是Java程序的入口方法，也叫主方法。JVM启动后第一个找的就是它。这个签名在Java中是固定的，public是访问修饰符，表示公开，static表示静态，void表示无返回值，main是方法名，String[] args是命令行参数。现在不用深究，但慢慢你会发现，JVM在调用main方法时不需要创建对象，所以要求它是public static的。

System.out.println("Hello, Java!");是输出语句。System.out代表标准输出流，println表示打印一行并换行。如果你不想换行，可以用System.out.print。字符串必须用双引号括起来，单引号在Java里只能包单个字符，这是一个非常容易踩的小坑。

4. 变量与数据类型：Java的基础地基

4.1 变量怎么定义和命名

第一个程序跑通后，就可以开始塞点真东西了。变量是编程语言最基本的存储单元，你可以把它理解为一个带名字的盒子，盒子里面放着一个值。

定义一个变量的语法是：

数据类型 变量名 = 初始值;

比如：

int age = 25; double price = 9.9; String name = "小明";

等号右边是初始值，左边是变量名。你可以只声明不赋值：

int score;

但在使用之前必须赋值，否则编译阶段就会报错“可能尚未初始化变量”。这是Java相比JavaScript这类动态语言严格的地方，它要求变量必须明确类型，也必须明确赋值后才使用，这样做的好处是很多错误在编译期就暴露了。

变量命名的规则要记牢：

• 只能包含字母、数字、下划线和$符号，不能以数字开头。
• 不能使用Java保留的关键字，比如class、public、int、void这些。
• 推荐使用小驼峰命名法，首字母小写，后面每个单词首字母大写，比如userName、orderCount。
• 名字要见名知意，不要起a、b、c这种毫无意义的变量名。

我见过新手写代码喜欢用单字母变量，图省事，结果过几天自己都看不懂了。培养好的命名习惯，从第一个变量开始。

4.2 8种基本数据类型要点

Java有8种基本数据类型，第一课至少要把它们的分类和取值范围记住。范围不要求背得烂熟，但心中要有概念，尤其是整数和浮点。

实际操作中需要注意几点：

long类型赋值时，超过int范围的数字后面必须加L后缀，否则编译报错。比如long big = 3000000000L;，不加L会被当成int处理，直接溢出报错。

float类型赋值时必须加F或f后缀，因为小数默认是double类型。不加后缀就把double塞进float，属于是丢了精度，编译直接报错。

char用单引号包一个字符，String不是基本类型，它是类，用双引号包一串字符，两者完全不同，不要混用。

4.3 类型转换与常见坑

Java有两种类型转换：自动类型转换和强制类型转换。

从小范围类型转换到大范围类型，会自动发生。比如int转long、int转double，系统直接提升，不需要你写任何东西：

int num = 10; long bigNum = num; // 自动转换，不会有问题 double d = num; // 自动转换，结果是10.0

从大范围转换到小范围，必须强制转换。格式是在值前面加括号和小类型名：

long big = 123456L; int small = (int) big; // 强制转换，但可能丢失精度

强制转换如果遇到超过目标类型范围的值，会发生截断，结果会出乎意料。比如：

int a = 300; byte b = (byte) a;

byte最大只能存127，300转换成byte后结果是44。这就是传说中的数据溢出，不会报错，但结果完全错误。所以强制转换前一定要判断范围是否安全。

另外，整数相除会丢弃小数部分，这是新手最常见的坑：

int a = 7; int b = 2; double result = a / b; // 结果是3.0，不是3.5

因为a / b是两个int相除，先把结果算成3，然后给double赋值变成了3.0。如果你想要3.5，至少要把其中一个换成double：

double result = a / (double) b; // 3.5

这些细节第一课不要求你全部背下来，但遇到了要知道原因，后面写算法题会经常碰到。

5. 新手常见问题与排查技巧实录

5.1 环境变量没生效，cmd里java还是不能运行

装完JDK、配完Path后，如果新开的命令窗口还是提示“java不是内部或外部命令”，大概率是Path没配对。先检查你的Path里是否写的是%JAVA_HOME%\bin，如果直接写成了D:\Java\jdk-21\bin也能用，但改用变量更灵活。

还有一种情况是配完后之前的窗口没有刷新。环境变量是在进程启动时读取的，所以旧窗口不生效很正常，重新开一个cmd窗口再试。

如果重新开了窗口还是不行，就检查JAVA_HOME本身是不是配错了，或者你安装的目录和你填写的目录不一致。最简单的验证方式是在文件资源管理器里输入%JAVA_HOME%\bin看能不能跳转到对应目录，能跳转就说明变量本身没问题。

5.2 编译时报“找不到或无法加载主类”

这个问题分两种情况。一种发生在运行阶段java HelloWorld时，一种发生在编译阶段。

先说运行阶段。你敲java HelloWorld时，JVM在当前目录找HelloWorld.class文件，但有时候class文件在别的位置，或者你用了java HelloWorld.class导致格式错误。解决办法是：使用java -cp . HelloWorld指定当前目录为classpath，并直接用类名不带后缀。

提示：如果class文件确实存在，但依然提示找不到主类，检查代码里主类上是否有public class声明，并且类名和文件名是否完全一致。

另一种是编译错误，比如同步给同事共享代码时，对方一直报“找不到符号”，多半是他编译的.java文件里出现了中文编码问题或者用了IDE的错误代码段。建议先全选代码重新复制到干净文件里，用javac重新编译一次。

5.3 编译时中文乱码问题

在Windows下用命令编译含中文的Java文件，经常会出现乱码，因为默认编码是ANSI或GBK。比如你的代码里有System.out.println("你好");，编译时可能报错误：编码GBK的不可映射字符。

解决方法是把源文件保存为UTF-8格式，然后在编译时指定编码：

javac -encoding UTF-8 HelloWorld.java

运行时的字符输出乱码，通常是控制台显示编码问题。在IDEA里经常是Settings -> Editor -> File Encodings里全局和项目都设为UTF-8，同时VM启动参数里加上-Dfile.encoding=UTF-8。这个问题第二个项目再遇到时，你会头大，第一课就记住一个原则：源文件统一UTF-8，编译时加-encoding UTF-8。

5.4 main方法签名写错导致程序无法启动

main方法写错的形式五花八门，最常见的有这么几种：

public void main(String[] args) // 缺少static public static void main(String args) // 参数写错 static void main(String[] args) // 缺少public

这些情况下编译可能不报错，甚至也能编译成功，但运行时都会提示“找不到或无法加载主类”或“方法应该返回void”。因为JVM严格要求main方法的签名是public static void main(String[] args)。参数名倒是无所谓，args可以改成a，但类型必须是String[]。

还有的人会把类名写错，比如文件名是Test.java，类名写成了HelloWorld，编译时报错“类HelloWorld是公共的, 应在名为HelloWorld.java的文件中声明”。记住：public类的名字必须等于文件名。

5.5 关于编码和IDE的两条实用建议

第一课不要指望一次把所有概念都弄懂，但可以把下面两条记下来，后面会一直用：

第一，使用IDE时，不要一上来就点绿色运行按钮，至少在命令行手动编译运行5次以上。这个过程能帮你直观感知编译和运行是两回事，以后遇到“编译通过了但运行报错”的情况，你能迅速定位是JVM加载问题还是逻辑问题。

第二，初学阶段尽量把IDE的自动导入关闭，多用手动引入Java类，你才会意识到要搞清楚一个类的所在包。虽然现在自动导入很方便，但依赖泛滥会让你意识不到自己到底用了哪个类。

我个人的体会是，Java基础的第一课难度不在于语法，而在于环境链路和心态建设。我见过太多人栽在环境变量和第一个编译错误上就放弃了，其实这些坑每一个老手都踩过。你只要静下心来，一行行核对命令和代码，跑通一次，后面学习速度会越来越快。接下来第二篇可以聊聊流程控制、运算符，或者直接深入面向对象，都行，但先把这篇的所有命令自己敲两遍再继续。