---
description: 本项目 Java 必须使用 UTF-8 编码与 JDK 8 编译运行
alwaysApply: true
---

# Java 编码与 JDK 版本（常驻）

本仓库是 **Java 8** 工程（class 文件版本 52.0）。

## 强制要求

- 源码与 `javac` 一律使用 **UTF-8**（`-encoding UTF-8`）
- 编译目标必须是 **JDK 8 / Java 1.8**（`-source 1.8 -target 1.8`，class major=52）
- **禁止**用本机默认 JDK 11+ 直接 `javac` 产出 class（会导致 IDEA 报：类文件版本 55.0，应为 52.0）

## 推荐本机 JDK 8

优先使用：

```text
D:\java\jdk-8u202\bin\javac.exe
```

若无此路径，再用 `D:\java\jdk-8\bin\javac.exe`，或用户已配置的 JDK 8。

## 正确编译示例

```powershell
$javac8 = "D:\java\jdk-8u202\bin\javac.exe"
$cp = ((Get-ChildItem lib\*.jar).FullName -join ";") + ";bin"
& $javac8 -encoding UTF-8 -source 1.8 -target 1.8 -cp $cp -d bin <源文件...>
```

## 出错时

若出现 `类文件具有错误的版本 55.0, 应为 52.0`：删除对应 `bin/**/*.class` 后，用上面的 JDK 8 命令重编。