Java 基础、集合、异常与 JUnit 5 速查

aloha_7892026-10-26 21:19

Java 基础、集合、异常与 JUnit 5 速查

本文覆盖日常小型代码变更最常用的 Java 知识：基本类型、条件、循环、方法、类与对象、List、Map、null、异常，以及 JUnit 5 的基础测试写法。

本文沿用许多课程使用的"JUnit 5"称呼；示例使用的是 JUnit Jupiter API。若项目使用更新的 JUnit 版本，先以 pom.xml 或构建配置为准，本文涉及的基础注解与断言写法仍可按当前项目核对。

30 秒速查：遇到问题先看这里

在 CSDN 页面按 Ctrl+F 搜最后一列的词；需要理解完整过程时再读下一节的可运行例子。

现在遇到什么 先记住这一句 页内搜索
多条任务放哪里？ 要保留顺序、逐条遍历用 List<Task>；按唯一 id 快速取用 Map<Integer, Task>。 ## 5. List、## 6. Map
get 后报空指针？ Map#get 找不到 key 时可能得到 null，调用方法前先判断。 ## 7. null
空标题怎么挡住？ 先判断 title == null，再检查 title.trim().isEmpty()。 ## 4. 类与对象
测试相等或抛异常怎么写？ assertEquals(expected, actual)；异常用 assertThrows。 ## 9. JUnit 5
忘了 TDD 顺序？ 先见到测试因预期原因失败，再最小实现，最后整理代码。 ## 10. TDD
测试失败先看什么？ 看失败测试名、期望/实际值、第一处项目代码的位置。 ## 12. 常见故障
怎么运行测试？ 在有 pom.xml 的目录运行 mvn test。 ## 13. Maven

先跟做：一个可以独立运行的 Java 小程序

如果你刚开始学 Java，先不要背后面的速查表。把下面代码保存为 TaskDemo.java，在该文件所在目录运行 javac TaskDemo.java，再运行 java TaskDemo。这个例子只用 JDK，不需要 Maven。

java 复制代码 
import java.util.ArrayList;
import java.util.List;

public class TaskDemo {
    // Task 是我们自己定义的一种对象：每个对象代表一条任务。
    static class Task {
        private final int id;      // final 表示创建后不再改 id。
        private final String title;
        private boolean completed;

        Task(int id, String title) {
            if (title == null || title.trim().isEmpty()) {
                throw new IllegalArgumentException("title must not be blank");
            }
            this.id = id;
            this.title = title.trim();
            this.completed = false;
        }

        void toggle() {
            completed = !completed; // false 变 true，true 变 false。
        }
    }

    public static void main(String[] args) {
        List<Task> tasks = new ArrayList<>(); // 用 List 保存多条任务。
        tasks.add(new Task(1, "学习 Java"));
        tasks.add(new Task(2, "练习测试"));

        for (Task task : tasks) { // 逐条访问 List 中的任务。
            if (task.id == 1) {
                task.toggle();
            }
            System.out.println(task.id + " " + task.title + " " + task.completed);
        }
    }
}

预期输出：

text 复制代码 
1 学习 Java true
2 练习测试 false

这段程序的运行顺序是：main 创建列表 → new Task(...) 调用构造器 → add 放进列表 → for 逐条读取 → id 为 1 的任务切换状态 → 打印结果。Task 是类，相当于"任务的定义"；new Task(...) 创建的是对象，相当于"一条具体任务"。

试着改三个地方：把第二条任务的标题改为三个空格，观察异常；把 task.id == 1 改为 2，预测输出；把 task.toggle() 调用两次，解释为什么结果又变回 false。

后面的代码块用于单独说明某个语法点，不能全部直接拼进同一个 Java 文件。

1. 最小程序与变量

java 复制代码 
public class App {
    public static void main(String[] args) {
        int count = 3;
        double price = 19.9;
        boolean completed = false;
        char level = 'A';
        String title = "Learn Java";

        System.out.println(title + ": " + count);
    }
}

常见基本类型：

类型 示例 说明
int 42 整数
long 42L 较大整数
double 3.14 浮点数
boolean true 布尔值
char 'A' 单个字符

String 不是基本类型，而是对象类型。

基本类型与包装类型

