# JavaSE 基础 — Day01 笔记

> **日期**：2026-07-13  
> **项目**：`javaSE-260713-FirstJava`  
> **作者**：WanJL

---

## 一、Java 文件结构

一个 `.java` 源文件由两部分组成：

| 组成部分 | 说明 |
|---------|------|
| **Java 代码** | 真正参与运行的程序指令 |
| **Java 注释** | 写给程序员看的说明文字，**不参与编译和运行** |

---

## 二、Java 注释

Java 提供三种注释方式：

| 注释类型 | 语法 | 用途 |
|---------|------|------|
| **单行注释** | `// 注释内容` | 注释单行说明 |
| **多行注释** | `/* 注释内容 */` | 注释多行说明文字 |
| **文档注释** | `/** 注释内容 */` | 为类、方法生成 API 文档（JDK 自带 `javadoc` 工具） |

### 示例

```java
// 这是单行注释

/*
   这是
   多行注释
*/

/**
 * 这是文档注释
 * @author WanJl
 * @version 1.0
 */
```

---

## 三、核心概念 — 数据

Java 程序的核心是**数据**，数据分为不同**数据类型**。

### 1. 常量 / 字面量

直接写在代码中的具体值称为**字面量（Literal）**。

```java
25          // 整数字面量
"张三"      // 字符串字面量
7           // 整数字面量
```

### 2. 变量

变量是存放数据的**容器**，可以理解为贴了标签的盒子。

#### 定义变量的格式

```java
数据类型 变量名 = 变量值;
```

> 每一条 Java 语句以 **分号 `;`** 结束。

#### 示例

```java
int age = 25;
// int  → 数据类型（整数类型，integer 的缩写）
// age  → 变量名
// 25   → 字面量
```

---

## 四、输出语句

```java
System.out.println(输出的内容);
```

| 关键字 | 含义 |
|--------|------|
| `System` | 系统 |
| `out` | 输出 |
| `print` | 打印 |
| `ln` | 换行（等价于 `\n`） |

> **快捷输入**：在 IntelliJ IDEA 中输入 `sout` + `Tab` 可直接生成。

---

## 五、程序入口 — main 方法

```java
public static void main(String[] args) {
    // 代码写在这里才能执行
}
```

- `main` 方法是 Java 程序的**运行入口**
- 所有可执行的代码必须放在 `main` 方法内部
- **快捷输入**：在 IntelliJ IDEA 中输入 `psvm` + `Tab`

---

## 六、变量命名规则

| 规则 | 说明 |
|------|------|
| ① 允许的字符 | 字母（a~z、A~Z）、数字（0~9）、美元符号 `$`、下划线 `_` |
| ② 大小写敏感 | `age` 和 `Age` 是两个不同的变量 |
| ③ 禁止关键字 | 不能使用 Java 关键字/保留字（如 `public`、`static`、`void`、`class` 等） |
| ④ 驼峰命名法 | **小驼峰**：第一个单词首字母小写，后续单词首字母大写（如 `myName`） |

---

## 七、完整代码示例

### Demo01.java — 概念总览

```java
public class Demo01 {
    // 单行注释

    /*
        多行注释
    */

    /**
     * 文档注释
     */

    // 此处仅为概念说明，无 main 方法，不能独立运行
}
```

### Demo02.java — 变量与输出实战

```java
/**
 * @author WanJl
 * @version 1.0
 * @title Demo02
 * @create 2026/7/13
 */
public class Demo02 {
    public static void main(String[] args) {
        // 1. 定义变量
        int age = 24;

        // 2. 输出变量
        System.out.println(age);
    }
}
```

### Main.java — 默认入口模板

```java
public class Main {
    public static void main(String[] args) {
        System.out.printf("Hello and welcome!");

        for (int i = 1; i <= 5; i++) {
            System.out.println("i = " + i);
        }
    }
}
```

---

## 八、随堂练习要点

1. 使用 `psvm` 快速生成 `main` 方法
2. 使用 `sout` 快速生成 `System.out.println()`
3. 理解 `//` 注释的内容不会被执行
4. 变量的定义必须遵循命名规则
5. 每条 Java 语句以 `;` 结尾

---

## 九、拓展阅读

| 概念 | 说明 |
|------|------|
| 关键字（Keyword） | Java 预留的具有特殊含义的单词（如 `public`、`class`、`static`、`void`、`int`） |
| 保留字（Reserved Word） | 暂未使用但预留的单词（如 `goto`、`const`） |
| 标识符（Identifier） | 程序员自定义的名称（类名、方法名、变量名等） |