1 / 4概念
Syntax
Java 的语法刻意保守:类型、修饰符、语句边界都显式写出来,新能力按版本增量加入,旧代码不需要改写。真正需要记住的不是「有多少语法」,而是哪一版能写哪一行。
1 概念
1.1 一句话定义
Java 源码由可选的包声明与导入、一批类型声明组成;类型内部是字段、方法与初始化块,语句以分号结束、代码块用花括号,表达式与语句的区分由语法位置决定。
1.2 它解决什么问题
- 阅读优先:类型、修饰符、可见性都写在源码里,读代码不依赖推断。
- 稳定骨架:类与方法的声明形式二十年没变,旧代码在新 JDK 上继续编译。
- 工具友好:文法确定,解析器、格式化器、静态分析与 IDE 重构可以共用同一套规则。
- 增量演进:
var、record、sealed、模式匹配都以后加语法落地,不破坏已有源码。 - 错误前置:穷尽
switch、密封层级、受检异常把一部分错误从运行期挪到编译期。
代价是样板仍多、语法糖边界不明显:看起来像声明的写法可能触发自动装箱或额外分配。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 泛型、擦除、型变与空安全 | Type |
| 类、接口、继承与分派的语义 | OOP |
| 异常的传播、抑制与领域建模 | Error |
| 线程、锁与虚拟线程 | Concurrency Models |
| 字节码指令与 class 文件结构 | JVM Runtime |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 关键字 | 语法保留、不能作标识符的词 | true、false、null 是字面量不是关键字 |
| 字面量 | 源码中直接写出的值 | 整数字面量默认 int,加 L 才是 long |
| 文本块 | 三引号包裹的多行字符串 | 起始 """ 后必须换行 |
| 表达式 | 产生值,可出现在赋值右侧 | switch 自 Java 14 起两者皆可 |
| 模式 | 类型 + 绑定变量 + 可选守卫 | 记录模式可嵌套解构 |
| 密封 | 限定子类型集合的声明 | permits 可省略,由同文件子类推断 |
| 记录 | 透明承载数据的类 | 组件列表即规范构造器参数 |
2 机制
2.1 心智模型
词法 → 语法树 → 类型检查 → 去糖 → 字节码。 语法糖全部在 javac 前端消化:record 变成 final 类,增强 for 变成迭代器,文本块变成一个常量,switch 表达式变成跳转表或 invokedynamic。所以语法层面看到的结构,和运行时看到的结构不是一回事。
2.2 机制拆解
- 词法:标识符支持 Unicode 字母;关键字不能作标识符;
var等在特定位置才被当作关键字。 - 声明:
package与import之后是类型声明,修饰符顺序自由但习惯上按可见性、静态性、final 排列。 - 语句:
if、for、while、try、synchronized、assert、局部变量声明与表达式语句。 - 表达式:赋值、方法调用、
new、强制转换、instanceof、三元、lambda、方法引用。 - 去糖:lambda 与方法引用编译为
invokedynamic;字符串拼接自 Java 9 起也走invokedynamic。 - 文本块:编译期做缩进剥离与转义处理,结果是一个
String常量,不引入新类型。 - 记录:生成规范构造器、访问器、
equals、hashCode、toString,类本身是final并继承java.lang.Record。 - 模式匹配:
instanceof模式编译为一次类型检查加局部变量;switch模式在 Java 21 编译为invokedynamic的 type switch。
2.3 完整枚举
Java 语言规范里的 50 个关键字,按用途分组:
| 类别 | 关键字 | 个数 |
|---|---|---|
| 访问控制 | public protected private | 3 |
| 成员修饰 | abstract static final native synchronized transient volatile strictfp | 8 |
| 类型声明 | class interface enum extends implements | 5 |
| 包与导入 | package import | 2 |
| 对象与类型判断 | new this super instanceof | 4 |
| 控制流 | if else switch case default for while do break continue return | 11 |
| 异常处理 | try catch finally throw throws | 5 |
| 基本类型 | boolean byte char short int long float double | 8 |
| 断言 | assert | 1 |
| 无返回值 | void | 1 |
| 保留但未使用 | const goto | 2 |
合计 50 个。true、false、null 是字面量;_ 自 Java 9 起单独保留,不能再作标识符。字面量分四类:整数(0b、0x、0 前缀与 _ 分隔,L 后缀为 long)、浮点(默认 double,f 与 d 后缀)、字符与字符串(含 """ 文本块)、true/false/null 与类字面量 String.class。
上下文关键字不是关键字,只在特定语法位置被重新解释:
| 词 | 出现位置 | 说明 |
|---|---|---|
var | 局部变量声明 | Java 10 起;不能用于字段、参数、返回类型 |
record | 类型声明 | Java 16 起;仍可作变量名 |
sealed permits | 类型声明 | Java 17 起;省略 permits 时从同文件推断 |
yield | switch 表达式块 | Java 14 起;在块内产出值 |
module requires exports opens uses provides to with | 模块声明 | Java 9 起 |
when | switch 守卫 | Java 21 起 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 关键字 | 50 个 | 加 _ 共 51 个保留词;上下文关键字不计入 |
char | 16 位无符号 | 一个 UTF-16 码元,不等于一个 Unicode 码点 |
int / long | 32 / 64 位 | 整数字面量默认 int;溢出静默回绕 |
float / double | 32 / 64 位 IEEE 754 | 0.1 + 0.2 不等于 0.3 |
| 文本块起始版本 | Java 15 | 13、14 为预览;缩进剥离是编译期行为 |
record | Java 16 | 14、15 为预览 |
sealed | Java 17 | 15、16 为预览 |
switch 模式匹配 | Java 21 | 17–20 为预览;此前只能用 instanceof 链 |
3 实践
3.1 最小示例
下面这段代码在 Java 21 上编译运行,覆盖文本块、var、密封层级、记录模式与守卫:
import java.util.List;
public final class SyntaxDemo {
sealed interface Shape permits Circle, Square, Rect {}
record Circle(double r) implements Shape {}
record Square(double side) implements Shape {}
record Rect(double w, double h) implements Shape {}
static String describe(Shape shape) {
return switch (shape) {
case Circle(double r) when r > 10 -> "big circle " + r;
case Circle(double r) -> "circle " + r;
case Square(double s) -> "square " + s;
case Rect(double w, double h) -> "rect " + w + "x" + h;
};
}
public static void main(String[] args) {
var shapes = List.of(new Circle(3), new Circle(12), new Square(2), new Rect(2, 3));
for (Shape shape : shapes) {
System.out.println(describe(shape));
}
String report = """
shapes=%d
first=%s
""".formatted(shapes.size(), describe(shapes.get(0)));
System.out.print(report);
}
}
java SyntaxDemo.java 直接运行。追踪三处:switch 没有 default 仍能编译,因为 Shape 是密封的;case Circle(double r) 同时完成类型判断与解构;文本块的缩进由编译器剥离,输出里不会带那 16 个空格。
把 sealed 换成普通 interface,编译器会立刻要求 default 分支;把 record 换成普通类,记录模式失效。这两个实验能说明:新语法的检查强度依赖旧语法提供的前提。
3.2 常用操作与参数
| 目的 | 写法 | 说明 |
|---|---|---|
| 局部类型推断 | var list = new ArrayList<String>() | 必须有初始化表达式,推断出具体类型 |
| 多行字符串 | """ 包裹,起始后换行 | 用 \ 取消换行,用 \s 保留行尾空格 |
| 表达式分支 | switch (x) { case 1 -> "a"; default -> "b"; } | 箭头形式不穿透,块内用 yield 返回值 |
| 类型判断加绑定 | if (o instanceof Point(int x, int y)) | 记录模式要求组件类型匹配 |
| 密封层级 | sealed interface Shape permits Circle, Square | 子类型必须 final、sealed 或 non-sealed |
| 注解 | @Override、@FunctionalInterface | 注解不是修饰符,可带参数与保留策略 |
3.3 标准流程
- 先确定目标版本:库与框架的最低 JDK 决定可用语法,不要用预览特性写生产代码。
- 编译参数统一
--release,让 API 与字节码版本一致,避免误用高版本方法。 - 打开
-Xlint:all,把 raw type、unchecked、deprecation 都当信号处理。 - 格式化与静态检查进 CI,格式分歧不进入代码评审。
- 迁移按 8 → 11 → 17 → 21 逐级进行,每级跑完整测试再继续。
3.4 与相邻技术的组合
- 注解处理器:
@AutoService、Lombok、MapStruct 在编译期读源码模型生成代码,语法糖与它们互不干扰。 - 格式化与静态分析:google-java-format、Spotless、Error Prone 都基于同一套文法,规则可以随版本升级。
- 序列化框架:Jackson 依赖访问器与规范构造器,
record的组件顺序直接影响 JSON 字段顺序。 - Kotlin 互操作:Java 的
record在 Kotlin 侧表现为普通类,密封层级与when的穷尽检查可对接。
3.5 选型维度
| 维度 | Java 8 | Java 11 | Java 17 | Java 21 |
|---|---|---|---|---|
| 数据载体 | 手写 POJO | 手写 POJO | record | record + 记录模式 |
| 封闭层级 | 无 | 无 | sealed | sealed + 穷尽 switch |
| 局部推断 | 无 | var(10 起) | var | var |
| 多行文本 | 字符串拼接 | 字符串拼接 | 文本块(15 起) | 文本块 |
| 模式匹配 | 无 | 无 | instanceof 模式 | switch 模式 + 守卫 |
| 并发语法 | 线程池 | 线程池 | 线程池 | 虚拟线程 |
3.6 决策规则
- 局部变量能用
var就用,但字段、参数、返回类型必须显式写,公开 API 不靠推断。 - 数据载体优先
record;需要可变状态或继承时退回普通类。 - 有限状态集合用
enum或sealed,不要用字符串常量加注释表达。 switch表达式必须穷尽,宁可编译失败,也不要default兜底吞掉新分支。- 文本块只用于多行常量;拼 SQL 或 JSON 时仍要参数化或走序列化库。
3.7 替代方案对比
| 需求 | 方案 A | 方案 B | 取舍 |
|---|---|---|---|
| 多行字符串 | 文本块 | String.join 加数组 | 文本块可读,但缩进规则要理解 |
| 数据载体 | record | 普通类加手写 equals | record 省样板,牺牲可变性与继承 |
| 类型分派 | 模式匹配 | 访问者模式 | 模式匹配集中,访问者便于扩展操作 |
| 局部推断 | var | 显式类型 | var 简洁,显式类型更利于阅读长表达式 |
3.8 何时不该用
- 不要在公开 API 里用
var或预览语法,调用方编译器可能跟不上。 - 不要用
record承载需要逐步修改的 DTO,组件是 final 的,改一个字段要重建对象。 - 不要用模式匹配处理开放继承层级,加
default之后穷尽检查就失效了。 - 不要用文本块拼接外部输入,SQL 与 JSON 都应走参数化或序列化。
- 不要依赖
_作标识符,Java 9 起它已被保留。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 文本块输出缩进错乱 | 结束定界符与内容的相对缩进决定剥离基准 | 把 """ 与内容左对齐,必要时用 \ 与 \s |
switch 表达式报「不穷尽」 | 层级开放或漏了 null 分支 | 密封层级或补 case null |
var 编译失败 | 无初始化、赋 null 或用于字段 | 改回显式类型 |
| 整数字面量溢出 | 默认 int,超范围未加 L | 明确后缀并检查边界 |
| 字符显示为问号 | 源文件编码与编译编码不一致 | 统一 UTF-8,编译加 -encoding UTF-8 |
| 浮点比较失败 | 二进制无法精确表示十进制小数 | 用 BigDecimal 或误差范围 |
| 密封层级编译失败 | 子类不在同一模块或包 | 调整包结构或改用普通接口 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 用字符串常量表达状态 | 拼写错误到运行期才暴露 | enum 或 sealed |
switch 一律加 default | 新枚举值被静默吞掉 | 穷尽分支 + 编译检查 |
用 var 隐藏复杂泛型 | 读代码要靠 IDE 推断 | 复杂类型显式声明 |
| 文本块拼 SQL | 注入风险与格式陷阱 | 预编译语句 + 参数绑定 |
4.3 可观测信号
- 编译期:
javac -Xlint:all的 warning 数量、--release与运行时版本是否一致、switch穷尽性报错。 - 字节码:
javap -v的major version、常量池中的文本块常量、invokedynamic的 bootstrap 方法。 - 运行期:数字溢出后的异常值、浮点比较失败、文本块输出的空白差异。
4.4 安全 / 性能 / 一致性边界
- 安全边界:文本块不改变字符串语义,拼接外部输入仍是注入面;
assert默认关闭,不能用于参数校验。 - 性能边界:循环内字符串
+会反复分配,编译器只在简单场景优化;switch模式匹配比instanceof链清晰,但同样有类型检查成本。 - 一致性边界:语法版本由 JDK 决定,团队必须统一
--release;.与,、分号与块的花括号风格要靠格式化器固化。