java 复制代码 
int number = 1;          // 不能为 null
Integer optional = null; // 可以为 null

常见对应关系：int/Integer、long/Long、double/Double、boolean/Boolean。

2. 条件与循环

java 复制代码 
if (score >= 80) {
    System.out.println("pass");
} else {
    System.out.println("retry");
}
java 复制代码 
for (int i = 0; i < 3; i++) {
    System.out.println(i);
}

for (Task task : tasks) {
    System.out.println(task.getTitle());
}

while (!queue.isEmpty()) {
    queue.remove();
}

易错点：

  • 字符串内容比较使用 equals，不要使用 ==。
  • && 表示并且，|| 表示或者，! 表示取反。
  • 遍历集合时直接增删元素可能触发 ConcurrentModificationException；按需求使用迭代器、removeIf 或先收集再修改。

3. 方法

java 复制代码 
public static int add(int left, int right) {
    return left + right;
}

方法签名需要关注：访问修饰符、是否 static、返回类型、方法名、参数类型与顺序。

java 复制代码 
public boolean renameTask(int id, String newTitle) {
    // 方法体
    return true;
}

返回类型为 void 表示不返回值。其他返回类型必须在所有可达分支返回兼容值。

4. 类与对象

java 复制代码 
public class Task {
    private final int id;
    private String title;
    private boolean completed;

    public Task(int id, String title) {
        if (title == null || title.trim().isEmpty()) {
            throw new IllegalArgumentException("title must not be blank");
        }
        this.id = id;
        this.title = title.trim();
        this.completed = false;
    }

    public int getId() {
        return id;
    }

    public String getTitle() {
        return title;
    }

    public boolean isCompleted() {
        return completed;
    }

    public void toggle() {
        completed = !completed;
    }

    public void rename(String newTitle) {
        if (newTitle == null || newTitle.trim().isEmpty()) {
            throw new IllegalArgumentException("title must not be blank");
        }
        title = newTitle.trim();
    }
}

关键点：

  • private 隐藏内部状态，通过方法维护约束。
  • final 字段只能赋值一次，适合不可变的 id。
  • this.title 指当前对象字段，title 指参数或局部变量。
  • 把标题校验放进对象方法，可避免对象进入非法状态。

5. List

List 有顺序、允许重复，适合遍历和按位置处理。

java 复制代码 
import java.util.ArrayList;
import java.util.List;

List<Task> tasks = new ArrayList<>();
tasks.add(new Task(1, "Java"));
tasks.add(new Task(2, "HTML"));

Task first = tasks.get(0);
int size = tasks.size();

for (Task task : tasks) {
    System.out.println(task.getTitle());
}

boolean removed = tasks.removeIf(task -> task.getId() == 2);

手写查找，不依赖 Stream：

java 复制代码 
Task findById(List<Task> tasks, int id) {
    for (Task task : tasks) {
        if (task.getId() == id) {
            return task;
        }
    }
    return null;
}

6. Map

Map 保存 key-value，适合按唯一 key 获取数据。

java 复制代码 
import java.util.HashMap;
import java.util.Map;

Map<Integer, Task> tasksById = new HashMap<>();
tasksById.put(1, new Task(1, "Java"));

Task task = tasksById.get(1);
boolean exists = tasksById.containsKey(1);
Task removed = tasksById.remove(1);

for (Task value : tasksById.values()) {
    System.out.println(value.getTitle());
}

重要行为：key 不存在时，get 返回 null。put 相同 key 会覆盖旧 value。

7. null

java 复制代码 
Task task = tasksById.get(id);
if (task == null) {
    return false;
}
task.toggle();
return true;

安全顺序：先判断引用是否为 null，再调用其方法。

字符串边界常用写法：

java 复制代码 
if (title == null || title.trim().isEmpty()) {
    throw new IllegalArgumentException("title must not be blank");
}

这里必须先判断 null。|| 具有短路行为：左侧为真时不会执行右侧，从而避免 title.trim() 引发 NullPointerException。

8. 异常

抛出异常

java 复制代码 
Task getOrThrow(int id) {
    Task task = tasksById.get(id);
    if (task == null) {
        throw new IllegalArgumentException("task not found: " + id);
    }
    return task;
}

