开篇：先看一段"活的"代码

学 Java 的第一课，我们不写HelloWorld。玩具代码看不出 Java 的"骨架"长什么样。直接上一个小型但完整的程序——煤矿井下设备巡检登记，这是真实业务的简化版：

package com.demo.inspection; import java.time.LocalDate; public class InspectionApp { public static void main(String[] args) { // 设备基本信息 String deviceName = "3号皮带输送机"; String location = "井下-580m东翼大巷"; int runtimeHours = 1260; double temperature = 42.5; boolean needRepair = false; // 简单的巡检逻辑 if (temperature > 45.0) { needRepair = true; } // 输出巡检报告 System.out.println("===== 设备巡检报告 ====="); System.out.println("设备名称：" + deviceName); System.out.println("安装位置：" + location); System.out.println("累计运行：" + runtimeHours + " 小时"); System.out.println("当前温度：" + temperature + " ℃"); System.out.println("巡检日期：" + LocalDate.now()); System.out.println("是否需维修：" + (needRepair ? "是" : "否")); } }

把这段代码存成InspectionApp.java，编译运行，控制台就会打印出一份巡检报告。

别小看这二十几行——Java 程序的"骨架要素"全在里面了：package、import、类、main 方法、变量声明、运算符、三元表达式、控制台输出。下面逐层拆开讲。

第一层：package——Java 代码的"户口本"

package com.demo.inspection;

Java 里所有的类都必须有归属，这个归属就是包（package）。它解决一个朴素的问题：全世界的程序员都在写 Java，类名撞车怎么办？答案是按包名隔离。

• 包名习惯上用公司域名倒写开头：com.demo.inspection就是demo.com这家公司的 inspection 模块。这样几乎不可能和别人撞名。

• 包名和磁盘上的目录结构一一对应：这个类必须放在com/demo/inspection/这样的目录下。

• 一个.java文件的开头第一行（注释除外）就是 package 声明，全小写，这是铁打的习惯。

类比前端：package 之于 Java，就像 ES Module 的目录路径之于 TypeScript——给代码一个唯一的命名空间。

第二层：import——用别人写的类，先"打招呼"

import java.time.LocalDate;

LocalDate是 JDK 自带的日期类，但它住在java.time这个包里，不在我们自己的包里。要用它，就得在文件开头 import 一下，相当于 TypeScript 里的import { LocalDate } from "java.time"。

几个要点：

• 只有跨包使用才需要 import。同一个包里的类直接用，不用打招呼。

• java.lang包是特例：String、System、Math这些最基础的类住在这里，自动引入，不用写 import。

• import 只是"声明引用"，不会把代码复制进来，写多了也不用担心体积。

第三层：类——Java 世界里一切的容器

public class InspectionApp { // ... }

这是 Java 和前端最不一样的地方，先立一个规矩：

在 Java 里，不允许存在"游离的"代码。任何变量、任何方法，都必须装在某一个类里面。

TypeScript 里你可以随手在文件顶层写console.log("hello")，Java 不行——报错的。所有代码都是类的"成员"。

关于类的声明，这一行里有三个词：

• public：访问修饰符，表示这个类任何人都能用。现阶段记住：入口类写成 public 就行，修饰符的细节留到第六章专门讲。

• class：声明这是一个类的关键字。

• InspectionApp：类名，约定大驼峰（首字母大写）。还有一个硬规定：一个 .java 文件里如果有一个 public 类，文件名必须和这个类名一模一样——类叫InspectionApp，文件就必须叫InspectionApp.java，差一个字母都编译不过。

第四层：main 方法——程序的入口"咒语"

public static void main(String[] args) {

每个 Java 初学者都背过这串"咒语"。现在把它拆成五个词，一次讲透：

表格

一句话总结：main 方法就是一个"公开的、属于类的、没有返回值的、名叫 main 的、接收字符串数组参数"的方法，五个条件缺一不可，这是 JVM 和你的约定。

方法体的{}里面，就是程序真正执行的代码，从上往下逐行运行。

第五层：变量声明——Java 是"先声明类型再使用"的语言

看 main 方法里的这几行：

String deviceName = "3号皮带输送机"; int runtimeHours = 1260; double temperature = 42.5; boolean needRepair = false;

Java 是静态强类型语言，变量的类型在编译时就定死，声明格式永远是：

类型 变量名 = 初始值;

• 变量名约定小驼峰（首字母小写），如runtimeHours。

• int装整数，double装小数，boolean只有true/false两个值（注意全小写，和 JS 一致，和 C# 的bool写法不同）。

• String装文本，注意首字母大写——它不是基本类型，而是一个类。这个区别很重要，第二章会专门展开。

• 字符串必须用双引号。Java 里单引号是给单个字符（char）用的，'A'合法，'abc'直接编译报错。这点和 JS/TS 单双引号随便用的习惯不同，初期很容易写错。

上面代码里还有几个小语法点，顺带认识一下：

if (temperature > 45.0) { needRepair = true; }

if写法和 C 系语言完全一致，条件必须放括号里，且必须是 boolean——Java 里没有"0 当 false、非 0 当 true"这一说，if (1)直接编译报错，比 C 严谨。

System.out.println("是否需维修：" + (needRepair ? "是" : "否"));

• System.out.println(...)：控制台输出并换行，相当于console.log。还有一个System.out.print(...)不换行。

• +号：字符串拼接，"累计运行：" + runtimeHours会自动把 int 拼成字符串。

• 条件 ? 值1 : 值2：三元表达式，和 JS 里一模一样。

常踩的坑（新手排雷清单）

1. 文件名和 public 类名不一致：类叫InspectionApp，文件却存成inspectionapp.java或别的名字——编译直接报错。这是新手第一天必踩的坑。

2. 字符串用了单引号：'设备'报错。记死：单引号只能包一个字符，文本一律双引号。

3. 语句末尾忘了分号：Java 每条语句必须以;结尾。TypeScript 里分号可有可无，Java 里没有商量。

4. 类名、方法名大小写写错：Java严格区分大小写，Main和main是两个东西。写成public static void Main(...)JVM 会说"找不到入口"。

5. 在类的外面写语句：比如把System.out.println写到类的花括号外面——不允许，所有代码必须待在类里、方法里。

6. import 了却没用到，或忘了 import：忘记 import 编译报错好理解；反过来，import 了没用的类不报错，但正规项目里会被代码检查工具标黄，养成随用随 import 的习惯。

本章小结

这一章我们借一段巡检登记程序，认识了 Java 程序的完整骨架：

• package给类一个唯一的"户口本"；

• import声明要用到的外部类；

• 类是 Java 世界里一切的容器，代码不许游离；

• public static void main(String[] args)是 JVM 认准的程序入口，五个要素缺一不可；

• 变量必须先声明类型再使用，类型在编译期定死，语句以分号结尾。

下一章我们往里走一步：八种基本类型与 String——Java 类型世界的两大阵营，以及新手第二个必踩的坑：为什么用==比较两个内容相同的字符串，结果可能是 false。