# Java基础案例教程jupyter讲义

**Repository Path**: tao5cai/java-basics-practical-notebooks

## Basic Information

- **Project Name**: Java基础案例教程jupyter讲义
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-01
- **Last Updated**: 2026-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Java基础案例教程 — NoteBooks讲义V2

> 配套教材：[《Java基础案例教程》（第3版）](https://www.ryjiaoyu.com/book/details/51300)（"十四五"职业教育国家规划教材，黑马程序员编著，人民邮电出版社，ISBN 978-7-115-65384-0）

## 项目简介

一套**零门槛交互式 Java 入门讲义**——将教材 13 章 94 节内容重构为 Jupyter Notebook，每一节都是可独立运行的 `.ipynb` 文件。

**核心特色：**

- **开箱即读** — 无需编译，打开即见图文并茂的知识讲解、代码示例与运行结果
- **细粒度拆分** — 每节一个 Notebook，按需学习，精准定位
- **沉浸式排版** — 封面、章节标题、知识卡片、代码高亮、折叠详情，视觉层次清晰
- **IDE 友好** — 原生支持 VS Code / Trae / Cursor 等 VS Code 内核 IDE 打开与阅读，无需启动 Jupyter 服务
- **工具链更新** — 开发工具从 Eclipse 升级为 **IntelliJ IDEA + TraeCN**

**适合人群：**

| 角色 | 用途 |
|------|------|
| 零基础学习者 | 逐节跟练，边读边跑代码，快速建立 Java 编程思维 |
| 在校学生 | 配合课堂进度，课后复习回顾，实训作业参考 |
| 授课教师 | 直接用作课堂演示讲义，或导入 Jupyter 交互教学 |
| 培训讲师 | 按需挑选章节，快速搭建 Java 基础培训课程 |

## 章节一览

| 章节 | 主题 | 小节 |
|:----:|------|------|
| 1 | Java开发入门 | Java概述 → Java环境搭建 → Java程序的开发 → IDEA → 本章小结 |
| 2 | Java编程基础 | 基本语法 → 变量 → 数据类型转换 → 运算符 → 选择结构语句 → 循环结构语句 → 数组 → 方法 → 项目实践 → 本章小结 |
| 3 | 面向对象（上） | 面向对象概述 → 类与对象 → 封装 → 构造方法 → static关键字 → 项目实践 → 本章小结 |
| 4 | 面向对象（下） | 继承 → 抽象类和接口 → 多态 → 内部类 → 异常 → 项目实践 → 本章小结 |
| 5 | Java API | Object类 → 字符串类 → 包装类 → 日期和时间类 → System类 → Math类与Random类 → Lambda表达式 → 正则表达式 → 本章小结 |
| 6 | 集合与泛型 | 集合概述 → Collection集合 → List集合 → 集合的遍历 → 泛型 → Set集合 → Map集合 → Stream流 → 项目实践 → 本章小结 |
| 7 | IO | File类 → IO流概述 → 字节流 → 字符流 → 缓冲流 → 数据流 → 对象流 → Commons IO → 项目实践 → 本章小结 |
| 8 | 多线程 | 线程与进程 → 线程的创建和启动 → 线程的生命周期及状态转换 → 线程同步 → 线程的控制 → 线程池 → 本章小结 |
| 9 | 网络编程 | 网络编程基础 → 基于UDP的网络编程 → 基于TCP的网络编程 → 项目实践 → 本章小结 |
| 10 | 数据库编程 | JDBC简介 → JDBC编程 → 数据库连接池 → DbUtils → 项目实践 → 本章小结 |
| 11 | Java的反射机制 | 反射机制概述 → Class类 → 反射的常见操作 → 本章小结 |
| 12 | 图形用户界面 | Swing概述 → Swing顶级容器 → Swing常用组件 → 布局管理器 → 事件处理机制 → JavaFX → 本章小结 |
| 13 | 综合项目-黑马书屋 | 项目开发准备 → 用户注册 → 用户登录 → 图书管理 → 用户管理 → 登录管理 → 本章小结 |

## 快速开始

### 方式一：VS Code / Trae / Cursor（推荐）

VS Code 内核 IDE 原生支持 `.ipynb` 文件，**无需安装 Jupyter 服务**，打开即读。

**1. 安装 IDE**

| IDE | 下载地址 | 说明 |
|-----|---------|------|
| [VS Code](https://code.visualstudio.com/) | 免费开源，微软出品 | 通用代码编辑器 |
| [Trae](https://www.trae.ai/) | 字节跳动出品，内置 AI 辅助 | 推荐 Java 学习场景 |
| [Cursor](https://www.cursor.com/) | AI-first 代码编辑器 | AI 辅助编程 |

**2. 安装 Jupyter 扩展**

在 IDE 中安装以下扩展（任选其一即可）：

```
扩展名: ms-toolsai.jupyter        （Jupyter 扩展包，推荐）
扩展名: ms-toolsai.jupyter-keymap （Jupyter 快捷键，可选）
```

安装方式：
- 打开 IDE → 左侧扩展面板（`Ctrl+Shift+X`）→ 搜索 `Jupyter` → 安装
- 或命令行安装：
  ```bash
  # VS Code
  code --install-extension ms-toolsai.jupyter

  # Trae
  trae --install-extension ms-toolsai.jupyter

  # Cursor
  cursor --install-extension ms-toolsai.jupyter
  ```

**3. 安装 JDK 17**

本讲义基于 Java 17 运行，推荐使用 Oracle JDK（甲骨文官方发行版）：

- **Windows**：
  - 方式 A：从 [Oracle JDK 17 下载页](https://www.oracle.com/java/technologies/downloads/#java17) 下载 `.exe` 安装包，安装时勾选 **"Set JAVA_HOME variable"** 和 **"Add to PATH"**
  - 方式 B（WinGet）：`winget install Oracle.JDK.17`
- **macOS**：
  - 方式 A：从 [Oracle JDK 17 下载页](https://www.oracle.com/java/technologies/downloads/#java17) 下载 `.dmg` 安装包
  - 方式 B（Homebrew）：`brew install --cask oracle-jdk@17`
- **Linux**：
  ```bash
  # Debian/Ubuntu — 下载 .deb 包安装
  sudo dpkg -i jdk-17_linux-x64_bin.deb

  # CentOS/RHEL — 下载 .rpm 包安装
  sudo rpm -ivh jdk-17_linux-x64_bin.rpm

  # 或通过 SDKMAN
  sdk install java 17.0.13-oracle
  ```

安装后验证：
```bash
java -version      # 应显示 java version "17.x.x" (Oracle)
javac -version     # 应显示 javac 17.x.x
```

> **注意**：若已安装其他版本的 JDK，请确保 `JAVA_HOME` 指向 JDK 17 目录，且 `java -version` 输出为 17。

**4. 安装 IJava 内核（Jupyter Java 内核）**

IJava 是基于 JShell 的 Jupyter Java 内核，可在 Notebook 中交互运行 Java 代码。

方式 A — 从预编译包安装（推荐）：

```bash
# 1. 下载最新版 v1.3.0
# 访问 https://github.com/SpencerPark/IJava/releases/tag/v1.3.0
# 下载 ijava-1.3.0.zip

# 2. 解压并安装
unzip ijava-1.3.0.zip -d ijava
cd ijava
python install.py --sys-prefix
```

方式 B — 从源码构建安装：

```bash
git clone https://github.com/SpencerPark/IJava.git
cd IJava
# Linux/macOS
./gradlew installKernel
# Windows
gradlew installKernel
```

安装后验证：
```bash
jupyter kernelspec list
# 应包含: java  .../kernels/java
```

> **提示**：IJava 要求 JDK >= 9（依赖 `jdk.jshell` 模块），JDK 17 完全兼容。若启动内核报 `NoClassDefFoundError: jdk/jshell/JShellException`，说明 `java` 命令指向的是 JRE 而非 JDK，请检查 `JAVA_HOME` 配置。

**5. 安装 Python（Jupyter 依赖）**

Notebook 渲染和 IJava 内核安装需要 Python 环境：

- **Windows**：从 [python.org](https://www.python.org/downloads/) 下载安装，勾选 **"Add Python to PATH"**
- **macOS**：
  ```bash
  brew install python
  ```
- **Linux**：
  ```bash
  sudo apt install python3 python3-pip   # Debian/Ubuntu
  sudo yum install python3 python3-pip   # CentOS/RHEL
  ```

安装后验证：
```bash
python --version    # 应显示 Python 3.10+
pip --version       # 应正常输出
```

**6. 克隆并打开**

```bash
git clone https://gitee.com/tao5cai/java-basics-practical-notebooks.git
```

在 IDE 中：`文件 → 打开文件夹 → 选择克隆目录`，点击任意 `.ipynb` 文件即可渲染阅读。

### 方式二：JupyterLab（经典方式）

适合需要交互运行 Java 代码单元格的场景（需安装 IJava 内核）。

**1. 安装 JDK 17 + IJava**

参考上方"安装 JDK 17"和"安装 IJava 内核"步骤。

**2. 安装 Python**

参考上方"安装 Python"步骤。

**3. 安装 JupyterLab**

```bash
pip install jupyterlab
```

**4. 克隆并启动**

```bash
git clone https://gitee.com/tao5cai/java-basics-practical-notebooks.git
cd java-basics-practical-notebooks
jupyter lab
```

浏览器自动打开，新建 Notebook 时选择 **Java** 内核即可交互运行代码。

## 环境要求

| 组件 | 最低版本 | 用途 |
|------|---------|------|
| JDK | 17（推荐 Oracle JDK） | Java 运行时与 IJava 内核 |
| IJava | 1.3.0 | Jupyter Java 内核（方式二交互运行） |
| Python | 3.10+ | Jupyter 运行时与 IJava 安装脚本 |
| JupyterLab | 4.0+ | Notebook 交互环境（方式二） |
| VS Code / Trae / Cursor | 最新稳定版 | Notebook 阅读环境（方式一） |
| Jupyter 扩展 | 最新 | VS Code 内核 IDE 的 Notebook 渲染支持 |

## 教学信息

- **开发工具**：IntelliJ IDEA + TraeCN
- **总学时**：64学时（理论32 + 实践32）

## 许可证

本项目仅供教学使用，请勿用于商业用途。