捕获异常

java 复制代码 
try {
    Task task = getOrThrow(99);
    System.out.println(task.getTitle());
} catch (IllegalArgumentException exception) {
    System.err.println(exception.getMessage());
}
  • throw：真正抛出一个异常对象。
  • throws：在方法签名上声明异常可能传播给调用方。
  • try/catch：捕获匹配的异常并执行处理逻辑。
  • 不要用空 catch 吞掉失败；至少记录、转换或按契约处理。

9. JUnit 5

java 复制代码 
import org.junit.jupiter.api.Test;

import static org.junit.jupiter.api.Assertions.*;

class TaskTest {
    @Test
    void createsTaskWithTrimmedTitle() {
        Task task = new Task(1, "  Java  ");

        assertEquals("Java", task.getTitle());
        assertFalse(task.isCompleted());
    }

    @Test
    void togglesCompletion() {
        Task task = new Task(1, "Java");

        task.toggle();

        assertTrue(task.isCompleted());
    }

    @Test
    void rejectsBlankTitle() {
        IllegalArgumentException exception = assertThrows(
                IllegalArgumentException.class,
                () -> new Task(1, "   ")
        );

        assertEquals("title must not be blank", exception.getMessage());
    }
}

常用断言：

断言 用途
assertEquals(expected, actual) 值相等
assertTrue(condition) 条件为真
assertFalse(condition) 条件为假
assertNull(value) 值为 null
assertNotNull(value) 值不为 null
assertThrows(Type.class, executable) 抛出指定异常

Given / When / Then

java 复制代码 
@Test
void renamesExistingTask() {
    // Given
    Task task = new Task(1, "Old");

    // When
    task.rename("New");

    // Then
    assertEquals("New", task.getTitle());
}

注释不是必须的，但测试结构应清楚：准备状态、执行行为、验证结果。

10. TDD 最小循环

  1. Red：写一个描述新行为的失败测试，确认它因预期原因失败。
  2. Green：写最少代码让测试通过。
  3. Refactor：在测试保护下去除重复、改善命名与结构。

不要把"测试一开始就通过"误认为 Red。它可能说明测试没有覆盖新行为，或功能早已存在。

11. 正常、边界、失败例

以重命名任务为例：

  • 正常：id 存在，新标题为 "Java"，修改成功。
  • 边界：新标题有前后空格，保存 trim 后的标题。
  • 失败：新标题为 null、""、" "。
  • 失败：id 不存在。
  • 保持性：失败时原任务标题不能被部分修改。

12. 常见故障速查

现象 首先检查
NullPointerException 哪个引用为 null；为什么允许它传播到这里
IndexOutOfBoundsException List 下标是否在 0 到 size - 1
找不到类或包 package、import、目录结构、依赖
测试没有运行 测试目录、类名、@Test 导入、构建工具配置
字符串看起来相同但判断失败 是否错误使用 ==
Map 中数据被替换 是否对同一个 key 再次 put

13. Maven 常用命令

bash 复制代码 
mvn test
mvn -Dtest=TaskTest test
mvn clean test
mvn package

培训现场不要只看最后一行。测试失败时先读：失败的测试名、期望值、实际值、第一处属于自己代码的堆栈位置。

官方参考资料

欢迎使用Markdown编辑器

你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

  1. 全新的界面设计 ，将会带来全新的写作体验；
  2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
  3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
  4. 全新的 KaTeX数学公式 语法；
  5. 增加了支持甘特图的mermaid语法[1](#甘特图的mermaid语法1) 功能；
  6. 增加了 多屏幕编辑 Markdown文章功能；
  7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
  8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z

重做：Ctrl/Command + Y

加粗：Ctrl/Command + B

斜体：Ctrl/Command + I

标题：Ctrl/Command + Shift + H

无序列表：Ctrl/Command + Shift + U

有序列表：Ctrl/Command + Shift + O

检查列表：Ctrl/Command + Shift + C

插入代码：Ctrl/Command + Shift + K

插入链接：Ctrl/Command + Shift + L

插入图片：Ctrl/Command + Shift + G

查找：Ctrl/Command + F

替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。

输入2次#，并按下space后，将生成2级标题。

以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H2O is是液体。

210 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

javascript 复制代码 
// An highlighted block
var foo = 'bar';

生成一个适合你的列表

  • 项目
    • 项目
      • 项目
  1. 项目1
  2. 项目2
  3. 项目3
  • 计划任务
  • 完成任务

创建一个表格

一个简单的表格是这么创建的：

项目 Value
电脑 $1600
手机 $12
导管 $1

设定内容居中、居左、居右

使用:---------:居中

使用:----------居左

使用----------:居右

第一列 第二列 第三列
第一列文本居中 第二列文本居右 第三列文本居左

SmartyPants

SmartyPants 是一个文本转换工具，主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如：

原始符号 转换后 说明
"引号" "引号" 直引号变弯引号
'单引号' '单引号' 直单引号变弯单引号
-- -- 两个连字符变短破折号
--- --- 三个连字符变长破折号
... ... 三个点变省略号

创建一个自定义列表

:
Text-to- conversion tool
: John
: Luke

如何创建一个注脚

一个具有注脚的文本。[2](#2)

注释也是必不可少的

Markdown将文本转换为 。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n−1)!∀n∈N 是通过欧拉积分

Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t   . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=∫0∞tz−1e−tdt.

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

#mermaid-svg-L4vWzfkmA8zFn4Db{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-L4vWzfkmA8zFn4Db .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-L4vWzfkmA8zFn4Db .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-L4vWzfkmA8zFn4Db .error-icon{fill:#552222;}#mermaid-svg-L4vWzfkmA8zFn4Db .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-L4vWzfkmA8zFn4Db .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-L4vWzfkmA8zFn4Db .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-L4vWzfkmA8zFn4Db .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-L4vWzfkmA8zFn4Db .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-L4vWzfkmA8zFn4Db .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-L4vWzfkmA8zFn4Db .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-L4vWzfkmA8zFn4Db .marker{fill:#333333;stroke:#333333;}#mermaid-svg-L4vWzfkmA8zFn4Db .marker.cross{stroke:#333333;}#mermaid-svg-L4vWzfkmA8zFn4Db svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-L4vWzfkmA8zFn4Db p{margin:0;}#mermaid-svg-L4vWzfkmA8zFn4Db .mermaid-main-font{font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-L4vWzfkmA8zFn4Db .exclude-range{fill:#eeeeee;}#mermaid-svg-L4vWzfkmA8zFn4Db .section{stroke:none;opacity:0.2;}#mermaid-svg-L4vWzfkmA8zFn4Db .section0{fill:rgba(102, 102, 255, 0.49);}#mermaid-svg-L4vWzfkmA8zFn4Db .section2{fill:#fff400;}#mermaid-svg-L4vWzfkmA8zFn4Db .section1,#mermaid-svg-L4vWzfkmA8zFn4Db .section3{fill:white;opacity:0.2;}#mermaid-svg-L4vWzfkmA8zFn4Db .sectionTitle0{fill:#333;}#mermaid-svg-L4vWzfkmA8zFn4Db .sectionTitle1{fill:#333;}#mermaid-svg-L4vWzfkmA8zFn4Db .sectionTitle2{fill:#333;}#mermaid-svg-L4vWzfkmA8zFn4Db .sectionTitle3{fill:#333;}#mermaid-svg-L4vWzfkmA8zFn4Db .sectionTitle{text-anchor:start;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-L4vWzfkmA8zFn4Db .grid .tick{stroke:lightgrey;opacity:0.8;shape-rendering:crispEdges;}#mermaid-svg-L4vWzfkmA8zFn4Db .grid .tick text{font-family:"trebuchet ms",verdana,arial,sans-serif;fill:#333;}#mermaid-svg-L4vWzfkmA8zFn4Db .grid path{stroke-width:0;}#mermaid-svg-L4vWzfkmA8zFn4Db .today{fill:none;stroke:red;stroke-width:2px;}#mermaid-svg-L4vWzfkmA8zFn4Db .task{stroke-width:2;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskText{text-anchor:middle;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskTextOutsideRight{fill:black;text-anchor:start;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskTextOutsideLeft{fill:black;text-anchor:end;}#mermaid-svg-L4vWzfkmA8zFn4Db .task.clickable{cursor:pointer;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskText.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskTextOutsideLeft.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskTextOutsideRight.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskText0,#mermaid-svg-L4vWzfkmA8zFn4Db .taskText1,#mermaid-svg-L4vWzfkmA8zFn4Db .taskText2,#mermaid-svg-L4vWzfkmA8zFn4Db .taskText3{fill:white;}#mermaid-svg-L4vWzfkmA8zFn4Db .task0,#mermaid-svg-L4vWzfkmA8zFn4Db .task1,#mermaid-svg-L4vWzfkmA8zFn4Db .task2,#mermaid-svg-L4vWzfkmA8zFn4Db .task3{fill:#8a90dd;stroke:#534fbc;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskTextOutside0,#mermaid-svg-L4vWzfkmA8zFn4Db .taskTextOutside2{fill:black;}#mermaid-svg-L4vWzfkmA8zFn4Db .taskTextOutside1,#mermaid-svg-L4vWzfkmA8zFn4Db .taskTextOutside3{fill:black;}#mermaid-svg-L4vWzfkmA8zFn4Db .active0,#mermaid-svg-L4vWzfkmA8zFn4Db .active1,#mermaid-svg-L4vWzfkmA8zFn4Db .active2,#mermaid-svg-L4vWzfkmA8zFn4Db .active3{fill:#bfc7ff;stroke:#534fbc;}#mermaid-svg-L4vWzfkmA8zFn4Db .activeText0,#mermaid-svg-L4vWzfkmA8zFn4Db .activeText1,#mermaid-svg-L4vWzfkmA8zFn4Db .activeText2,#mermaid-svg-L4vWzfkmA8zFn4Db .activeText3{fill:black!important;}#mermaid-svg-L4vWzfkmA8zFn4Db .done0,#mermaid-svg-L4vWzfkmA8zFn4Db .done1,#mermaid-svg-L4vWzfkmA8zFn4Db .done2,#mermaid-svg-L4vWzfkmA8zFn4Db .done3{stroke:grey;fill:lightgrey;stroke-width:2;}#mermaid-svg-L4vWzfkmA8zFn4Db .doneText0,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText1,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText2,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText3{fill:black!important;}#mermaid-svg-L4vWzfkmA8zFn4Db .doneText0.taskTextOutsideLeft,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText0.taskTextOutsideRight,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText1.taskTextOutsideLeft,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText1.taskTextOutsideRight,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText2.taskTextOutsideLeft,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText2.taskTextOutsideRight,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText3.taskTextOutsideLeft,#mermaid-svg-L4vWzfkmA8zFn4Db .doneText3.taskTextOutsideRight{fill:black!important;}#mermaid-svg-L4vWzfkmA8zFn4Db .crit0,#mermaid-svg-L4vWzfkmA8zFn4Db .crit1,#mermaid-svg-L4vWzfkmA8zFn4Db .crit2,#mermaid-svg-L4vWzfkmA8zFn4Db .crit3{stroke:#ff8888;fill:red;stroke-width:2;}#mermaid-svg-L4vWzfkmA8zFn4Db .activeCrit0,#mermaid-svg-L4vWzfkmA8zFn4Db .activeCrit1,#mermaid-svg-L4vWzfkmA8zFn4Db .activeCrit2,#mermaid-svg-L4vWzfkmA8zFn4Db .activeCrit3{stroke:#ff8888;fill:#bfc7ff;stroke-width:2;}#mermaid-svg-L4vWzfkmA8zFn4Db .doneCrit0,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCrit1,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCrit2,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCrit3{stroke:#ff8888;fill:lightgrey;stroke-width:2;cursor:pointer;shape-rendering:crispEdges;}#mermaid-svg-L4vWzfkmA8zFn4Db .milestone{transform:rotate(45deg) scale(0.8,0.8);}#mermaid-svg-L4vWzfkmA8zFn4Db .milestoneText{font-style:italic;}#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText0,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText1,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText2,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText3{fill:black!important;}#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText0.taskTextOutsideLeft,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText0.taskTextOutsideRight,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText1.taskTextOutsideLeft,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText1.taskTextOutsideRight,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText2.taskTextOutsideLeft,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText2.taskTextOutsideRight,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText3.taskTextOutsideLeft,#mermaid-svg-L4vWzfkmA8zFn4Db .doneCritText3.taskTextOutsideRight{fill:black!important;}#mermaid-svg-L4vWzfkmA8zFn4Db .vert{stroke:navy;}#mermaid-svg-L4vWzfkmA8zFn4Db .vertText{font-size:15px;text-anchor:middle;fill:navy!important;}#mermaid-svg-L4vWzfkmA8zFn4Db .activeCritText0,#mermaid-svg-L4vWzfkmA8zFn4Db .activeCritText1,#mermaid-svg-L4vWzfkmA8zFn4Db .activeCritText2,#mermaid-svg-L4vWzfkmA8zFn4Db .activeCritText3{fill:black!important;}#mermaid-svg-L4vWzfkmA8zFn4Db .titleText{text-anchor:middle;font-size:18px;fill:#333;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-L4vWzfkmA8zFn4Db :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 2014-01-07 2014-01-09 2014-01-11 2014-01-13 2014-01-15 2014-01-17 2014-01-19 2014-01-21 已完成 进行中 计划一 计划二 现有任务 Adding GANTT diagram functionality to mermaid

  • 关于 甘特图 语法，参考 这儿,

UML图表

可以使用UML图表进行渲染，例如下面产生的一个序列图：
王五 李四 张三 王五 李四 张三 #mermaid-svg-rYRziLDAahOBq3lj{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-rYRziLDAahOBq3lj .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-rYRziLDAahOBq3lj .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-rYRziLDAahOBq3lj .error-icon{fill:#552222;}#mermaid-svg-rYRziLDAahOBq3lj .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-rYRziLDAahOBq3lj .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-rYRziLDAahOBq3lj .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-rYRziLDAahOBq3lj .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-rYRziLDAahOBq3lj .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-rYRziLDAahOBq3lj .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-rYRziLDAahOBq3lj .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-rYRziLDAahOBq3lj .marker{fill:#333333;stroke:#333333;}#mermaid-svg-rYRziLDAahOBq3lj .marker.cross{stroke:#333333;}#mermaid-svg-rYRziLDAahOBq3lj svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-rYRziLDAahOBq3lj p{margin:0;}#mermaid-svg-rYRziLDAahOBq3lj .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-rYRziLDAahOBq3lj text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-rYRziLDAahOBq3lj .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-rYRziLDAahOBq3lj .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-rYRziLDAahOBq3lj .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-rYRziLDAahOBq3lj .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-rYRziLDAahOBq3lj #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-rYRziLDAahOBq3lj .sequenceNumber{fill:white;}#mermaid-svg-rYRziLDAahOBq3lj #sequencenumber{fill:#333;}#mermaid-svg-rYRziLDAahOBq3lj #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-rYRziLDAahOBq3lj .messageText{fill:#333;stroke:none;}#mermaid-svg-rYRziLDAahOBq3lj .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-rYRziLDAahOBq3lj .labelText,#mermaid-svg-rYRziLDAahOBq3lj .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-rYRziLDAahOBq3lj .loopText,#mermaid-svg-rYRziLDAahOBq3lj .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-rYRziLDAahOBq3lj .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-rYRziLDAahOBq3lj .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-rYRziLDAahOBq3lj .noteText,#mermaid-svg-rYRziLDAahOBq3lj .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-rYRziLDAahOBq3lj .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-rYRziLDAahOBq3lj .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-rYRziLDAahOBq3lj .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-rYRziLDAahOBq3lj .actorPopupMenu{position:absolute;}#mermaid-svg-rYRziLDAahOBq3lj .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-rYRziLDAahOBq3lj .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-rYRziLDAahOBq3lj .actor-man circle,#mermaid-svg-rYRziLDAahOBq3lj line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-rYRziLDAahOBq3lj :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 李四想了很长时间, 文字太长了 不适合放在一行. 你好！李四, 最近怎么样? 你最近怎么样，王五？ 我很好，谢谢! 我很好，谢谢! 打量着王五... 很好... 王五, 你怎么样?

  • 关于 UML图表 语法，参考 这儿,

流程图

#mermaid-svg-Yj8wuqQ3p5oyOsgv{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .error-icon{fill:#552222;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .marker{fill:#333333;stroke:#333333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .marker.cross{stroke:#333333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-Yj8wuqQ3p5oyOsgv p{margin:0;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .cluster-label text{fill:#333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .cluster-label span{color:#333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .cluster-label span p{background-color:transparent;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .label text,#mermaid-svg-Yj8wuqQ3p5oyOsgv span{fill:#333;color:#333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .node rect,#mermaid-svg-Yj8wuqQ3p5oyOsgv .node circle,#mermaid-svg-Yj8wuqQ3p5oyOsgv .node ellipse,#mermaid-svg-Yj8wuqQ3p5oyOsgv .node polygon,#mermaid-svg-Yj8wuqQ3p5oyOsgv .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .rough-node .label text,#mermaid-svg-Yj8wuqQ3p5oyOsgv .node .label text,#mermaid-svg-Yj8wuqQ3p5oyOsgv .image-shape .label,#mermaid-svg-Yj8wuqQ3p5oyOsgv .icon-shape .label{text-anchor:middle;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .rough-node .label,#mermaid-svg-Yj8wuqQ3p5oyOsgv .node .label,#mermaid-svg-Yj8wuqQ3p5oyOsgv .image-shape .label,#mermaid-svg-Yj8wuqQ3p5oyOsgv .icon-shape .label{text-align:center;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .node.clickable{cursor:pointer;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .arrowheadPath{fill:#333333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-Yj8wuqQ3p5oyOsgv .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Yj8wuqQ3p5oyOsgv .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-Yj8wuqQ3p5oyOsgv .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .cluster text{fill:#333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .cluster span{color:#333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-Yj8wuqQ3p5oyOsgv rect.text{fill:none;stroke-width:0;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .icon-shape,#mermaid-svg-Yj8wuqQ3p5oyOsgv .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .icon-shape p,#mermaid-svg-Yj8wuqQ3p5oyOsgv .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .icon-shape .label rect,#mermaid-svg-Yj8wuqQ3p5oyOsgv .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Yj8wuqQ3p5oyOsgv .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-Yj8wuqQ3p5oyOsgv .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-Yj8wuqQ3p5oyOsgv :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 链接
长方形
圆
圆角长方形
菱形

  • 关于 Mermaid 语法，参考 这儿,

FLowchart流程图

我们依旧会支持flowchart.js的流程图语法：
Created with Raphaël 2.3.0 开始 我的操作 确认？ 结束 yes no

  • 关于 Flowchart流程图 语法，参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，

继续你的创作。

  1. mermaid语法说明 ↩︎

  2. 注脚的解释 ↩︎

*[HTML]: 超文本标记语言

相关推荐
知守观2 小时前
设计模式实战：从真实老项目中看标准模板方法与工厂的落地
java·spring·设计模式
独隅2 小时前
Claude API 实战教程：从入门到完整项目
android·java·数据库·claude·claude code
Wang's Blog2 小时前
Java 项目实战: 交友项目 - 圈子功能实现：总结
java·开发语言·交友
SL_staff2 小时前
JVS私有化文档系统上线避坑指南：5大运维与业务协同断点及检测加固实践
java·开源·全栈
FinelyYang4 小时前
考试系统简答题 AI 阅卷：覆盖度驱动、异步评分与人机协同落地实践
java·大数据·人工智能
hhhjhl4 小时前
Yup 跨端三方库仓颉适配全流程
java·开发语言
用户3126874877204 小时前
Java 对象内存布局：压缩指针、对齐填充与 JOL 实测
java
东华果汁哥4 小时前
【Spring AI 实战】从零开始调用大模型接口，构建 Java AI 应用
java·人工智能·spring
Song_RsHt5 小时前
Redis 与微服务，什么场景下无可替代
java·redis·后端·学习·微服务
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02如何新建文件夹？ 电脑新建文件夹的4种方法03GitHub 镜像站点04历年考研数学一、数学二、数学三真题试卷及答案PDF05几个好用的ip纯净度检测网站06苹果iPA游戏软件资源下载网站07昇腾910B系列芯片完全指南：四款型号对比、服务器选型与大模型部署实战08蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接09ai安全工具:CyberStrikeAI安装部署与使用10Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）