Firefly

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
description: 这是我新 Astro 博客的第一篇文章。
5
image: ./cover.jpg
6
tags: [前端, 开发]
7
category: 前端开发
8
draft: false
9
---

属性	描述
`title`	文章标题。
`published`	文章发布日期。
`updated`	文章更新日期。如果未设置，将默认使用发布日期。
`pinned`	是否将此文章置顶在文章列表顶部。
`description`	文章的简短描述。显示在首页上。
`image`	文章封面图片路径。 1. 以 `http://` 或 `https://` 开头：使用网络图片 2. 以 `/` 开头：`public` 目录中的图片 3. 不带任何前缀：相对于 markdown 文件的路径
`tags`	文章标签。
`category`	文章分类。
`lang`	文章语言代码（如 `zh-CN`）。仅当文章语言与站点默认语言不同时设置。
`licenseName`	文章内容的许可证名称。
`licenseUrl`	文章内容的许可证链接。
`author`	文章作者。
`sourceLink`	文章内容的来源链接或参考。
`draft`	如果这篇文章仍是草稿，则不会显示。
`comment`	是否启用此文章的评论功能。默认为 `true`。
`slug`	自定义文章 URL 路径。如果不设置，将使用文件名作为 URL。
`password`	文章密码。设置后文章内容将被 AES-256-GCM 加密，访客需输入密码才能查看。
`passwordHint`	密码提示。显示在密码输入框上方，帮助访客回忆密码，也可以不加。

文章文件的放置位置#

您的文章文件应放置在 src/content/posts/ 目录中。您也可以创建子目录来更好地组织您的文章和资源。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.png
5
    └── index.md

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 是文章 URL 路径的自定义部分。如果不设置 slug，系统将使用文件名作为 URL。

Slug 使用示例#

示例 1：使用文件名作为 URL#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/my-first-blog-post

示例 2：自定义 Slug#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
slug: hello-world
5
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/hello-world

示例 3：其他语言文件名使用Slug#

1
---
2
title: 如何使用 Firefly 博客主题
3
published: 2023-09-09
4
slug: how-to-use-firefly-blog-theme
5
---

文件：src/content/posts/如何使用Firefly博客主题.md

URL：/posts/how-to-use-firefly-blog-theme

Slug 使用建议#

使用英文和连字符：my-awesome-post 而不是 my awesome post
保持简洁：避免过长的 slug
具有描述性：让 URL 能够反映文章内容
避免特殊字符：只使用字母、数字和连字符
保持一致性：在整个博客中使用相似的命名模式

注意事项#

Slug 一旦设置并发布，建议不要随意更改，以免影响 SEO 和已存在的链接
如果多个文章使用相同的 slug，后面的文章会覆盖前面的
Slug 会自动转换为小写

Firefly 博客部署教程

Sun, 24 May 2026 00:00:00 GMT

Firefly 博客部署教程#

根据Firefly 官方文档，涵盖全流程操作，代码可直接复制，小白可按步完成，附关键避坑提示。说明：基于 Windows 系统；命令可直接执行。

第一篇：前置准备｜安装必备环境#

一、前言#

Firefly 是 Astro 静态博客主题，本文是作者的搭建笔记，为以后回溯搭建过程，为后续操作筑牢基础。

二、必备软件清单#

Node.js：核心环境，版本 ≥22
pnpm
Git：用于拉取源码、提交代码
VS Code：推荐编辑器，用于修改配置、写文章

三、分步安装教程#

1. 安装 Node.js#

访问 https://nodejs.org/，下载 LTS 版。
image.png|528
image.png|528

image.png|534

终端执行 node -v、npm -v，输出版本号即成功。

image.png

注意：安装后重启终端，无效则重启电脑。

2. 安装 pnpm#

终端执行：npm install -g pnpm
执行 pnpm -v 输出版本号即成功，权限不足用管理员终端。

image.png

注意：网络超时切换手机热点。

3. 安装 Git#

1.访问 https://git-scm.com/download/win，下载最新版并默认安装。

image.png

一直下一步就行了，全程默认安装。

4. 安装 VS Code（可选）#

1.访问 https://code.visualstudio.com/，下载并安装，勾选“创建桌面快捷方式”和“将 Code 加入 PATH”。

image.png

推荐安装中文插件。

image.png

四、常见环境问题排查#

node 命令无效 → 重新安装并勾选“Add to PATH”，重启终端/电脑。
pnpm 权限不足 → 用管理员终端执行命令。
git 无反应 → 重启电脑，无效则重装。

第二篇：源码托管｜Fork Firefly 官方仓库#

一、前言#

通过Fork官方仓库，获得自己的独立仓库，可自由修改内容、同步官方更新，后续推送代码到该仓库，Cloudflare会自动触发构建部署。

二、前置准备#

已完成第一篇环境安装（Node ≥22、pnpm、Git、VS Code）
已注册并登录 GitHub 账号

三、Fork 操作步骤（1分钟完成）#

打开Firefly官方仓库：https://github.com/CuteLeaf/Firefly
点击页面右上角的「Fork」按钮（绿色/灰色，位置显眼）。
等待3-5秒，页面自动跳转，此时你已拥有「自己的Firefly仓库」（仓库地址：https://github.com/你的GitHub用户名/Firefly）。

关键说明：Fork后的仓库归你所有，修改内容不会影响官方仓库，后续可一键同步官方更新，适合长期维护。

第三篇：本地搭建｜克隆仓库 + 本地预览调试#

一、前言#

将你Fork后的仓库克隆到本地，安装依赖后启动本地服务，用于预览修改效果（仅本地查看，无需打包，推送代码后Cloudflare自动部署）。

二、前置准备#

已完成前两篇操作（环境安装、Fork仓库）
新建空文件夹：路径无中文、无空格、无特殊字符（示例：D:\blog）

三、分步操作教程#

四、克隆你自己的仓库到本地#

进入 你的 Fork 仓库 页面
点击 Code → 复制 HTTPS 地址
执行克隆（把地址换成你自己的）：运行

1
git clone https://github.com/你的用户名/Firefly.git

1
cd Firefly

2. 安装本地依赖（仅用于本地预览）#

安装依赖（用 pnpm）运行

1
pnpm install

3. 启动本地预览服务#

1
pnpm dev

等待10-30秒，终端显示访问地址： http://localhost<4321>
打开浏览器输入该地址，看到Firefly默认首页，即本地搭建成功。

4. 本地简单调试#

修改配置 / 文章 → 保存自动刷新

在项目根目录创建wrangler.toml： Cloudflare Workers部署需要

1
name = "firefly"
2

3
compatibility_date = "YYYY-MM-DD" # 更为今日
4

5

6

7

8
[assets]
9

10
directory = "./dist"
11

12

13

14

15
[vars]
16

17
NODE_VERSION = "22"

展开收起

2.简单修改站点信息。

停止服务：Ctrl + C
重新启动：pnpm dev
本地仅用于预览，无需执行任何打包命令（Cloudflare会自动打包）。

5. 本地开发完成后#

1.先配置本地 Git 身份

打开电脑的终端（Mac/Linux） 或 Git Bash/CMD（Windows），执行 2 条命令：

1
# 1. 设置你的GitHub用户名（就是你GitHub主页的用户名）
2

3
git config --global user.name "你的GitHub用户名"
4

5

6

7

8
# 2. 设置你的GitHub绑定邮箱（就是你注册GitHub用的邮箱）
9

10
git config --global user.email "你的GitHub邮箱"

检测是否成功

1
git config --global user.name
2

3
git config --global user.email
4
能显示出你填的信息，就说明绑定好了。

推送到 GitHub：

1
git add .
2

3
git commit -m "更新内容"
4

5
git push

第四篇：部署配置｜Cloudflare 关联GitHub自动构建#

一、前言#

这是核心部署步骤，关联你的GitHub仓库后，后续只要推送代码到GitHub，Cloudflare会自动执行「安装依赖→打包→上线」，全程无需手动操作。

二、前置准备#

已完成前几篇操作（环境安装、Fork仓库、本地搭建，简单修改，上传到github）
已注册并登录Cloudflare账号（无账号可注册：https://dash.cloudflare.com/）
你的GitHub仓库已包含完整Firefly源码

三、分步配置教程#

1. 新建 Cloudflare Worker 应用#

登录 Cloudflare 控制台 打开浏览器访问官方控制台：https://dash.cloudflare.com/，输入账号密码完成登录。
进入 Workers & Pages 页面 登录后，在左侧菜单栏找到并点击 Workers 和 Pages（英文对应：Workers & Pages），进入应用管理页面。
创建应用程序 在页面右上角，点击 创建应用程序（英文对应：Create application），进入应用创建流程。
关联 GitHub 代码仓库 在创建页面中，选择 连接到 Git（Connect Git），然后选中 GitHub，按照页面提示完成授权，允许 Cloudflare 访问你的 GitHub 账号。
选择目标仓库 授权完成后，系统会列出你的 GitHub 所有仓库，从中选中需要部署到 Cloudflare Worker 的代码仓库（如 Firefly 仓库）。
配置构建设置 ：

Build command: pnpm build
Deploy command: npx wrangler deploy

发起首次部署 配置完成后，点击页面底部的 部署（Deploy），启动首次自动部署流程。
等待自动构建完成 Cloudflare 会自动执行三个操作：拉取 GitHub 仓库代码 → 执行构建命令 → 将项目部署至 Workers 服务器，耐心等待即可。。

2. 验证自动部署是否成功#

当构建状态显示“成功”后，点击 Worker 项目顶部的 临时域名（格式为：xxx.workers.dev）。
打开浏览器访问该临时域名，若页面展示效果与本地预览的博客首页完全一致，说明 Cloudflare Worker 与 GitHub 自动部署配置成功。

第五篇：绑定域名（Spaceship 平台域名适配）#

完成 Cloudflare Worker 自动部署后，默认使用 xxx.workers.dev 临时域名访问，为了提升专业性和记忆性，我们将你在 Spaceship 平台注册的域名，绑定到 Worker 应用，全程适配博客框架，步骤清晰无冗余。

一、绑定前准备（必做）#

确认域名状态：登录 Spaceship 控制台，确认你的域名状态为“正常”，未被锁定、未过期，且已完成实名认证（若有要求），避免因域名异常导致绑定失败。

二、Step 1：在 Cloudflare 中添加自定义域名#

登录 Cloudflare 控制台，进入之前创建的 Worker 项目主页（可通过左侧「Workers 和 Pages」找到对应项目）。
在项目主页左侧导航栏，点击 触发器（英文：Triggers）选项卡，找到「自定义域」模块，点击 添加自定义域。
在弹出的输入框中，填写你在 Spaceship 平台的域名（如 yourdomain.com 或 www.yourdomain.com），点击添加。
添加后，Cloudflare 会自动生成对应的 DNS 解析记录（CNAME 记录），记录下该 CNAME 记录的「目标值」（通常为你的 Worker 临时域名），后续需在 Spaceship 平台配置该解析。

三、Step 2：在 Spaceship 平台配置 DNS 解析（核心步骤）#

这一步是关键，需在你的域名所在平台（Spaceship）修改 DNS 解析，将域名指向 Cloudflare Worker，具体操作如下：

登录 Spaceship 控制台：打开浏览器，访问 https://www.spaceship.com/zh/auth/?returnUrl=%2Flaunchpad%2F，输入你的账号密码完成登录（若已登录可直接进入）。
进入域名管理页面：登录后，点击顶部「Launchpad」（控制台），找到「Domain Manager」（域名管理）模块，在域名列表中找到你要绑定的域名，点击该域名进入详情页。
进入 DNS 解析设置：在域名详情页中，找到「DNS」选项（或「DNS 解析」「解析设置」），点击进入 DNS 解析配置页面，删除当前无关的解析记录（避免冲突）。
添加 CNAME 解析记录：点击「添加记录」（或「新增解析」），按以下参数填写（适配 Cloudflare Worker 绑定）：
1. 记录类型：选择 CNAME（核心类型，用于将域名指向 Worker 临时域名，适配 IP 动态变化场景）；
2. 主机记录：填写 @（代表主域名，如 yourdomain.com）或 www（代表带 www 前缀的域名，如 www.yourdomain.com，建议两者都添加）；
3. 记录值：粘贴 Step 1 中 Cloudflare 生成的 CNAME 目标值（即 Worker 临时域名，如xxx.workers.dev），确保填写无误；
4. TTL（缓存时间）：设置为 10~60 分钟（数值越小，解析生效越快，新手可直接默认）；
点击「保存」，完成 DNS 解析配置，此时 Spaceship 平台的域名解析已指向 Cloudflare Worker。

四、Step 4：验证域名绑定是否成功#

DNS 解析生效时间通常为 10 分钟~24 小时（新域名生效较快，老域名可能需等待更久），可通过以下两种方式验证绑定结果：

浏览器直接访问：打开浏览器，输入你绑定的域名（如 yourdomain.com），若能正常显示博客首页，且地址栏有 HTTPS 小锁标志，说明绑定成功；若提示“无法访问”，请耐心等待解析生效，或检查解析记录填写是否正确。
在线工具查询：使用 DNS 解析查询工具（如 DNSChecker.org），输入你的域名，查询 CNAME 记录，若查询结果与你配置的 Worker 临时域名一致，说明解析已生效，绑定成功。

###五、域名绑定常见问题排查

解析配置后无法访问：检查 Spaceship 平台的 CNAME 记录值是否与 Cloudflare 生成的目标值一致，TTL 设置是否过小，若无误，耐心等待解析生效（最长 24 小时）；同时确认 Cloudflare 中自定义域已添加成功。
浏览器提示“不安全”：检查 Cloudflare 的 SSL/TLS 加密模式是否设置正确，证书是否已生效，若未生效，等待几分钟后刷新页面重试。
提示“域名已被占用”：确认该域名未被其他 Cloudflare 项目绑定，若已绑定，先删除原有绑定，再重新添加。
DNS 解析修改无效：检查 Spaceship 平台的域名 DNS 服务器是否为默认服务器，若已修改为第三方 DNS，需先改回默认或同步解析记录至对应 DNS 服务器。

butterfly安装rss插件

Sun, 17 May 2026 00:00:00 GMT

一、引言#

由于我用的是butterfly主题，而在我写文章之前，主题文档内并没有和RSS订阅有关的教程，不过我在寻找各大搜索引擎时发现了这么一个插件，用的人也挺多。我也是打算写一篇文章记录一下我在hexo第一次折腾的事迹哈哈

二、安装rss插件并在主题中设置#

在butterfly的插件推荐中有说明了hexo的rss插件，叫hexo-generator-feed

首先添加插件，这里使用的是npm添加 npm install hexo-generator-feed —save 然后在根目录中的_config.yml中添加如下配置

1
feed:
2
  enable: true
3
  type: atom
4
  path: atom.xml
5
  limit: 20

官网还说明了一些其他的参数，如：

enable: 默认开启可以省略 type: RSS的类型(atom/rss2) path: 文件路径，默认是 atom.xml/rss2.xml limit: 展示文章的数量,使用 0 或则 false 代表展示全部 hub: 如果使用不到可以为空 content: （可选）设置 true 可以在 RSS 文件中包含文章全部内容，默认：false content_limit: （可选）摘要中使用的帖子内容的默认长度。仅在内容设置为false且未显示自定义帖子描述时才使用。 content_limit_delim :（可选）如果content_limit用于缩短帖子内容，则仅在达到字符限制之前在此分隔符的最后一次出现处剪切。默认不使用。 icon: (可选）自定义图标。默认为主配置中指定的电子邮件头像。 autodiscovery: 添加提要自动发现，默认开启 template : 自定义模板路径。该文件用于生成 xml 文件然后去主题的_config.yml中添加配置

1
rss: /atom.xml

这样你在用hexo g生成静态网页的时候会在public文件夹中（也就是你静态网页文件夹中）生成一个atom.xml文件

（可选）如果你想让别人知道你的RSS链接，可以在主题中的social settings中添加如下配置（就是在那侧边栏个人资料下面添加一个图标并链接到你的RSS文件）

1
fas fa-rss: /atom.xml

因为butterfly主题中有自带的fas图标，所以直接可以使用

Cloudflare Pages 部署免费图床

Sun, 17 May 2026 00:00:00 GMT

Cloudflare Pages 部署#

Cloudflare Pages 是推荐的部署方式，提供免费托管、全球 CDN 加速和无需服务器维护的优势。

📂 第一步：Fork 项目#

访问 CloudFlare ImgBed 项目
点击右上角的 “Fork” 按钮
选择您的 GitHub 账户
确认 Fork 完成

🏗️ 第二步：创建 Pages 项目#

2.1 访问 Cloudflare Dashboard#

登录 Cloudflare Dashboard
选择左侧菜单的 “计算和AI” -> “Workers & Pages”
点击 “创建应用程序”
在最下方 Looking to deploy Pages? 选择 “Get started”
在 “导入现有 Git 存储库” 处点击 “开始使用”

创建 Pages 项目

2.2 连接 GitHub 仓库#

如果首次使用，需要授权 Cloudflare 访问 GitHub
选择您 Fork 的 CloudFlare-ImgBed 仓库
点击 “开始设置”

2.3 配置项目设置#

配置项	值	说明
项目名称	`cloudflare-imgbed`（或自定义）	项目标识符
生产分支	`main`	生产环境分支
构建命令	`npm install`	重要：v2.0 新构建命令
构建输出目录	`/frontend-dist`	前端构建产物目录

配置项目设置

重要提醒

v2.0 版本的构建命令已变更为 npm install，请确保使用正确的构建命令。

2.4 部署项目#

点击 “保存并部署”
等待首次部署完成（约 2-3 分钟）

🗄️ 第三步：配置数据库#

数据库用于存储文件元数据，是必需的组件，可选数据库为 KV 数据库和 D1 数据库。两者对比如下表所示，根据自己使用场景从其中选择一种配置即可。

特点	KV 数据库	D1 数据库
读写性能	高	较低
免费额度	少	多

重要提示

KV 数据库和 D1 数据库只需要配置其中一个即可，不需要同时配置两个！建议根据上表选择适合自己的数据库类型。

3.1 KV 数据库配置#

创建 KV 命名空间#

在 Cloudflare Dashboard 中选择 “存储和数据库”
点击 “Workers KV”
点击 “创建实例”
输入命名空间名称：img_url（建议使用此名称）
点击 “创建”

创建 KV 命名空间

绑定 KV 到项目#

返回您的 Pages 项目
选择 “设置” → “绑定”
点击 “添加” → “KV 命名空间”
填写绑定信息：
- 变量名称：img_url（必须是这个名称）
- KV 命名空间：选择刚创建的命名空间
点击 “保存”

注意

绑定 KV 时，变量名称必须为 img_url，这是项目预设的变量名，填错会出现无法进入管理界面等情况。

3.2 D1 数据库配置#

创建 D1 数据库#

在 Cloudflare Dashboard 中选择 “存储和数据库”
点击 “D1 SQL 数据库”
点击 “创建数据库”
输入数据库名称：img_d1（建议使用此名称）
点击 “创建”

初始化 D1 数据库#

创建完成后，点击进入数据库详情页
选择 “控制台” 选项卡
在 SQL 输入框中粘贴并执行注释区域以下的内容（见项目仓库）
点击 “执行”

绑定 D1 到项目#

返回您的 Pages 项目
选择 “设置” → “绑定”
点击 “添加” → “D1 数据库”
填写绑定信息：
- 变量名称：img_d1（必须是这个名称）
- D1 数据库：选择刚创建的数据库
点击 “保存”

🔄 第四步：重新部署#

绑定数据库后需要重新部署以生效：

进入项目的 “部署” 页面
找到最新的部署记录
点击右侧的 ”…” 菜单
选择 “重试部署”
等待部署完成

重新部署

🚀 下一步#

至此已经完成项目在 Cloudflare Pages 的部署，但是尚未添加存储渠道，添加存储渠道和进行其他设置的方式请参考

配置 R2 渠道#

服务器部署时默认添加了 Cloudflare R2 存储方式，以下步骤仅针对 Cloudflare 部署方式：

在项目设置中绑定 R2 存储桶：
- 选择 “设置” → “绑定”
- 添加 “R2 存储桶”
- 变量名称：img_r2
- R2 存储桶：选择已创建的存储桶

配置 R2 渠道

在管理后台配置：
- 进入 “系统设置” → “上传设置”
- 配置 R2 渠道参数
- 如需图像审查，填入 R2 公开访问链接

提示

请注意Cloudflare R2 的免费额度限制，超过后可能会产生费用。

注意

增加discuss评论

Sun, 17 May 2026 00:00:00 GMT

VitePress 集成 Giscus 评论插件#

前言#

笔者维护的 VitePress 博客主题已经集成了非常多的功能，为便于在主题之外复用，因此有计划将其一部分功能分离出来，形成独立的插件。

分离的 Giscus 评论插件，效果如下：

不仅集成了 Giscus 评论系统，还包含了一个悬浮的评论跳转按钮（带移动端适配）。

接下来先简单介绍一下用法，再快速讲解核心原理。

插件开发基于之前创建的一个通用模板，vitepress-plugin-slot-inject-template，在模板的基础上，插件95%的代码由 Gemini 3.0 生成。

关于 Giscus#

Giscus 是一个基于 GitHub Discussions 的评论系统。它开源、免费、无广告、无跟踪，并且支持多种语言。

配置参数获取方式：

访问 Giscus 官网。
按照页面提示配置你的仓库信息（确保仓库是公开的，并且安装了 Giscus App，且开启了 Discussions 功能）。
在页面底部的“启用 giscus”部分，你会看到生成的一段 <script> 代码。
将代码中的 data-repo、data-repo-id、data-category、data-category-id 等属性值对应填入插件配置即可。

如何使用#

只需要 2 步：

安装插件

1
pnpm add vitepress-plugin-giscus @giscus/vue

配置插件

在 .vitepress/config.ts 中引入插件：

1
import { defineConfig } from 'vitepress'
2
import { giscusPlugin } from 'vitepress-plugin-giscus'
3

4
export default defineConfig({
5
  vite: {
6
    plugins: [
7
      giscusPlugin({
8
        repo: 'your-github-username/your-repo-name',
9
        repoId: 'your-repo-id',
10
        category: 'Announcements',
11
        categoryId: 'your-category-id',
12
        mapping: 'pathname',
13
        // ...其他 giscus 配置
14
      })
15
    ]
16
  }
17
})

展开收起

pushoo.js 让twikoo推送消息到指定app

Sun, 17 May 2026 00:00:00 GMT

pushoo.js 让twikoo推送消息到指定app#

背景#

消息推送平台多用于在特定的场合提醒使用者，例如：博客收到评论、服务器告警、油价上涨、每日签到结果推送、家中饲养的鸽子外出、飞回，等等……自从方糖气球推出 Server 酱以来，消息推送平台逐渐多样化，他们遵循的 API 格式却很混乱。

有的是 URL 地址传参，有的是 form 表单传参，有的是 JSON 传参，暂时还没看到 XML 传参的；
有的正文支持 Markdown，有的正文支持 HTML，有的正文支持纯文本；
有的支持标题，有的不支持标题。

Twikoo 评论系统对不同的消息推送平台做了大量的适配工作，云函数越来越大。

为了降低云函数复杂度，遂诞生了本项目，本项目旨在整合各大消息推送平台服务，获得统一的调用体验。

同时本项目由Tianli0提供公益QQ机器人推送服务，请勿用于非法用途！（机器人QQ将不定期更换，请关注文档）

支持的消息推送平台#

计划支持的推送平台#

阿里云短信
腾讯云短信

使用方法#

注：如果您是在 Twikoo 评论系统中使用，则无需搭建，直接在 Twikoo 管理面板中配置平台名称和 token 即可。

如果您是在 GitHub Actions 中使用，可以使用 funnyzak/pushoo-action，该作者还提供了基于 pushoo 的命令行工具：funnyzak/pushoo-cli。

安装

1
npm install pushoo

现在，不论您使用什么推送平台，都无需关心他们的调用方式，只需要学习 pushoo 的调用方式即可开始发送您的第一条推送！

1
const pushoo = require('pushoo').default;
2

3
const result = await pushoo('平台名称', {
4
  token: '平台用户身份标识',
5
  title: '消息标题',
6
  content: 'Markdown 格式的推送内容'
7
});
8

9
console.log(result);

是的，调用 pushoo 最简单只需要传递 4 个参数！

参数	必填	默认	说明
平台名称	✅	无	字符串，平台名称的缩写，支持：`webhook`、`qmsg`、`serverchan`、`pushplus`、`pushplushxtrip`、`dingtalk`、`wecom`、`bark`、`gocqhttp`、`atri`、`pushdeer`、`igot`、`telegram`、`feishu`、`ifttt`、`wecombot`、`discord`, `wxpusher`
token	✅	无	平台用户身份标识，通常情况下是一串数字和字母组合，详情和示例见下方详细说明
title		内容第一行	可选，消息标题，如果推送平台不支持消息标题，则会拼接在正文首行
content	✅	无	Markdown 格式的推送内容，如果推送平台不支持 Markdown，pushoo 会自动转换成支持的格式
options	❌	无	用于推送时的一些额外配置。类型`NoticeOptions`

1
interface NoticeOptions {
2
  /**
3
   * webhook通知方式的参数配置
4
   */
5
  webhook?: {
6
    /**
7
     * url 发送通知的地址
8
     */
9
    url: string;
10
    /**
11
     * method 请求方法，默认为 POST
12
     */
13
    method?: 'GET' | 'POST';
14
  };
15
  /**
16
   * bark通知方式的参数配置
17
   */
18
  bark?: {
19
    /**
20
     * url 用于点击通知后跳转的地址
21
     */
22
    url?: string;
23
  };
24
  /**
25
   * IFTTT通知方式的参数配置
26
   */
27
  ifttt?: {
28
    value1?: string;
29
    value2?: string;
30
    value3?: string;
31
  };
32
  /**
33
   * Discord通知方式的参数配置
34
   */
35
  discord?: {
36
    userName?: string;
37
    avatarUrl?: string;
38
  };
39
  /**
40
   * WxPusher通知方式的参数配置
41
   */
42
  wxpusher?: {
43
    uids?: string[];
44
    url?: string;
45
    verifyPay?: boolean;
46
  };
47
  dingtalk?: {
48
    /**
49
     * 消息类型，目前支持 text、markdown。不设置，默认为 text。
50
     */
51
    msgtype?: string;
52
  };
53
}

展开收起

详细说明#

💬 Webhook 缩写: `webhook`#

Webhook 是一种用户定义的 HTTP 回调，通常用于将实时数据推送到指定的 URL。pushoo 可以通过 Webhook 方式将消息推送到你自定义的后端。

示例调用：

1
let respond = await pushoo('webhook', {
2
  token: '', // 可选，暂不支持签名
3
  title: '', // 可选
4
  content: '推送内容',
5
  options: {
6
    webhook: {
7
      url: 'https://example.com/webhook-endpoint',
8
      method: 'POST' // 可选，默认为 POST，也可以设置为 GET
9
    }
10
  }
11
});

特别地，为兼容 Twikoo 中现有的使用方式，可以直接把平台名称设置为 Webhook 的 URL 地址（以 http:// 或 https:// 开头），无需传入 options。

1
let respond = await pushoo('https://example.com/webhook-endpoint', {
2
  token: '', // 可选
3
  title: '', // 可选
4
  content: '推送内容'
5
});

此时如果 URL 的末尾为 :GET 则使用 GET 方法发送请求（实际 URL 自动去掉 :GET），否则默认使用 POST 方法发送请求。

💬 Qmsg 缩写: `qmsg`#

Qmsg 酱是 Zendee 提供的第三方 QQ 消息推送服务，免费，消息以 QQ 消息的形式推送，支持私聊推送和群推送。请注意，为避免 Qmsg 酱被 Tencent 冻结，pushoo 会自动删除消息中的网址和 IP 地址。

前往 https://qmsg.zendee.cn/ 并使用 QQ 登录
点击 “管理台”，选择一个 Qmsg 酱，并添加 TA 为好友
在 “我的QQ列表” 中添加自己的 QQ 号
复制 “我的KEY” 下方的 key，填入 pushoo 的 token 中

示例 token：d3e96b6c50adf28cc6d1bb*****a4613

💬 Server 酱缩写: `serverchan`#

Server 酱是方糖提供的第三方多渠道推送服务，以服务号推送起家，稳定运行多年，免费收费并存，特色功能较多。

前往 https://sct.ftqq.com/r/13235 并使用微信登录
点击 “消息通道”，设置合适的消息通道并保存
点击 “SendKey”，复制 “SendKey” 下方的 key，填入 pushoo 的 token 中

示例 token：SCT1364TKdsiGjGvyAZNYD*****VAK0k

💬 Push Plus 缩写: `pushplus`#

Push Plus 是苏州破壳网络科技有限公司提供的第三方微信服务号推送服务，免费版存在不影响使用的广告，会员版特权如下：https://www.pushplus.plus/vip.html。

前往 https://www.pushplus.plus/ 并使用微信登录
点击 “一对一推送”，复制 “你的token” 下方的 token，填入 pushoo 的 token 中

示例 token：2832134a66df4da69ef941*****72317

💬 Push Plus Hxtrip 缩写: `pushplushxtrip`#

Push Plus Hxtrip 是中道（苏州）旅游网络科技有限公司提供的第三方微信服务号推送服务，免费无广告

前往 https://pushplus.hxtrip.com/message 并使用微信登录
复制 “您的Token” 下方的 Token，填入 pushoo 的 token 中

示例 token：2a00acb27e414ea4bf9d19*****08986

💬 钉钉缩写: `dingtalk`#

钉钉是阿里推出的办公即时消息软件，官方提供了机器人 API，可实现消息推送，免费。推送的消息必须包含配置的关键字，否则推送不成功。只能在群聊中创建机器人，可选择 2 名好友组建群聊，然后移除 2 名好友（好友会收到提醒，请谨慎操作），再添加机器人。

根据 https://open.dingtalk.com/document/group/custom-robot-access 的说明，创建一个机器人。如果是在 Twikoo 评论系统中使用，请配置关键字为 “评论”
复制机器人的 Webhook，填入 pushoo 的 token 中

示例 token：https://oapi.dingtalk.com/robot/send?access_token=06ff1823a060af772677680d9522b547bc2685251d47bed17ddada*****41d97（完整的 Webhook）或者 06ff1823a060af772677680d9522b547bc2685251d47bed17ddada*****41d97（只保留 access token）

💬 企业微信缩写: `wecom`#

企业微信应用消息推送，免费，限制较少。

用电脑打开 https://work.weixin.qq.com/，注册一个企业
注册成功后，点「管理企业」进入管理界面，选择「应用管理」 → 「自建」 → 「创建应用」
应用名称填入机器人的名称，应用 logo 选择机器人的头像，可见范围选择公司名
创建完成后进入应用详情页，可以得到应用ID( agentid )，应用Secret( secret )，复制 PS：获取应用Secret时，可能会将其推送到企业微信客户端，这时候微信里边是看不到的，需要在企业微信客户端里边才能看到
进入「我的企业」页面，拉到最下边，可以看到企业ID，复制
进入「我的企业」 → 「微信插件」，拉到下边扫描二维码，关注以后即可收到推送的消息
将第 4 步和第 5 步取得的 企业ID#应用Secret#应用ID 拼到一起，中间用 “#” 号分隔，填入 pushoo 的 token 中

示例 token：ww97a01a*****1e5f1#xHapDXmgZtlBgRQQXMb4kfh3y75Ynoubl*****l9ytE#1000005

PS：如果出现接口请求正常，企业微信接受消息正常，个人微信无法收到消息的情况，请确认如下配置：

进入「我的企业」 → 「微信插件」，拉到最下方，勾选「允许成员在微信插件中接收和回复聊天消息」
在企业微信客户端「我」 → 「设置」 → 「新消息通知」中关闭「仅在企业微信中接受消息」限制条件

💬 Bark 缩写: `bark`#

Bark 是 iOS 通知中心推送工具，可以推送消息到苹果手机上，免费。

下载 Bark APP
轻触下方 “服务器”，复制第一个服务器地址，删除 “这里改成你自己的推送内容” 字样，填入 pushoo 的 token 中

示例 token：https://api.day.app/q2S4vQqpNyaS*****9neeJ/（完整的 URL）或者 q2S4vQqpNyaS*****9neeJ（只保留 token）

💬 go-cqhttp 缩写: `gocqhttp`#

go-cqhttp 是开源 QQ 机器人程序，免费，需自行搭建，插件十分丰富，但 “野生” 机器人并没有得到 Tencent 官方的支持，有账号被冻结的风险。

前往 go-cqhttp release 下载对应系统版本
此处省略安装过程，可参考 https://docs.go-cqhttp.org/guide/quick_start.html
修改配置文件，配置 default-middlewares 下面的 access-token，启动 go-cqhttp
按照示例所示的 API 调用地址，填入 pushoo 的 token 中

示例 token：http://你的IP或域名:端口号/send_private_msg?user_id=QQ号&access_token=你配置的token（QQ号）或 http://你的IP或域名:端口号/send_group_msg?group_id=群号&access_token=你配置的token（QQ群）

💬 atri 缩写: `atri`#

go-cqhttp 是开源 QQ 机器人程序，由Tianli提供的pushoo推送服务。

使用前请加机器人好友（QQ：2102916311）

示例 token：1627236613（QQ号）

💬 PushDeer 缩写: `pushdeer`#

PushDeer 是方糖一个开源的无 APP 推送解决方案，支持 iOS 14+ 轻应用、MacOS 11+ 客户端、Android 快应用，免费。

前往 https://www.pushdeer.com/product.html 扫码打开轻应用并登录
轻触下方 “Key”，轻触右上角 “+” 号创建第一个 Key，复制，填入 pushoo 的 token 中

示例 token：PDU431TfFHZICvR6lJrFBswSRN1cJ*****zzFvR

💬 iGot 缩写: `igot`#

iGot 是一款聚合 APP、邮箱、微信等多种推送方式的第三方推送平台，免费，存在影响体验的广告。

根据 https://push.hellyw.com/doc/ 的说明，获取推送 key，填入 pushoo 的 token 中

示例 token：621f3b1dd2eba1*****101d9

💬 Telegram 缩写: `telegram`#

Telegram 是自由的聊天工具，支持机器人 API，免费，中国大陆服务器无法使用这种推送方式。

通过 @BotFather 创建机器人，并获取 api_token
通过 @userinfobot 获取接受消息对象的 chat_id。接受消息的对象可以是用户，频道，或群组
将第 1 步和第 2 步取得的 api_token#chat_id 拼到一起，中间用 “#” 号分隔，填入 pushoo 的 token 中

示例 token：5262***170:AAEzkaMjOayU13fFzcg9PI7_7*****p1iAs#958***732

💬 飞书缩写: `feishu`#

飞书是字节跳动旗下的办公即时消息软件，官方提供了机器人 API，可实现消息推送，免费。推送的消息必须包含配置的关键字，否则推送不成功。只能在群聊中创建机器人。

进入群组，打开会话设置，找到群机器人，并点击添加机器人，选择自定义机器人并添加。如果是在 Twikoo 评论系统中使用，请配置关键字为 “评论”
复制机器人的 Webhook，填入 pushoo 的 token 中

示例 token：https://open.feishu.cn/open-apis/bot/v2/hook/393df85f-7b2c-4ff6-bd4f-*******3ed54（完整的 Webhook）或者 393df85f-7b2c-4ff6-bd4f-*******3ed54（只保留 access token）

💬 IFTTT 缩写: `ifttt`#

IFTTT Webhooks推送，免费。

首先打开 http://ifttt.com/maker，确保你的WebHooks服务是可以用；
点击 Document 获取你的 Key, 点击 Create 开始创建一个Applet；
If this Then that, this选择WebHooks，Trigger选择Receive a web request，Event Name填一个有意义的，如 push；
if this then that, that选择Notification，参数填Value1 、Value2、Value3;
将 2 步获取的 key 和第 3 步设置的 Event Name 拼接到一起，中间用 “#” 号分隔，填入 pushoo 的 token 中。

示例 token：d-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx#push

PS: title 和 content 会分别对应 Value1 和 Value2，如果要设置 Value3 请在 options 设置

💬 WECOMBOT 缩写: `wecombot`#

企业微信群机器人推送，免费。

使用企业微信，作为群管理员，创建一个群机器人，复制出机器人的 Webhook；
然后在 Webhook 中提取出 key 值，填入 pushoo 的 token 中.

示例 token: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xx Webhook中提取Token为 xxxxxxxx-xxxx-xx;

💬 Discord 缩写: `discord`#

Discord Webhooks推送，免费。

打开Discord，进入频道设置，找到webhook，点击创建webhook；
复制webhook的url，将整个URL填入pushoo的token中。
如果需要设置用户名和头像，可以在options中设置。
token 设置也可以通过提取 webhook url 中的 id 和 token 来设置，格式为 id#token。如：https://discord.com/api/webhooks/123456789012345678/abcdefghijklmnopqrstuvwxyz，则 token 设置为 123456789012345678#abcdefghijklmnopqrstuvwxyz。

示例 token：

https://discord.com/api/webhooks/123456789012345678/abcdefghijklmnopqrstuvwxyz
123456789012345678#abcdefghijklmnopqrstuvwxyz

💬 WxPusher 缩写: `wxpusher`#

WxPusher 是一款微信推送平台，免费。

打开 https://wxpusher.zjiecode.com/docs/，注册账号，创建应用，获取 appToken;
创建主题，获取主题ID。如：1234；
使用微信关注创建的主题，完成主题订阅；
如果需要设置特定推送用户，可以在 options 中设置 uids; 如果要设置消息跳转链接，可以在 options 中设置 url；如果需要设置验证支付，可以在 options 中设置 verifyPay；
最后获取的 appToken 和 topicId 拼接到一起，中间用 “#” 号分隔，填入 pushoo 的 token 中（如果有多个主题ID，可用半角逗号分隔）。

示例 token:

单个主题ID：AT_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX#1234
多个主题ID：AT_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX#1234,5678

💬 Join 缩写: `join`#

示例 token: apiKey#deviceId

部署Twikoo到cloudflaer

Sun, 17 May 2026 00:00:00 GMT

部署Twikoo#

复制仓库#

首先 Fork 博主的仓库，输入你自己的仓库名称，点击 Create fork 按钮创建自己的仓库。

img

国内对github的访问向来是时断时续的，如果安装失败可以等一等，或者使用科学上网工具，这里推荐可以注册一个，目前有免费流量可以薅羊毛。

创建D1数据库#

img

创建成功后回到列表页面，可以找到对应红框中的 ID 复制出来。

img

然后点击 twikoo 数据库，选择 控制台 页签，将仓库根目录下的 schema.sql 文件中的内容全部复制到输入框中，点击 执行 按钮。

img

很快数据库表就创建完了，最后修改仓库根目录下的 wrangler.toml 文件中的 database_id 值。

1
[[d1_databases]]
2
binding = "DB" # available in your Worker on env.DB
3
database_name = "twikoo"
4
database_id = "b35e0bd5-6d17-42eb-a597-ff4869a74461" # 这里替换成你前面红框里的内容

创建R2存储#

点击左侧栏 R2 对象存储，点击 创建存储桶，填入 twikoo 作为存储桶名称，点击 创建存储桶 按钮。

img

创建成功后后回到列表页面，就可以看到刚才创建的存储桶了。

img

再点击 twikoo 进入存储桶，点击 设置 页签，在 公开访问 点击 连接域，输入你想设置的域名比如 twikoo.r2.example.org。如果还没有个人域名的可以看我的另外一篇博客如何注册一个域名并托管到Cloudflare。

img

然后点击 继续，再点击 连接域 就会回到设置页面，这时你会看到你设置的域状态为 正在初始化，过几分钟再次刷新状态就变成了 活动。

img

接下来还需要将刚才的域名写入修改仓库根目录下的 wrangler.toml 文件中。

1
[vars]
2
R2_PUBLIC_URL = "https://twikoo.r2.example.org" # 这里替换成你设置的域名

Worker部署#

在 Cloudflare 的左侧栏点击 Workers 和 Pages，点击 创建，再点击 创建 Worker，输入名称 cf-create-worker。

img

然后点击 部署，过一会显示部署成功，再点击 继续处理项目，选择 设置 页签，滚动到构建区域，点击 连接 按钮。

img

此时右侧会弹出一个面板，先连接你的 Github 账号，然后选择你的仓库，如果列表中找不到可以直接输入仓库名，比如 twikoo-cloudflare，再选择 main 分支。

img

然后在 部署命令 的输入框中填入 npx wrangler deploy --minify，最后点击 连接 按钮保存。

如果在前一步的列表中仓库名是手动输入的，你需要在这里点击 管理 按钮，跳转到 Github 登录账号。

img

完成登录后进入 Repository access 页面，点击 Select repositories 按钮，选择你的仓库后点击 Save 按钮。

img

此时页面会跳转回 Cloudflare，有可能会报一个错误，不用管它，直接关闭页面就可以了。

现在把前面修改的 wrangler.toml 文件保存并提交到 Github 仓库，此时就会触发 Worker 的自动构建了，过一会你就会在 Workers 和 Pages 页面看到部署已经更新，点击 访问 按钮，一切正常的话，你会看到这样的内容。

1
{
2
    "code": 100,
3
    "message": "Twikoo 云函数运行正常，请参考 https://twikoo.js.org/frontend.html 完成前端的配置",
4
    "version": "1.6.40"
5
}

绑定域名#

再次点击 twikoo-cloudflare 进入 设置 页签，在 域和路由 中点击 添加，右侧弹出 域和路由 面板。点击 自定义域，输入你想要绑定的域名，比如 twikoo.example.org，点击 添加域 按钮。

img

添加完成后你的域名就和部署的 Worker 绑定好了。

配置博客#

修改主题配置#

回到上一篇创建的个人博客仓库，在 themes/hexo-theme-matery 目录下打开 _config.yml 文件进行编辑，搜索关键字 twikoo 将 enabled 改为 true，再将 envId 改成前面部署绑定的域名。

1
twikoo:
2
  enable: true
3
  envId: https://twikoo.example.org # 这里改成前面部署绑定的域名
4
  # region: ap-guangzhou # 环境地域，默认为 ap-shanghai
5
  # path: 'window.location.pathname' # 自定义文章路径

修改完提交到 Github 后 Cloudflare Pages 会自动部署，等部署完打开你的个人博客，在你的博文最下面就可以看到评论区了。

img

配置评论模块#

点击评论区的小齿轮图标，首次进入需要设置密码，设置完就会进入管理面板，点击 配置管理 页签进行初始配置。

img

点开 隐私，在 IMAGE_CDN 处输入 cloudflare，点击 保存 按钮启用图片上传功能。

img

其余每个配置项都有很详细的说明，大家可以自行慢慢摸索，不修改也已经可以正常使用了。

防止机器人#

发表评论时可以使用 Cloudflare Turnstile 的检查来阻止机器人，如果需要启用先在 Cloudflare 的左侧栏点击 Turnstile，点击 添加小组件 按钮。

img

小组件名称可以随便填写，比如 twikoo，点击下面的 添加主机名 按钮会在右侧弹出面板。在最上面的输入框填入个人博客的域名，比如 blog.example.org，点击右侧的 添加 按钮，主机名就会出现在下面的已选择主机名列表中。再点击最下面的 添加 按钮，右侧面板关闭，主机名会添加到 主机名管理 区域的列表中。最后点击右下角的 创建 按钮，就会显示已成功创建 Turnstile 小组件。

img

在这个页面上 站点密钥 和 密钥 是你需要复制下来配置到 Twikoo 的管理面板中的。接下来再次打开管理面板，点开 反垃圾，在 TURNSTILE_SITE_KEY 处填入 站点密钥 的内容，在 TURNSTILE_SECRET_KEY 处填入 密钥 的内容，点击 保存 关闭面板。

img

完成后再次发表评论就会出现 Cloudflare 的机器人检查框了，大部分情况下等一会就会显示成功，或者出现一个勾选框确认后检查成功，只有极少数情况会发起 JS质询 进行挑战。

img

后记#

至此，一个基本上完整的评论系统就上线了，对于 Twikoo 的其他配置，还有一些建议：

使用隐藏入口不要暴露管理面板的配置按钮；
设置一个复杂的密码不要让别人轻易猜出来；
添加评论通知，pushoo.js 提供了丰富的通知方式，可以自行看文档选择最适合的方式。

来源: 一梦一孤舟文章作者: Mingy 文章链接: https://blog.mingy.org/2024/12/hexo-add-twikoo/ 本文章著作权归作者所有，任何形式的转载都请注明出处。

教材中的岳飞竟然被爱迪生救妈妈取代了

Sat, 09 May 2026 00:00:00 GMT

还记得被移除教材的#

岳　飞#

一代英雄，千古忠魂

◆

怒发冲冠，凭栏处、潇潇雨歇。
抬望眼、仰天长啸，壮怀激烈。
三十功名尘与土，八千里路云和月。
莫等闲，白了少年头，空悲切！

——岳飞《满江红》

壹 · 乱世出英雄#

北宋末年，朝堂昏聩，水旱频发，田地荒芜，民不聊生。外敌铁蹄践踏中原，百姓在天灾人祸的双重夹击下苦苦挣扎。岳飞，便出生在这样一个风雨飘摇的乱世之中。

一场无情的洪水夺走了他的父亲，使本就贫寒的家境雪上加霜。然而，正是在这样的困苦之中，岳飞目睹了家国的内忧外患，也在岳母的熏陶下，心中早早种下了提三尺剑，立不世之功的远大志向。

家境贫寒，无力从师，岳飞便每日以黄沙铺地，用树枝练字习武。这份坚韧刻苦，最终打动了名师周桐，将一身本领倾囊相授。出师之后的岳飞博览群书，将春秋兵法熟烂于心，又习得一身精湛武艺，终成可造之材。

· · · · · ·

贰 · 披甲上阵，壮志报国#

金人南下侵略中原，岳飞在岳母的鼓励下毅然参军。此后宋军兵败如山倒，一众皇室宗亲被金人掳去，都城遭到洗劫，北宋就此灭亡——靖康之变，成为宋王朝永远抹不去的耻辱。

赵构称帝南渡，却无意收复河山，只图苟且偷安，将北方千万黎民、祖宗坟茔拱手相让。岳飞忍无可忍，愤然上书，反对南逃投降，却因此触怒上级，被革去军职。

不得已，他北上投奔抗金义军，在危难之际被东京留守宗泽所救，收于麾下。自此，陷阵沙场的岳飞如蛟龙得水，凭借过人才能，一路破阵杀敌，威名渐起。

“出师未捷身先死，
长使英雄泪满襟。”

——恩师宗泽弥留之际的长叹

叁 · 岳家军，金人噩梦#

恩师宗泽离世，朝廷君臣窜逃，破碎的山河，无一不刺痛着岳飞的心。他决心完成恩师遗愿，沿途收拢溃散军士，严明治军。岳飞的信念与意志感染着每一位将士，一支钢铁之师——岳家军，就此诞生。

1129 年

在广德袭击金兵，势如破竹，令金人闻风丧胆。

1133 年

收复建康，继而光复襄阳六郡，南宋国威大振。

1136 年

率军攻克陕西、河南多地，北伐势头锐不可当。

1140 年 · 郾城大捷

岳家军突入敌阵，以少胜多，给予金军沉痛打击，并一路驱赶金军狼狈逃窜。直捣黄龙的梦想，触手可及……

肆 · 十二道金牌，壮志成灰#

然而，赵构所图，不过是阻止金人南下、保住半壁江山。就在岳飞即将渡河北上、光复失地的关键时刻，一天之内，十二道金牌从临安飞驰而来，令岳家军班师。

天命难违，岳飞只能含泪南归。他望着北方苍茫的河山，泪流满面，悲愤交加，只余一声长叹：

“十年之功，废于一旦，
所得诸郡，一朝南下。”

岳飞班师的那一天，数万黎民夹道而立，哭声震动四野。用无数鲜血收复的国土，就此再度沦陷于金人铁蹄之下。

· · · · · ·

伍 · 莫须有，千古奇冤#

班师之后，岳飞被奸佞秦桧以莫须有的罪名加害，投入大狱，遭受无尽迫害。直到生命的最后一刻，始终不肯屈服的岳飞，在供词上写下了这最后八个字——

天日昭昭

——岳飞狱中绝笔

公元1142年，一代抗金名将、民族英雄岳飞含冤离世，年仅三十九岁。秦桧构陷岳飞的铁像，至今长跪于岳飞墓前，受万世唾骂。

· · · · · ·

陆 · 民族英雄，不可磨灭#

然而，比岳飞蒙冤更令人痛心的，是近代发生的一场风波。2003年，曾有专家提出将岳飞从教材中移除，理由是”以现代眼光看，金人并非外族，岳飞抗金只算民族内部纷争，不能称之为民族英雄”。

此番说法，实乃滑天下之大稽。历史人物的评价，必须还原于其所处的历史语境。在家国存亡之秋，岳飞以血肉之躯守护百姓、抵御外侮、精忠报国——无论时代如何变迁，这份担当与牺牲，无愧于”民族英雄”四字，这种民族之魂，绝不可磨灭。

试想，那些站在先人浴血打下的江山上，却要抹除民族英雄记忆的人，又该当何论？

所幸，人教版统编教材最终明确描述了岳飞的事迹，并郑重声明其始终是民族英雄。这，是历史的公道，也是亿万人心的坚守。

三十功名尘与土，八千里路云和月。

如果真的有一天，岳飞、文天祥等人从教材中消失，屏幕前的我们，还记得他们吗？再过十年、二十年，下一代的记忆，会不会也渐渐模糊？

—— 记住他们，就是守护我们自己的根。

◆

— 历史 · 人物篇壮志饥餐胡虏肉笑谈渴饮匈奴血

晚清首富胡雪岩的江南第一豪宅

Sat, 09 May 2026 00:00:00 GMT

晚清第一豪宅 · 杭州探秘

我的身后，就是#

晚清首富#

耗资 300 万两白银的传奇宅院

◆

来杭州旅游，很多人只知道西湖断桥，却不知道就在城内，藏着一座晚清首富胡雪岩耗资 300 万两白银 铸就的江南第一豪宅。今天，我带大家推开这扇门，去看看一个放牛郎是如何走进中国商业的巅峰，又在这座宅院里留下了怎样的传奇。

壹 · 一扇门，手握乾坤#

还没进门，胡雪岩便已向你亮出了他的底牌。大门上那枚门把手造型独特——一只手，握住一个圆圈，寓意”手握乾坤、手握大权”，同时兼作门铃使用。一个商人，把自己的野心刻进了入口最显眼的地方。

跨入正厅，两顶华贵的轿子映入眼帘——这里是胡雪岩的”车库”，停放着他的两辆”劳斯莱斯”。窗大的那顶是夏轿，通风凉爽；窗小的那顶是冬轿，内置火盆可取暖，堪称古代暖空调。两百多平的厅堂，就这样被两顶轿子填满了贵气。

正厅匾额 · 同治皇帝亲题

勉善承荣

“承”故意写作”成”——愿卿保持善良，乐善好施，一路走下去。
整座宅院里，分量最重的四个字。

· · · · · ·

贰 · 楠木厅，价值十亿的传奇#

穿过廊道，走进整座旧居最令人屏息的地方——楠木厅，又称载福堂。地板、柱子、梁架，全部采用极品金丝楠木打造。当你拿起手电筒照射柱身，黄金般的丝纹便在木芯深处流淌，宛若繁星，令人叹为观止。

～10亿

楠木厅当前估价（元）

1套房

一根柱子可换北京大别墅

十几吨

全宅黄铜用量

更令人惊叹的是，100多年前，胡雪岩家的窗户上已安装了法国进口彩色无尘玻璃。每块玻璃颜色各异，阳光穿透而过，五彩光影洒落在雕花木梁之上，中西合璧，美轮美奂。而彼时，大多数中国百姓的窗户，还是用手一捅就破的窗户纸。

· · · · · ·

叁 · 细节里的富贵#

🏯 御风楼 · 当时杭州最高民宅

足足 9米，比当时故宫还高。登上御风楼，左眺西湖，右望钱塘江，尽揽杭州山水。这是胡雪岩俯瞰世界的眼。

💎 十万两白银的”寿”字太湖石

园中最贵的石头，形似大写”寿”字，购入价高达十万两白银。对富贵之人而言，健康长寿，永远是无价之物。

🎭 私家戏台 · 把明星请回家

园内专设戏台，想听戏时把戏班请到家里——就像如今把明星接到客厅给你唱卡拉OK，对面御风楼是最佳观演位。

🔧 黄铜排水管 · 肥水不流外人田

天落雨水经全铜管道导入黄铜大缸，一为节水”肥水不流外人田”，二作消防——木质结构的宅院，缸中之水是最后一道防线。

🍳 七星灶 · 百平大厨房

七口锅并排而列，大炒小温各司其职，名曰”七星灶”。厨师就住在厨房一墙之隔，东家深夜想吃夜宵，隔墙喊一声即可。

📞 一百年前的”内线电话”

姨太太院与下人住所之间安装传声筒，胡雪岩深夜一句话，下人立刻行动。这是一百年前最私密的”内网通话系统”。

· · · · · ·

肆 · 7.6㎡的地窖，藏着一个时代#

旧居深处，一处楼梯通向地下——那是一间仅有 7.6 平方米 的地窖，据说储存着胡雪岩的黄金与机密财物。整个旧居最华贵的楠木厅，与这间逼仄的地窖，构成了财富最真实的两面：明处的炫耀，与暗处的戒备。

— 关于这个男人 —

胡雪岩（1823—1885），原名胡光墉。幼年家贫，以放牛为生。凭借过人胆识，从钱庄学徒起步，借助官场人脉，开钱庄、办药铺、做军火，一步步成为大清帝国唯一被赐穿黄马褂的商人——红顶商人。

长得据说与演曹操的那位明星颇为神似。

· · · · · ·

伍 · 一个放牛郎的天花板#

法国玻璃、金丝楠木、十几吨黄铜、价值十万两的太湖石……一个出身贫苦的放牛郎，最终在杭州留下了这片令人叹为观止的宅院。每一个细节，都是他那个时代对”极致”二字的最大努力。

胡雪岩的发家之道，是一部值得细细品味的商业传奇。如果你也好奇，那就先去杭州，推开那扇”手握乾坤”的大门，从一砖一木中感受他的故事。

— 写在最后 —

来杭州旅游，别只去西湖断桥，
去胡雪岩旧居走一走，
感受一下，一个普通人可以走到多远的地方。
关注我，下期为你解密胡雪岩的发家之道。

◆

— 历史 · 旅行篇杭州 · 胡雪岩旧居

git指令学习

Mon, 04 May 2026 00:00:00 GMT

Git 详细使用教程（命令行版，附命令作用解释）#

Git 是目前最流行的分布式版本控制系统，核心作用是跟踪文件变化、管理代码版本，支持多人协作开发，可随时回滚到历史版本，避免代码丢失或冲突。本教程全程使用命令行操作（Windows 用 Git Bash、Mac/Linux 用终端），从基础配置到高级用法，逐一讲解命令作用和实操场景，新手可直接跟着步骤练习。

一、Git 前期准备（必做）#

1. 安装 Git#

先在本地安装 Git，安装完成后，打开命令行，输入以下命令验证是否安装成功：

Terminal window

1
git --version

命令作用：查看当前 Git 版本，若输出类似git version 2\.43\.0，说明安装成功；若提示“命令不存在”，需重新安装 Git。

2. 初始配置（绑定身份，关键步骤）#

Git 每次提交代码时，会记录提交者的身份（用户名和邮箱），用于区分不同开发者，必须配置后才能正常提交代码。

Terminal window

1
# 配置用户名（建议和 GitHub/GitLab 用户名一致）
2

3

4

5

6
git config --global user.name "你的用户名"
7

8

9

10

11
# 配置邮箱（建议和 GitHub/GitLab 绑定邮箱一致）
12

13

14

15

16
git config --global user.email "你的邮箱地址"

展开收起

命令作用详解：

git config：Git 的配置命令，用于设置 Git 相关参数；
\-\-global：全局参数，意味着该配置在当前电脑所有 Git 项目中生效（若只想针对单个项目配置，去掉该参数，进入项目后再执行）；
user\.name/user\.email：配置提交者的用户名和邮箱，后续所有提交记录都会显示该信息。

验证配置是否成功：

Terminal window

1
git config --list

命令作用：查看当前 Git 的所有配置，若能看到刚才设置的用户名和邮箱，即为配置成功。

二、Git 核心概念（先理解，再操作）#

在使用命令前，先明确 3 个核心工作区域，避免操作混乱：

工作区（Working Directory）：就是你本地电脑上的项目文件夹，你直接修改的文件都在这个区域；
暂存区（Stage/Index）：临时存放你修改的文件，相当于“缓存区”，用于确认哪些修改需要提交到版本库；
版本库（Repository）：Git 真正保存版本的地方，存放所有提交记录，可随时回滚到任意历史版本（分为本地版本库和远程版本库，如 GitHub）。

核心流程：工作区修改 → 提交到暂存区 → 提交到本地版本库 → 推送到远程版本库（如 GitHub）。

三、本地仓库操作（最基础，必练）#

本地仓库是 Git 操作的基础，无需联网，可独立完成版本管理，适合个人开发或离线工作。

1. 初始化本地仓库（创建新项目）#

适用于：新建一个项目，想要用 Git 管理版本（比如本地新建的文件夹，需要变成 Git 仓库）。

Terminal window

1
# 1. 进入你要管理的项目文件夹（先切换到目标路径）
2

3

4

5

6
cd 你的项目文件夹路径（如：cd /Users/xxx/Documents/MyProject）
7

8

9

10

11
# 2. 初始化 Git 仓库
12

13

14

15

16
git init

展开收起

命令作用详解：

cd：切换目录命令，用于进入你要操作的项目文件夹（若路径错误，会提示“没有该文件或目录”）；
git init：初始化 Git 仓库，执行后会在项目文件夹中生成一个隐藏的 \.git 文件夹（该文件夹是 Git 版本库的核心，不要删除），此时项目就被 Git 管理起来了。

注意：每个项目只需初始化一次，初始化后，该文件夹就是 Git 仓库了。

2. 查看工作区状态（高频命令）#

无论做什么操作，建议先查看工作区状态，确认当前文件的修改情况，避免误操作。

Terminal window

1
git status

命令作用：查看工作区、暂存区的文件状态，常见输出场景：

未修改：提示 nothing to commit, working tree clean（工作区干净，没有任何修改）；
已修改但未提交到暂存区：文件名称显示为 modified（红色）；
已提交到暂存区但未提交到版本库：文件名称显示为 staged（绿色）。

3. 将修改的文件提交到暂存区#

适用于：你在工作区修改了文件（如新增、修改、删除文件），需要先提交到暂存区，再准备提交到版本库。

Terminal window收起

1
# 方式1：提交所有修改的文件（最常用）
2

3

4

5

6
git add .
7

8

9

10

11

12
# 方式2：提交指定文件（适用于只提交部分修改）
13

14

15

16

17
git add 文件名（如：git add index.html）
18

19

20

21

22

23
# 方式3：提交指定文件夹下的所有文件
24

25

26

27

28
git add 文件夹名（如：git add src/）

展开收起

收起

命令作用详解：

git add：将工作区的修改“暂存”起来，告诉 Git“这些修改我要提交到版本库，请先记录下来”；
\.：表示当前目录下所有修改的文件（包括新增、修改、删除），简化操作，无需逐个指定文件；
提交后，再执行git status，会看到文件变成绿色，提示“changes to be committed”（暂存区有等待提交的内容）。

4. 将暂存区的文件提交到本地版本库#

这是 Git 版本管理的核心步骤，提交后，修改会被永久保存到本地版本库，生成一条新的版本记录。

Terminal window

1
git commit -m "提交说明"

命令作用详解：

git commit：将暂存区的内容提交到本地版本库，完成一次版本更新；
\-m \&\#34;提交说明\&\#34;：必填参数，用于描述本次提交的内容（如“新增登录页面”“修复首页轮播bug”），建议说明清晰，方便后续查看历史记录时，快速知道该版本做了什么修改；
提交成功后，会提示类似 1 file changed, 2 insertions$\+$ 的信息，表示“1个文件被修改，新增了2行内容”。

注意：必须先执行 git add，再执行 git commit，否则会提示“没有可提交的内容”。

5. 查看提交历史记录#

适用于：查看之前的提交记录，包括提交者、提交时间、提交说明、版本号（用于回滚版本）。

Terminal window收起

1
# 方式1：查看完整历史记录（详细）
2

3

4

5

6
git log
7

8

9

10

11
# 方式2：查看简洁历史记录（只显示版本号和提交说明，推荐）
12

13

14

15

16
git log --oneline
17

18

19

20

21
# 方式3：查看所有提交记录（包括回滚的记录）
22

23

24

25

26
git reflog

展开收起

收起

命令作用详解：

git log：显示所有提交记录，每条记录包含版本号（40位哈希值）、提交者、提交时间、提交说明；
\-\-oneline：简化输出，每条记录只显示前7位版本号和提交说明，更易查看；
git reflog：比 git log 更全面，会记录所有操作（包括回滚、撤销提交），常用于找回误删的版本。

6. 版本回滚（恢复到历史版本）#

适用于：修改出错、代码丢失，需要恢复到之前的某个稳定版本（核心操作，务必掌握）。

Terminal window收起

1
# 第一步：查看历史版本，获取要回滚的版本号（前7位即可）
2

3

4

5

6
git log --oneline
7

8

9

10
# 第二步：回滚到指定版本（两种常用方式）
11

12

13

14

15
# 方式1：彻底回滚，删除回滚版本之后的所有提交记录（谨慎使用，适合个人开发）
16

17

18

19

20
git reset --hard 版本号（如：git reset --hard a1b2c3d）
21

22

23

24
# 方式2：安全回滚，保留回滚版本之后的修改（推荐，适合多人协作）
25

26

27

28

29
git revert 版本号（如：git revert a1b2c3d）

展开收起

收起

命令作用详解：

git reset \-\-hard 版本号：强制回滚到指定版本，工作区、暂存区的内容都会同步到该版本，之后的提交记录会被删除（无法恢复，谨慎使用）；
git revert 版本号：不会删除任何提交记录，而是生成一条新的提交记录，将代码恢复到指定版本，后续的修改仍然保留（安全，多人协作时优先使用）；
版本号：通过 git log \-\-oneline 获取，如 a1b2c3d（前7位即可，Git 会自动识别）。

7. 撤销工作区的修改（未提交到暂存区）#

适用于：在工作区修改了文件，但还没执行 git add，想放弃修改，恢复到上一次提交后的状态。

Terminal window

1
# 撤销单个文件的修改
2

3

4

5

6
git checkout -- 文件名（如：git checkout -- index.html）
7

8

9

10

11
# 撤销所有工作区的修改（未 add 的）
12

13

14

15

16
git checkout .

展开收起

命令作用：放弃工作区的所有未暂存修改，将文件恢复到最近一次 git commit 或 git add 后的状态（注意：撤销后，修改会彻底丢失，无法恢复）。

8. 撤销暂存区的修改（已 add 但未 commit）#

适用于：执行了 git add，将修改提交到了暂存区，但还没执行 git commit，想撤销暂存，重新修改。

Terminal window

1
git reset HEAD 文件名（如：git reset HEAD index.html）
2

3

4
# 撤销所有暂存区的修改
5

6

7

8

9
git reset HEAD .

命令作用：将暂存区的修改撤销回工作区，此时文件状态会从“绿色（staged）”变回“红色（modified）”，之后可以重新修改、重新 add。

四、远程仓库操作（多人协作必备）#

远程仓库（如 GitHub、GitLab、Gitee）是用于多人共享代码的服务器，本地仓库的代码可以推送到远程，也可以从远程拉取别人的代码，实现协作开发。

前提：你已经有一个远程仓库（如在 GitHub 上创建了仓库），且本地 Git 已配置好远程仓库地址。

1. 关联远程仓库（第一次绑定）#

适用于：本地已有 Git 仓库，想要和远程仓库绑定，实现代码同步。

Terminal window

1
git remote add origin 远程仓库地址

命令作用详解：

git remote：用于管理远程仓库的命令（如添加、删除、查看远程仓库）；
add：添加远程仓库；
origin：远程仓库的别名（默认用 origin，可自定义，如 git remote add github 远程地址），后续操作远程仓库时，用别名即可，无需输入完整地址；
远程仓库地址：从 GitHub/GitLab 复制，一般分为 HTTPS 和 SSH 两种（HTTPS 无需配置密钥，直接输入账号密码即可；SSH 需要配置密钥，无需每次输入账号密码，推荐长期使用）。

查看已关联的远程仓库：

Terminal window

1
git remote -v

命令作用：查看当前本地仓库关联的所有远程仓库，输出会显示远程仓库的别名、地址，以及可进行的操作（fetch：拉取，push：推送）。

2. 从远程仓库拉取代码（同步别人的修改）#

适用于：多人协作时，别人将代码推送到了远程仓库，你需要将远程的最新代码拉取到本地，保持本地和远程同步。

Terminal window

1
# 方式1：拉取远程默认分支（如 main/master）的最新代码（最常用）
2

3

4

5

6
git pull origin main（或 master，取决于远程仓库的默认分支名）
7

8

9

10

11
# 方式2：拉取远程指定分支的代码
12

13

14

15

16
git pull origin 分支名（如：git pull origin develop）

展开收起

命令作用详解：

git pull：等价于 git fetch \+ git merge，即先从远程拉取最新代码到本地临时区域，再自动合并到当前本地分支；
origin：远程仓库别名；
main/master：远程仓库的默认分支（GitHub 现在默认分支是 main，旧版本是 master）；
注意：拉取代码前，建议先执行 git commit，将本地的修改提交到本地版本库，避免拉取时出现代码冲突。

3. 将本地代码推送到远程仓库（分享自己的修改）#

适用于：你在本地完成了代码修改（已 commit 到本地版本库），想要将修改推送到远程仓库，让别人看到你的代码。

Terminal window收起

1
# 方式1：推送本地默认分支到远程默认分支（第一次推送需加 -u）
2

3

4

5

6
# 第一次推送（绑定本地分支和远程分支，后续可直接用 git push）
7

8

9

10

11
git push -u origin main（或 master）
12

13

14

15
# 后续推送（已绑定分支，无需加 -u）
16

17

18

19

20
git push origin main（或 master）
21

22

23

24
# 方式2：推送本地指定分支到远程指定分支
25

26

27

28

29
git push origin 本地分支名:远程分支名（如：git push origin develop:develop）

展开收起

收起

命令作用详解：

git push：将本地版本库的提交记录推送到远程仓库；
\-u：第一次推送时使用，用于绑定本地分支和远程分支（如本地 main 分支绑定远程 main 分支），后续推送时，直接输入 git push 即可，无需指定别名和分支；
推送失败常见原因：① 本地代码不是最新的（需先 git pull 拉取远程最新代码，解决冲突后再推送）；② 没有远程仓库的权限（检查账号密码或 SSH 密钥配置）。

4. 克隆远程仓库到本地（第一次下载）#

适用于：本地没有该项目，直接从远程仓库下载完整的项目代码（包括所有版本记录）。

Terminal window

1
git clone 远程仓库地址

命令作用详解：

git clone：将远程仓库的所有内容（包括代码、版本记录、分支）完整下载到本地，自动创建项目文件夹，并初始化 Git 仓库；
执行后，本地会自动关联该远程仓库（别名默认是 origin），无需再执行 git remote add；
示例：git clone https://github\.com/用户名/项目名\.git（HTTPS 地址），或 git clone git@github\.com:用户名/项目名\.git（SSH 地址）。

5. 查看远程分支#

Terminal window收起

1
# 查看本地所有分支
2

3

4

5

6
git branch
7

8

9

10

11
# 查看远程所有分支
12

13

14

15

16
git branch -r
17

18

19

20

21
# 查看本地和远程所有分支
22

23

24

25

26
git branch -a

展开收起

收起

命令作用：

git branch：查看本地已有的分支，当前所在分支会用 \* 标记；
\-r：查看远程仓库的所有分支；
\-a：查看本地和远程的所有分支（远程分支会显示为 remotes/origin/分支名）。

6. 切换/创建分支（多人协作核心）#

多人协作时，建议每人在自己的分支上开发，避免直接修改默认分支（main/master），开发完成后再合并到默认分支。

Terminal window展开

1
# 1. 创建新分支（并切换到该分支，最常用）
2

3

4

5

6
git checkout -b 分支名（如：git checkout -b develop）
7

8

9

10

11

12

13

14

15

16

17
# 等价于以下两条命令：
18

19

20

21

22
# git branch 分支名（创建分支）
23

24

25

26

27
# git checkout 分支名（切换到该分支）
28

29

30

31
# 2. 切换到已有的本地分支
32

33

34

35

36
git checkout 分支名（如：git checkout main）
37

38

39

40

41
# 3. 切换到远程分支（并创建本地对应分支）
42

43

44

45

46
git checkout -b 本地分支名 origin/远程分支名（如：git checkout -b develop origin/develop）

展开收起

展开

命令作用详解：

git checkout \-b 分支名：一次性完成“创建分支+切换分支”，高效便捷；
分支命名建议：按功能命名（如 feature/login，表示登录功能分支）、按bug修复命名（如 fix/banner\-bug），便于区分。

7. 合并分支（将开发分支的代码合并到默认分支）#

适用于：在开发分支（如 develop）完成开发后，将代码合并到默认分支（如 main），让修改生效。

Terminal window

1
# 1. 先切换到要合并到的目标分支（如 main 分支）
2

3

4

5

6
git checkout main
7

8

9

10

11
# 2. 合并开发分支（如 develop 分支）到当前分支（main）
12

13

14

15

16
git merge develop

展开收起

命令作用：将指定分支（如 develop）的所有修改，合并到当前所在的分支（如 main），合并后，main 分支就包含了 develop 分支的所有代码。

注意：合并时可能会出现代码冲突（如两个人同时修改了同一个文件的同一行），此时需要手动解决冲突：

执行 git merge 后，Git 会提示“冲突文件”；
打开冲突文件，找到标记冲突的地方（用 \<\<\<\<\<\<\<、=======、\>\>\>\>\>\>\> 标记）；
修改冲突内容（保留需要的代码，删除冲突标记）；
执行 git add \. 和 git commit \-m \&\#34;解决合并冲突\&\#34;，完成合并。

8. 删除分支（分支开发完成后）#

Terminal window收起

1
# 删除本地分支（分支已合并到主分支，可安全删除）
2

3

4

5

6
git branch -d 分支名（如：git branch -d develop）
7

8

9

10

11

12

13
# 强制删除本地分支（分支未合并，强行删除，谨慎使用）
14

15

16

17

18
git branch -D 分支名
19

20

21

22

23

24

25

26

27

28

29
# 删除远程分支
30

31

32

33

34
git push origin --delete 分支名（如：git push origin --delete develop）

展开收起

收起

命令作用：删除无用的分支，保持分支结构清晰，避免混乱。

五、常用补充命令（高频实用）#

Terminal window展开

1
# 1. 查看当前分支的提交差异（对比工作区和暂存区）
2

3

4

5

6
git diff
7

8

9
# 2. 查看暂存区和本地版本库的差异
10

11

12

13

14
git diff --cached
15

16

17

18

19
# 3. 查看两个分支之间的差异
20

21

22

23

24
git diff 分支1 分支2（如：git diff main develop）
25

26

27

28

29

30

31

32

33

34

35
# 4. 暂存当前修改，切换到其他分支（临时切换分支，不提交当前修改）
36

37

38

39

40
git stash  # 暂存当前修改
41

42

43

44

45
git stash pop  # 恢复暂存的修改（恢复后，暂存记录删除）
46

47

48

49

50
git stash list  # 查看所有暂存记录
51

52

53

54

55

56

57

58

59

60

61
# 5. 重命名本地分支
62

63

64

65

66
git branch -m 旧分支名 新分支名
67

68

69

70

71

72

73

74

75

76

77
# 6. 更新远程分支列表（远程删除了分支，本地同步）
78

79

80

81

82
git fetch --prune

展开收起

展开

每个命令的作用简要说明：

git diff：快速查看修改的具体内容（哪一行被修改、新增/删除了什么）；
git stash：临时保存未提交的修改，常用于“正在开发一个功能，突然需要切换到其他分支修复bug”的场景；
git fetch \-\-prune：同步远程分支的删除操作，避免本地显示已删除的远程分支。

六、常见问题解决（新手必看）#

1. 拉取/推送代码时，提示“权限不足”#

原因：未配置正确的账号密码或 SSH 密钥。

解决方法：

若用 HTTPS 地址：重新输入正确的 GitHub/GitLab 账号密码；
若用 SSH 地址：配置 SSH 密钥（网上搜索“GitHub SSH 密钥配置”，按步骤操作即可，配置一次终身可用）。

2. 合并分支时出现代码冲突#

解决方法：按前面“合并分支”部分的步骤，手动修改冲突文件，删除冲突标记，保留需要的代码，再提交即可。

注意：冲突解决后，一定要仔细检查代码，确保没有误删有用的内容。

3. 误删本地代码/误回滚版本，如何恢复？#

解决方法：执行 git reflog，查看所有操作记录，找到误删/误回滚前的版本号，再执行git reset \-\-hard 版本号，即可恢复到该版本。

4. 推送代码时，提示“本地版本落后于远程版本”#

原因：远程仓库有别人推送的最新代码，你的本地代码不是最新的，无法直接推送。

解决方法：先执行 git pull 拉取远程最新代码，解决冲突后，再执行 git push。

七、总结（核心流程梳理）#

Git 的核心操作围绕“本地仓库”和“远程仓库”展开，新手记住以下流程即可快速上手：

前期准备：安装 Git → 配置用户名和邮箱；
本地开发：初始化仓库（git init）→ 修改文件 → 提交到暂存区（git add .）→ 提交到本地版本库（git commit -m “说明”）；
多人协作：克隆远程仓库（git clone）→ 拉取远程更新（git pull）→ 创建分支开发 → 推送分支到远程（git push）→ 合并分支；
问题处理：版本回滚（git reset/git revert）、解决冲突、恢复误删代码（git reflog）。

Git 命令看似多，但常用的只有十几个，多练习几次（比如新建一个测试项目，反复执行 add、commit、push、pull 等操作），就能熟练掌握。记住：所有命令的核心都是“跟踪版本、同步代码”，理解每个命令的作用，比死记硬背更重要。

上传失败

Mon, 04 May 2026 00:00:00 GMT

💡 建议操作流#

问题原因#

连接超时：网络问题，连不上 GitHub 443 端口
提示输入用户名：你用的是 HTTPS 方式，现在 GitHub 已经不支持密码登录了

一步到位解决方案（最简单）#

1. 先把远程仓库改成 SSH（彻底解决权限 + 网络问题）#

运行这条命令：

运行

1
git remote set-url origin git@github.com:yzg011/astro.git

2. 再推送#

运行

1
git push -u origin main

上传指令

Mon, 04 May 2026 00:00:00 GMT

💡 建议操作流#

对于 Astro 项目首次上传，标准流程如下：

1
# 1. 确保所有文件被添加
2
git add .
3

4
# 2. 提交变更（如果有变更）
5
git commit -m "Initial commit"
6

7
# 3. 重命名分支为 main（与 GitHub 默认一致）
8
git branch -M main
9

10
# 4. 推送到远程
11
git push -u origin main

刘邦与项羽：一个实用帝王与一个悲剧英雄的千年对决

Mon, 04 May 2026 00:00:00 GMT

刘邦与项羽：一个实用帝王与一个悲剧英雄的千年对决

漢

中国历史人物

刘邦 vs 项羽

#

一个实用帝王 · 一个悲剧英雄

从泗水亭长到汉朝开国皇帝
从西楚霸王到乌江自刎——

一个是含着金汤匙出生的贵族才俊，力拔山河气盖世；一个是喝酒打架没正事儿的中年农民老流氓，好吃懒做的混子。然而最终，前者成了千年传诵的悲剧英雄，后者成了缔造四百年汉朝的实用帝王。

壹

草根混子 vs 贵族才俊#

刘邦出生在江苏沛县的一个小村庄，爸妈没什么文化，连个正经名字都没给起。兄弟四个，他排行老三，干脆叫”刘季”——有排行最小的意思。打小就跟别人不一样，不爱种地干活，一天到晚斗鸡走犬，广交狐朋狗友，十里八乡谁都能跟他玩到一块儿。

连亲爹都瞧不上他，说他不如哥哥。嫂子也烦他，因为他经常把朋友叫到家里吃喝吹牛。可刘邦不在乎，反正在家也不受待见，拍拍屁股就跑去偶像张耳家里混吃混喝，脸皮厚，一住就是小半年。

刘邦

📍 沛县草根农民
🎂 48岁才开始创业
🍖 好吃懒做的混子
💡 能屈能伸实用为王

项羽

📍 楚国名将世家后代
💪 身高184，力能举鼎
⚔️ 23岁登上历史舞台
🏆 百战百胜天纵奇才

项羽则截然不同，他是含着金汤匙出生的，项家是楚国名将世家。即使后来秦国把楚国灭了，家道中落，他依然游走在上层圈子里——身高184，力能举鼎，才气过人。

✦

贰

同一个始皇帝，两种不同的心#

31岁的刘邦备考两年后考上公务员，当上了泗水亭长，相当于乡镇派出所所长。有一次去咸阳出差，正巧赶上秦始皇出巡的队伍。所有百姓官员都跪在地上，山呼万岁，刘邦也跪于其中，远远地看着那豪华威严的仪仗，不禁感慨：

”

大丈夫就应该是这样的！

—— 刘邦，向往

而远在会稽的项羽，同样也看着秦始皇庞大的船队和仪仗，却对叔叔说了完全不同的话：

”

以后我必定取而代之！

—— 项羽，复仇

一个是草根老百姓的向往羡慕，一个是秦朝让家族没落的气愤复仇。同一个背景，两种截然不同的心理，也预示着两人截然不同的命运走向。

✦

叁

40岁娶妻，48岁造反创业#

刘邦人生的转折点，是在一场饭局上。当地来了个姓吕的老头儿，附近有头有脸的人都来拜访。宴会主持人萧何通知说，凡是贺礼不到一千钱的，只能在大堂，进不了包间。刘邦心想，来都来了，肯定要近距离接触。当即大声说：

“我刘季给吕公送礼一万钱！“——实际上兜里比脸还干净，一个字儿都没有，说起谎来脸不红心不跳。

没想到吕老头会看面相，一见刘邦就觉得此人前途不可限量，宴会一结束就拉着他的手说：“我擅长面相，见过了那么多人，没有一个面相比得上您，我有个女儿，您要是还没娶媳妇儿，就让她嫁给您吧。”

40岁的刘邦以为自己听错了。这位吕老头的女儿，正是日后与武则天、慈禧并称”中国历史三大女主”的吕雉。

📅 刘邦的人生时间线

31岁 — 考上泗水亭长（相当于乡镇所长）

40岁 — 骗吃骗喝，娶了年轻貌美的媳妇吕雉

约42岁 — 押送犯人，被逼上梁山，躲进芒砀山造反

48岁 — 趁乱起兵，开启真正的创业之路

54岁 — 称帝，建立大汉王朝

✦

肆

史上最惊险的饭局——鸿门宴#

先入关中的是刘邦，而不是项羽。这让项羽大怒。谋士范增说：“这个姓刘的不能留，必成心腹大患，找机会弄死他。“两人达成一致。

消息传到刘邦耳中，他第二天一早带着100号人赶到鸿门给项羽请罪，还没走近，远远就行礼，说自己无意争风，退出咸阳就是等着项大将军来当主人。项羽是个顺毛驴，果不其然，一听这话，反而觉得对不住刘邦了，当场摆下酒宴给刘邦压惊。

⚔ 鸿门宴局中局 ⚔

项羽阵营

项羽 — 主帅（不想杀）

范增 — 谋士（要杀刘邦）

项伯 — 叔叔（暗中保护）

项庄 — 舞剑刺客（未果）

刘邦阵营

刘邦 — 主角（能屈能伸）

张良 — 谋士（运筹帷幄）

樊哙 — 武将（闯帐解围）

刘邦 — 借口上厕所逃走

范增精心策划的暗杀在项伯和樊哙的干扰下彻底失败。樊哙闯入大帐后说的话才是真正的转折点：先给刘邦戴高帽，再给项羽扣上”跟秦王没什么两样”的大帽子，然后轻描淡写地说”我觉得您肯定不是那种人”。粗野武夫说出来的话竟无懈可击。

最终，刘邦借口上厕所，溜之大吉。范增气得牙痒痒：“你看吧，夺天下的一定是刘邦了，咱们这些人都要成为他的俘虏啦！”

✦

伍

韩信出山，楚汉争霸#

就在刘邦愁着如何翻盘时，一个人才跳槽来投——韩信。此前，韩信在项羽手下是个保安队长，因为太爱给领导提建议，项羽烦了，韩信就跳槽去了刘邦这个偏远小公司，直接被封为大将军。

🔥 韩信的妙计：明修栈道，暗度陈仓

表面上让你看到我不争不抢，实际上暗中行动达成目标。仅仅一年，韩信合并五路诸侯，率56万大军攻下项羽老巢彭城。

然而项羽毕竟是项羽。一听家被偷了，果断掉头，仅率3万轻骑兵就将刘邦56万大军杀得分崩离析。刘邦疯狂逃窜，逃跑路上甚至把自己的儿女踹下车……连裤衩都赔掉了。

但刘邦不愧是刘邦——在家用离间计把项羽手下唯一拿得出手的谋士范增给离间走了。公元前203年，项羽兵疲粮尽，被迫签下楚河汉界协议。

等项羽转身回家，刘邦撕毁协议，率军追击，在垓下将项羽十面埋伏。项羽吃了人生中第一次败仗。

✦

陆

霸王别姬，乌江自刎#

这天夜里，黑暗中突然从四面八方传来楚国的歌声——四面楚歌。

此时的项羽睡不着，在大帐中喝着闷酒，看着身边虞姬美丽的脸庞，又看看自己穷途末路的处境，放声悲歌——

“力拔山兮气盖世，时不利兮骓不逝。
骓不逝兮可奈何，虞兮虞兮奈若何！”

虞姬泪流满面，举剑自刎。

随后，项羽翻身上马，带着800骑兵杀出重围。逃到乌江时，身边仅剩28骑。乌江亭长划着小船等候，说”大王，回江东还有机会”。

项羽摇头说：“当年我带着八千子弟出来打天下，现在只剩我一人，还有何颜面见江东父老？”

他笑着拒绝了渡江，转身面对追兵，拔剑自刎于乌江江畔。年仅31岁。

整本《史记》中，这是项羽第一次，也是最后一次笑。八千子弟兵无一生还，他做不到，也没法交代。宁可站着死，绝不跪着生。

✦

柒

刘邦最大的本事：用人#

称帝后，刘邦环顾手下的兄弟们，不禁感慨——这是一支多么草根的创业团队啊：

樊哙 · 武阳侯

老家卖狗肉的
→ 最勇猛的先锋

夏侯婴 · 汝阴侯

县长的车夫
→ 多次救主的司机

萧何 · 赞侯

老家同事
→ 最强后勤HR

曹参 · 平阳侯

老家监狱长
→ 开国功臣

韩信 · 楚王

项羽的保安队长
→ 兵仙，战神

张良 · 留侯

韩国落魄贵族
→ 最信任的谋士

这是时势造英雄，更是刘邦有容人之量，用人不疑。一个卖狗肉的、一个车夫、一个监狱长、一个吹唢呐的……他把这些人用成了开国功勋。

✦

终

人生，从来没有太晚的开始#

关于项羽

你是史记中唯一一个不是帝王却被写入本纪的人。巨鹿之战，5万对40万，胜；彭城之战，3万对56万，胜。垓下一战，他们集结全明星阵容对你十面埋伏，还不敢硬上，只能用四面楚歌攻心。

有人说你要面子——可面对从小长大的地方，面对父老乡亲，又有几个人不想有个体面？你只是不想再连累江东的父兄了。宁可站着死，绝不跪着生。

生当作人杰，
死亦为鬼雄。

—— 李清照

关于刘邦

一般人40岁就信命了，而你40岁骗吃骗喝娶了老婆，48岁开始创业，7年时间先灭强秦，再灭项羽，54岁称帝。

你是历史上从平民到帝王的第一人，王侯将相宁有种乎的真正践行者。就连后世都说：大丈夫当如是。

历史或许不会重复，但人性的规律永存。

有人少年得志，有人大器晚成，
人生从来没有太晚的开始。

年龄，又能说明什么呢？

中国历史文化人物

在历史中寻找力量，在人物中看见自己

安装指令

Mon, 04 May 2026 00:00:00 GMT

🚀 快速开始#

环境要求#

Node.js ≥ 22
pnpm ≥ 9

本地开发部署#

克隆仓库：

1
git clone https://github.com/Cuteleaf/Firefly.git
2
cd Firefly

先 Fork 到自己仓库在克隆（推荐），记得先点 Star 在 Fork 哦！

1
git clone https://github.com/yzg011/astro.git
2
cd astro

安装依赖：

1
# 如果没有安装 pnpm，先安装
2
npm install -g pnpm
3

4
# 安装项目依赖
5
pnpm install

配置博客：
- 编辑 src/config/ 目录下的配置文件自定义博客设置
启动开发服务器：
```
1
pnpm dev
```
博客将在 http://localhost:4321 可用

平台托管部署#

参考官方指南将博客部署至 Vercel, Netlify, Cloudflare Pages, EdgeOne Pages 等。
Vercel、Netlify 等主流平台自动部署，会根据环境自动选择适配器。

框架预设： Astro

根目录： ./

输出目录： dist

构建命令： pnpm run build

安装命令： pnpm install

Deploy with Vercel

Deploy to Netlify

📖 配置说明#

📚 详细配置文档: 查看 Firefly使用文档获取完整的配置指南

设置网站语言#

要设置博客的默认语言，请编辑 src/config/siteConfig.ts 文件：

1
// 定义站点语言
2
const SITE_LANG = "zh_CN";

支持的语言代码：

zh_CN - 简体中文
zh_TW - 繁体中文
en - 英文
ja - 日文
ru - 俄文

配置文件结构#

1
src/
2
├── config/
3
│   ├── index.ts              # 配置索引文件
4
│   ├── siteConfig.ts         # 站点基础配置
5
│   ├── backgroundWallpaper.ts # 背景壁纸配置
6
│   ├── profileConfig.ts      # 用户资料配置
7
│   ├── commentConfig.ts      # 评论系统配置
8
│   ├── announcementConfig.ts # 公告配置
9
│   ├── licenseConfig.ts      # 许可证配置
10
│   ├── footerConfig.ts       # 页脚配置
11
│   ├── FooterConfig.html     # 页脚HTML内容
12
│   ├── expressiveCodeConfig.ts # 代码高亮配置
13
│   ├── sakuraConfig.ts       # 樱花特效配置
14
│   ├── fontConfig.ts         # 字体配置
15
│   ├── sidebarConfig.ts      # 侧边栏布局配置
16
│   ├── navBarConfig.ts       # 导航栏配置
17
│   ├── musicConfig.ts        # 音乐播放器配置
18
│   ├── pioConfig.ts          # 看板娘配置
19
│   ├── adConfig.ts           # 广告配置
20
│   ├── friendsConfig.ts      # 友链配置
21
│   ├── galleryConfig.ts      # 相册配置
22
│   ├── sponsorConfig.ts      # 赞助配置
23
│   └── coverImageConfig.ts  # 文章封面图配置

展开收起

⚙️ 文章 Frontmatter#

1
---
2
title: My First Blog Post
3
published: 2023-09-09
4
description: This is the first post of my new Astro blog.
5
image: ./cover.jpg  # 或使用 "api" 来启用随机封面图
6
tags: [Foo, Bar]
7
category: Front-end
8
draft: false
9
lang: zh-CN      # 仅当文章语言与 `siteConfig.ts` 中的网站语言不同时需要设置
10
pinned: false    # 置顶
11
comment: true    # 是否允许评论
12
---

🧩 Markdown 扩展语法#

除了 Astro 默认支持的 GitHub Flavored Markdown 之外，还包含了一些额外的 Markdown 功能：

提醒块（Admonitions） - 支持 GitHub, Obsidian, VitePress 三种风格主题配置 (预览和用法)
GitHub 仓库卡片 (预览和用法)
基于 Expressive Code 的增强代码块 (预览 / 文档)

🧞 指令#

下列指令均需要在项目根目录执行：

Command	Action
`pnpm install`	安装依赖
`pnpm dev`	在 `localhost:4321` 启动本地开发服务器
`pnpm build`	构建网站至 `./dist/`
`pnpm preview`	本地预览已构建的网站
`pnpm check`	检查代码中的错误
`pnpm format`	使用Biome格式化您的代码
`pnpm new-post <filename>`	创建新文章
`pnpm astro ...`	执行 `astro add`, `astro check` 等指令
`pnpm astro --help`	显示 Astro CLI 帮助

64岁抬棺西征，保全166万国土——晚清对外唯一胜仗

Mon, 04 May 2026 00:00:00 GMT

#64岁抬棺西征，保全166万国土——晚清对外唯一胜仗

◆ ◇ ◆

64岁抬棺西征

#

保全166万国土，晚清对外唯一胜仗

左宗棠 · 新疆收复战 · 1876—1881

“中国的土地，一点都不能少。”

—— 左宗棠

壹

朝堂之争：弃与守的抉择

1875年，大清王朝风雨飘摇，列强环伺，割地赔款已成家常便饭。就在这内忧外患之际，朝堂之上爆发了一场关乎国家命运的大辩论。

李鸿章

新疆乃不毛之地
不要就不要了
当务之急是东南沿海

左宗棠

166万平方公里
一点都不能少！
再不收复将彻底失去

新疆的地域位置极其特殊——它不仅是丝绸之路的重要通道，更与八个国家接壤。新疆一丢，中国的门户大开，列强便可俯冲而下，不但西北无险可守，东南沿海也将被趁机瓜分。

⚠️ 新疆一丢 → 门户大开 → 列强俯冲而下 → 西北无险可守 → 东南被瓜分

✦ ✦ ✦

贰

群狼环伺：新疆的危局

当时的清王朝，哪一个列强都想上来踩一脚、分一杯羹。日本入侵台湾，各地动荡不安。新疆更是乱成了一锅粥——五人自立为王，其中喀什引狼入室，从中亚请来了外援阿古柏。

阿古柏逐步吞并各方势力，眼看整个新疆都将落入其囊中。就在此时，有人急眼了——但急眼的不是清政府，而是俄国和英国。

🇷🇺 英俄博弈 🇬🇧

🇷🇺 沙俄 — 趁乱侵占了伊犁20多万平方公里，稳坐钓鱼台

⇅

🇬🇧 英国 — 担心沙俄威胁英属印度，主动联络阿古柏，签订英阿条约，给予军事支援

⇅

🇬🇧 暗中搞鬼 — 英国使者偷偷找到李鸿章，推动”放弃新疆”的主张

英国的算盘打得很精——阿古柏比清政府更好掌控。与其让中国收复新疆，不如扶植一个听话的傀儡。

✦ ✦ ✦

叁

力挽狂澜：万言书与朝堂辩论

左宗棠急了。他做了两件事：

写万言书，详细论述新疆对朝廷的战略重要性

朝堂辩论，当塞防与海防吵成一锅粥时，他力主二者同等重要、可以兼顾

“塞防与海防二者同等重要，可以两头兼顾。这并非难事。”

——左宗棠朝堂发言

在他有理有据的论证下，清政府最终投票给左宗棠，任命他为钦差大臣，收复新疆。

✦ ✦ ✦

肆

三大难题与绝妙破局

收复新疆不是过过嘴瘾，三大难题横亘眼前：钱少、兵器少、地方远。左宗棠仔细分析局势，定下八字方针——

先北后南

缓进急攻

先北后南：阿古柏主要势力在南疆，先取北疆，以攻为守，稳中求胜。

缓进急攻：军费有限，准备必须充分，一旦开战则速战速决。

三大难题 · 三大破解

💰 钱少 → 胡雪岩担保，贷款2000万两

慈禧只给了一点路费都不够的钱，左宗棠通过红顶商人胡雪岩向国外银行贷款，凑齐军费

🔫 兵器少 → 自建兵工厂

设立西安机器局和兰州制造局，专门制造洋枪洋炮

🌾 粮草远 → 利用英俄矛盾

最绝的一招——向俄国人买粮食！沙俄巴不得左宗棠和阿古柏打得越激烈越好，好坐收渔利

✦ ✦ ✦

伍

抬棺西征：64岁的铁血壮歌

1876年

西征军六七万人向西而去

64岁的左宗棠，抬着棺材，披挂上阵

他年纪大了，背是佝偻着的，

但那一刻——

军队的脊梁却是挺着的。

这是何等的悲壮。

⏱ 西征战绩

不到三个月

收复除伊犁以外的北疆

冬天来临

果断停兵，养精蓄锐，不为战而战

来年春天

南疆之战，对方溃不成军

仅一年半

收复除伊犁以外全部新疆 ✅

去过新疆的人就知道，从北疆到南疆，开着越野车都需要花费大量时间，更何况是那个年代？这就是一个奇迹。

✦ ✦ ✦

陆

铁骨铮铮：怒怼英国，再战伊犁

冬季休战期间，英国不断向清政府试探，企图让阿古柏作为属国而存在。清廷内部妥协之声渐起。

“英国人为什么不在印度或者你们自己的国家割让一块领土给阿古柏建国？怎么非得让中国割让领土？”

“再遇到英国人来交涉，直接让他来找我。”

左宗棠对英国战略图谋的精准分析，铿锵有力的言辞表达，就像风雨飘摇中的定海神针——多么有安全感的存在。

✦ ✦ ✦

柒

再抬棺：68岁血战伊犁

收复新疆后，伊犁仍在俄国人手中。清政府派人去谈判，竟签下屈辱条约——不但没收回伊犁，反而赔偿俄国280万两白银！

伊犁本属大清 → 条约竟赔280万两 → 左宗棠怒不可遏！

他迅速从愤怒中冷静下来，准备武力收复伊犁。1880年，68岁的左宗棠再次抬棺，摆出血战到底的架势，一路北上。

沙俄急了，派军舰恐吓清政府。左宗棠却看得透彻：“他们就是虚张声势，不敢怎样的。“谈判中果然如此——连年战争让沙俄内伤严重，而西征军展现出的现代化武器实力更让俄人胆寒。

1881年

中俄伊犁条约

伊犁主权正式归还中国 🇨🇳

这是俄国立国以来不曾有过的事情——破天荒的第一次

✦ ✦ ✦

捌

故土新归：新疆建省

1882年，左宗棠提出在新疆建省。清政府于1884年11月17日正式批准。

旧称

西域

⬇

新名 · 因”故土新归”而得名

新疆

1/6

占中国领土

4个

面积堪比法国

8国

接壤邻国

新疆并非什么贫瘠之地。这里物产丰富，土地宽阔，对国家的经济发展和战略布局有着举足轻重的地位。

◆ ◇ ◆

左宗棠

自李世民以来对中国领土贡献最大的人物

晚清最后一块硬骨头 · 纯爷们儿

💭 设想一下

如果当年听了李鸿章的话——我们现在去新疆，都得办护照才行。

完

铭记历史 · 致敬先贤

本文内容整理自历史资料

张居正：一根燃烧自己的脊梁

Mon, 04 May 2026 00:00:00 GMT

张居正#

一根燃烧自己的脊梁#

他改造了一个腐朽的帝国，却被那个帝国彻底清算。
他是中国历史上最孤独的改革者。

张居正被称为「明朝第一政治家」。论给王朝续命，郭子仪续了唐朝150年，于谦续了大明110年，他的60年并不是最多的。那他究竟凭什么封神？

一

他挑战的，是千年的摸鱼文化#

张居正之所以成为历代改革者的图腾，核心在于他做了一件极度反人性、甚至反体制的事：

他在一个以道德为核心驱动的文官系统里，强行植入了一套以数据和效率为核心的 KPI 考核系统。

他挑战的不仅仅是贪官污吏，他挑战的是中国古代儒家官场上千年来的摸鱼文化和伪君子生态。

咱们今天要聊的，就是这场被称作「万历中兴」背后的
系统重构与人性陷阱。

✦

二

隆庆留下的，是一个瘫痪的帝国#

隆庆皇帝驾崩，留给张居正的并不是烽火连天，而是一种更可怕的状态——

瘫　痪

朝廷发出的命令，出了皇宫就是一张废纸。
地方收上来的税银进了国库全是赤字。
满朝文武最擅长的只有两件事：踢皮球和打嘴炮。

这种政令不通、上下脱节的死寂，比真正的战争更难对付，因为看不见敌人，却能让帝国窒息而死。

按照官场的生存算法，摆在张居正面前有一条最优解：像老师徐阶那样做一个太极宗师——多磕头少说话，谁都不得罪，把皇帝哄开心，把同僚哄舒服，哪怕大明再烂，混个几十年不成问题，还能博得生前身后名。

但身处最高处的责任感，让他根本无法装睡。财政赤字就像一个巨大的黑洞，一旦农民起义的临界点被突破，大明就会像积木一样垮塌。于是他决定：不做受人爱戴的形象，要做令人畏惧的独裁者。

✦

三

考成法：给大明安装企业级 KPI#

在张居正之前，官员的好坏怎么评定？靠口碑，靠道德，靠文章写得漂不漂亮——这玩意太虚了，全是主观操作空间。

张居正不管这一套。他发明了**「三本账」**：

📋

政令立项时

登记一本
明确事项与期限

🏛️

执行衙门

留一本
随时核查进度

⚖️

监察机构

留一本
专司考核问责

规则只有一条：到了日子，事儿没办成——不管你道德多高尚，不管你文章多锦绣，直接降级、撤职。

一夜之间，大明官场画风突变。那些习惯了喝茶、看报、高谈阔论的士大夫们，突然发现自己变成了大厂里的螺丝钉，每天一睁眼就是数据进度条，结案率变成了流水线，首辅变成了监工。

📜 史料记载

「考成法实行没多久，但是朝令夕行，以前几年办不成的事，现在几天就办完了。」

为什么？因为恐惧。张居正剥离了官员身上那层道德光环，直接把他们还原成了行政工具。他要告诉所有人：别跟我谈情怀，我只要结果。

✦

四

一条鞭法：打通帝国的金融接口#

一条鞭法实施之前，老百姓交税简直是噩梦：交粮、交布、还要去给官府当免费劳动力。汇率换算、中间商盘剥，能把一个中产之家直接搞破产，而且数据极其混乱，国家根本不知道自己有多少家底。

张居正下令：把所有的田赋、徭役、杂税全部折算成银两。

改革前

实物征税，种类繁杂
中间商层层盘剥
农民被随意拉去当苦力
国家账目一塌糊涂

改革后

全部折银，清晰透明
贪官上下其手空间压缩
农民只需种地卖钱交银
帝国完成赋税货币化

为推行一条鞭法，张居正还搞了清丈田亩——大明朝的人口普查加资产审计。这一查，查出了整整 3亿亩 的隐形土地。这些地都是皇亲国戚、豪门大户偷偷藏起来不交税的。

张居正是从既得利益集团的嘴里
硬生生把肉抠出来喂给了国库。

太仓的粮食，哪怕吃到腐烂都吃不完。但他也因此彻底得罪了全天下的读书人和权贵——从此以后，张居正不再是他们的宰相，而是夺人钱财的**「独夫民贼」**。

✦

五

夺情风波：在名节与国运之间选择#

万历五年，张居正的父亲去世。按照封建礼教，官员必须辞职回家守孝三年，这叫「丁忧」，是天大的规矩，是孝道的底线。

保守派们兴奋了。他们像闻到血腥味的鲨鱼一样围了上来——并不是真的在乎孝道，他们在乎的是：只要把张居正赶回家三年，所有改革就能立马废除，大家又能回到那个舒服的日子。

地狱级抉择

回家守孝

保全名节
改革前功尽弃

留任夺情

保住改革
被全天下骂作衣冠禽兽

最终，在个人名节与帝国国运之间，张居正选择了后者。他穿着黑色的孝服走进了内阁，继续高压批阅奏章。面对满朝文武的唾沫星子，面对学生们的倒戈，他仍不为所动，直接祭出雷霆万钧的镇压手段——停谏言、流放反对派，用铁腕意志压制了一切杂音。

「无非相乃摄也」

如果你叫我当这个家，我就要负责到底，
哪怕粉身碎骨，在所不惜。

✦

六

他知道自己是在为帝国燃烧#

张居正就像一个疯狂的火车司机，把刹车焊死，还要往炉子里疯狂铲煤——只为了让这列破火车冲过即将到来的悬崖。他把所有的权力、威望，甚至自己的道德评价，都当成了改革的燃料。

万历十年，张居正积劳成疾，死在岗位上，享年 58岁。

他以为自己为大明留下了万世基业。结果他前脚刚死，那个被他从小教育长大的万历皇帝就露出了獠牙。

万历皇帝的清算清单

抄家夺爵

长子自杀，家属饿死

差点开棺鞭尸

考成法被废除，官员欢呼雀跃，终于又可以摸鱼了

这不只是万历的报复，更是整个官僚系统的反扑。**张居正想用法家的手段去改造一个儒家的底盘，这本身就是一场注定失败的基因工程。**他活着，靠的是皇权特许的威慑力；他死了，这种威慑力瞬间反噬。

讽刺的是，万历皇帝把张居正斗倒斗臭，却始终舍不得废除一条鞭法。因为真香——国库里的银子是实打实的。万历 48 年不上朝，大明没垮，靠的就是张居正留下的这点老本。

✦

尾

孤独的守夜人#

回望四百多年前那个背影，他是一个彻头彻尾的悲剧英雄——像一个孤独的守夜人，在漫长的黑夜里点燃了自己的骨头，试图照亮这个庞大而陈旧的帝国。

一个没有制度保障、纯粹依赖强人意志的改革，注定只是一道短暂的光。

但即便如此，只要那个代表着家国担当的图腾还在

「虽千万人，吾往矣」

张居正这个名字，就永远是中国历史上
最硬的一根脊梁。

敢于在腐朽的惯性中逆流而上，敢于在必死的绝境里力挽狂澜，
这才是张居正被称为**「宰相之杰」**的真正原因。

喜欢这篇文章？欢迎在抖音APP点击右下角的**「推荐」大拇指按钮**

让更多人看见这段历史 ↑

历史解读系列

开窍的最快方式，就是多看历史

千古第一才女李清照

Mon, 04 May 2026 00:00:00 GMT

李清照#

千古第一才女 · 婉约词宗

“生当作人杰，死亦为鬼雄”
——一个灵魂比时代更强大的女子

在中国漫长的文学史上，有一位女子，她的名字穿越近千年时光，依然熠熠生辉。她出身名门，才华绝代；她敢爱敢恨，活得热烈而真实。她就是李清照——中国历史上最伟大的女词人，被誉为”千古第一才女""婉约词宗”。

然而，她的人生远非”婉约”二字可以概括。她打牌喝酒、逢赌必赢，她写词怼遍文坛、狂傲不羁，她在国破家亡之际写下豪气干云的诗篇，在遭遇家暴时毅然状告丈夫离婚。她是一个活生生的人，有血有肉、敢怒敢言。

✦ ✦ ✦

壹

名门闺秀 · 天赋异禀#

公元1084年 — 少年时期（汴京）

🌸

少女李清照：藕花深处的灵秀少女

投胎是个技术活，而李清照在这方面多少是有些天赋在身上的。

她的父亲李格非，是苏轼的学生，官至礼部郎中，学识渊博；生母是宰相王珪的女儿，系出名门；继母更是状元拱辰的孙女。这样的家庭背景意味着什么？意味着家里来往的叔叔大爷们，不是苏轼就是黄庭坚这样的人物。可以说，半个北宋文坛都是她的启蒙老师。

更重要的是，父亲的家教非常开明。在那个”女子无才便是德”的年代，李格非从不拿三从四德这些条条框框约束女儿。他给女儿取名”清照”，取自王维的诗句”明月松间照，清泉石上流”，寓意女儿一生如月光般明亮清澈、如泉水般自由流淌。他希望女儿快乐、无拘无束地活着。

而李清照，也完全没有辜负父亲的期望。

🍶

爱喝酒

别的小姑娘品茶，她咕咚咕咚灌酒

🎲

爱赌博

别人绣花她摇色子，还写《打马图经》

⛵

爱划船

出门不带扇子遮面，挽起袖子就划船

那是一个寻常的日子，十五六岁的李清照和朋友们出去游玩，喝得兴高采烈，划着船晃晃悠悠就滑到了藕花深处。一抬头——**这是哪儿啊？**只见天空中被惊飞的鸥鹭扑棱棱四散而去，少女迷迷瞪瞪又带着几分醉意，随口吟出：

《如梦令》

常记溪亭日暮，沉醉不知归路。

兴尽晚回舟，误入藕花深处。

争渡，争渡，

惊起一滩鸥鹭。

这首小词一出，整个北宋文坛都被惊到了

大伙儿纷纷打听：这写得如此灵动的小词，是谁家的姑娘？可这才哪到哪儿啊，小娘子还没发力呢。

又一个清晨，李清照顶着宿醉的迷糊劲儿，趴在床边扶着太阳穴。依稀记得昨晚又是风雨交加，便担心地问丫鬟：“院子里的海棠花怎么样了？“丫鬟正忙着干活，哪有闲心赏花，随口回了一句：“还跟昨天一样呗。”

李清照撇了撇嘴：怎么可能一样呢？你知不知道——

《如梦令·昨夜雨疏风骤》

昨夜雨疏风骤，浓睡不消残酒。

试问卷帘人，却道海棠依旧。

知否，知否？

应是绿肥红瘦。

“肥”与”瘦”形容花朵——此前从未有人这样写过！

这一次，李清照的名字瞬间冲上了汴京城的热搜榜。人人都知道老李家有个才华横溢、待字闺中的天才少女。说媒的、提亲的乌泱乌泱往李家跑，门槛都快被踏平了。

❀ ❀ ❀

贰

琴瑟和鸣 · 灵魂伴侣#

公元1101年 — 青州隐居十四年

💕

秋千初遇：一眼万年的怦然心动

那些蜂拥而至的追求者中，有一个年轻人名叫赵明诚。他的父亲赵挺之曾做过李格非的上司，而赵明诚虽说是标准的官二代，却丝毫没有纨绔子弟的臭毛病。年纪轻轻就在收藏界小有名号，被称为”金石才子”，彼时还在太学读书，毕业后就是妥妥的公务员。

一次偶然的机会，赵明诚读到了李清照的词。**从此一发不可收拾——这世上怎么会有如此惊才绝艳的女子？**虽然还没见过面，不知道她是高是矮、是美是丑，但在他的心里，李清照已经是偶像女神级别的人物了。

”

蹴罢秋千，起来慵整纤纤手。露浓花瘦，薄汗轻衣透。
见客入来，袜刬金钗溜。和羞走，倚门回首，却把青梅嗅。

——《点绛唇》| 秋千架旁，假装嗅梅的偷望

偶遇是谈恋爱最经典的套路。一天，李清照正在院子里荡秋千，微风吹动着少女飘逸的纱衣，正玩得开心呢，瞥见父亲和一位风度翩翩的年轻公子走过来。**不好，有帅哥！今天没化妆！**于是匆忙躲避，却又忍不住想多看两眼，便假装嗅着青梅，来了一次饱含深情的偷望。

赵明成心里也滋啦滋啦通上了电——**糟了，是心动的感觉。**下定决心：非她不娶！

可赵父听了却犯了难。两家虽说门当户对，但政治立场不同——赵家支持王安石的新党，李家支持苏轼的旧党。不过架不住儿子软磨硬泡，两家又是山东老乡，也都不是什么大人物。算了，成全孩子吧。

公元1101年

21岁的赵明诚迎娶心目中的女神，两人喜结连理

婚后日常

赵明诚挑最美的花送给妻子，问她：“是我好看还是花好看？”

每月初一十五

太学生赵明诚放假回家，先去当铺当衣服换钱买文物古籍

🍵

赌书泼茶：人间最浪漫的夫妻游戏

结婚后，小两口撒起了狗粮。白天赵明诚送花，李清照戴在头上撒娇问：“是我好看还是花好看？“热恋期的赵明诚哪还看得见光瞅着媳妇傻乐——当然是你最好看。

到了晚上，李清照洗了澡，穿一身薄纱画个淡妆，趴在凉席上冲丈夫抛媚眼：“今晚这凉席真舒服，你要不要来试一试呀？“这样直白露骨的表达，在当时实在太大胆放肆了，没少招人说闲话。

好在赵明诚不仅尊重妻子，还是个暖男。李清照写词，他不但不拦着，反而欣赏她、支持她，让她痛痛快快做自己。

赵明诚喜欢文物收藏，研究金石学——从古至今都是个烧钱的爱好。李清照不但没埋怨，反而把漂亮衣服、值钱首饰当了换钱来支持丈夫：**老公，没事儿，赶紧买吧！有钱难买心头好。**娶个明事理的媳妇不难，但要娶一个既懂生活情趣又能一起搞事业的伴侣，打着灯笼都难找。

”

人生难得一知己，更何况这知己还是心上人、眼前人、枕边人。她爱你所爱，陪你哭，陪你笑。即使没有豪宅，即使生活清贫，在他们眼里，这就是天底下最好的爱情。

有一次，他们相中了一幅南唐名画《牡丹图》，卖家张口就要二十万钱。小两口砸锅卖铁也凑不出来，只好借回家点上蜡烛欣赏了三天三夜，然后依依不舍地还回去。回家的路上，两人抱头痛哭，一抬头看见对方哭红的眼眶，又破涕为笑。

公元1107年，因朝廷党争牵连，赵家被贬，两人迁居山东青州，开始了长达14年的隐居生活。

不用上班的日子里，这对文艺小青年一个写词作画，一个研究金石收藏——身边是深爱的人，手里是热爱的事，彼此自由自在。再也没有比这更好的日子了。

《减字木兰花》

卖花担上，买得一枝春欲放。

泪染轻匀，犹带彤霞晓露痕。

怕郎猜道，奴面不如花面好。

云鬓斜簪，徒要教郎比并看。

“是我好看还是花好看？“——每个恋爱中的女孩都问过的问题

也是在这段时间，25岁的李清照创作了著名的《词论》，大胆点评欧阳修、苏轼、秦观、黄庭坚等文坛泰斗，第一次将诗与词彻底区分开来。丈夫问她谁的词最好，她随手捻起一支桂花：

《鹧鸪天·桂花》

暗淡轻黄体性柔，情疏迹远只香留。

何须浅碧深红色，自是花中第一流。

“何须浅碧深红色，自是花中第一流。” ——就是我呀！

闲暇时，夫妻俩发明了一种有趣的游戏——“赌书泼茶”：在书房里煮一壶新茶，翻一本旧书，说一个典故让对方猜在第几页。猜对了可以喝茶，猜错了——对不起，不但没茶喝，还得负责洗碗做饭！

太学高材生赵明诚自认为读书很有一套，结果每次都输给李清照，一晚上连一口茶都没喝到。李清照举杯大笑，茶水不小心被打翻洒了一身……夫妻俩打打闹闹，反而觉得更有意思。

**赌书消得泼茶香，当时只道是寻常。**青州的14年，大概是他们一生中最安逸满足的时光了。

🌙 🌙 🌙

叁

风云变幻 · 聚少离多#

公元1121年 — 重阳佳节寄相思

公元1121年春天，好消息传来——赵明诚被朝廷重新启用，任命为莱州郡守（相当于今天的市长）。可家里十几屋子的文物古董需要照看，加上两地相隔不远，李清照便独自留在了青州。

异地恋是考验人的事。平时还好，一到阖家团圆的日子，思念之情格外难耐。

这一年的重阳佳节，李清照独守空房，对着西风黄花，饮着苦酒，给远方的丈夫写下一首词：

《醉花阴·薄雾浓云愁永昼》

薄雾浓云愁永昼，瑞脑销金兽。

佳节又重阳，玉枕纱厨，半夜凉初透。

东篱把酒黄昏后，有暗香盈袖。

莫道不销魂，帘卷西风，人比黄花瘦。

“莫道不销魂，帘卷西风，人比黄花瘦”——千古名句

收到妻子的词，赵明诚读了一遍又一遍——写的真好啊！可怎么回复呢？这可愁坏了他。憋了整整三天，写了五十首《醉花阴》，信心满满：总有一首能比媳妇儿好吧？

可赵明诚啊，你清醒一点——这时候苏东坡已经去世了，辛弃疾还没出生，还能有谁和李清照比肩？写完之后他还专门拿给朋友看：“你最喜欢哪一首？“朋友看完来了句：**“莫道不销魂，帘卷西风，人比黄花瘦。这句实在是妙啊！“**赵明诚汗颜，发誓从此不再跟媳妇比写词。

然而，更深的裂痕正在悄然生长。作为一郡长官，身边总有温柔美人陪伴，赵明诚一度有了纳妾的想法——谁家还不养几个歌女侍妾呢？何况今年已经41岁了，还没有孩子。

在青州隐居时，两人身份平等、自由自在。但现在，赵明诚是有地位的人了，而李清照没有娘家撑腰、没有子嗣傍身。只要夫妻身份地位不平等，又异地分居，还没有孩子的维系，十有八九得出事儿。

李清照何等聪慧敏锐，即使分隔两地也感觉出了不对劲。果然，当她风尘仆仆赶到莱州团聚时，迎接她的——是眼神躲闪的丈夫，和两个年轻的妾室。

”

“别觉得我孤单，我自己在这儿挺好的。我还有两个朋友呢——一个叫子虚，一个叫乌有。” ——李清照的自嘲，字字带血。

即使心中早已有了预感，当事实摆在眼前时，李清照还是一阵恍惚。20年恩爱夫妻，抵不过外面的灯红酒绿。曾经的海誓山盟还言犹在耳，如今眼前却多了两个如花美眷。

纳妾在宋朝是常事，可这是李清照啊！她的才学和见识让她始终认为自己与丈夫是平等的。她可以从一而终，丈夫为什么不可以？这和合不合理无关——在她的婚姻世界里，很难接受第三者。

⚔️ ⚔️ ⚔️

肆

国破家亡 · 颠沛流离#

公元1127年 — 靖康之变 · 南渡逃亡

🏚️

靖康之耻：山河破碎，故土难返

相对于感情上的破裂，国家破碎的痛楚更加刻骨铭心。

公元1127年，金兵南下，靖康之变爆发。中国历史上从未有过如此狼狈的一幕——徽钦二帝被俘，北宋灭亡。国破家亡之际，先前所有的矛盾都变得微不足道了。关键时刻，老夫老妻依然是彼此最坚定的依靠。

两人分头行动：丈夫赵明诚去江宁（今南京）给母亲奔丧，后来做了江宁知府；李清照负责回青州收拾方便携带的贵重文物——那是他们辛苦积攒了20多年的心血啊。

她独自带着十五车文物，颠沛流离在战火纷飞的路上。辗转途中，一个消息传来——江宁发生兵变，赵明诚作为父母官，没有保护百姓，也没有守住城池，反而弃城逃跑了！

那时候的宋朝，从上到下逃跑已成风气。可李清照看不上这个。万万没想到，自己的丈夫也会这样。太不爷们了，丢人啊！

🌊

乌江怀古：生当作人杰，死亦为鬼雄

带着十几车文物心事重重的李清照路过乌江时，面对浩荡江水，想到了那位拔剑自刎的西楚霸王项羽。她提笔写下：

《夏日绝句》（五绝）

生当作人杰，死亦为鬼雄。

至今思项羽，不肯过江东。

句句豪迈悲壮！一个弱女子就有如此胸襟气魄！

这首诗像一记响亮的耳光抽在了那个时代所有苟且偷生者的心上。

没过多久，李清照收到了丈夫病重的消息。她心急如焚，一夜行舟三百里向丈夫奔去。可当她赶到的时候，赵明诚因为用药不当病入膏肓，已经撒手人寰。

28年的婚姻，大半生的相依为命，白头之约终成空。

”

即使夫妻之间曾有过龃龉，当面对真正的生死离别，爱总比恨浓烈。思之、悼之、悲之、痛之，李清照伤心至极，大病一场。

两人没有孩子。丈夫留下的两万多册古籍、两千多件碑刻文物——就是他们的孩子。她要帮丈夫守着他们。

可这时候的李清照已经46岁了——一个年近半百的病弱寡妇，带着十几箱珍贵文物，在兵荒马乱中……你让她怎么守？强盗、山匪、官员，甚至邻居，谁都想分一杯羹。

战火中折腾了三年，这些文物被偷的偷、抢的抢、骗的骗，所剩无几了。

💔 💔 💔

伍

再嫁渣男 · 壮士断腕#

公元1132年左右 — 49岁闪婚 · 百日离婚

疲惫、不安、孤独让两鬓斑白的李清照不堪重负，经常生病。就在这时，一个男人出现了——张汝舟，一个地方小官，温文尔雅、端汤送药、嘘寒问暖，情意绵绵地把49岁的李清照宠成了小公主。

这样的暖男似乎让她看到了赵明诚的影子。逃亡的日子实在太苦太累太孤独了，架不住暖男天天缠磨，她同意了——闪婚。

这个决定当然免不了被人指指点点：都五十岁了还二婚嫁人，真是不知羞耻！但李清照什么时候在乎过别人的眼光？

可婚姻就像一场豪赌。之前在牌桌上几乎没输过的李清照，这次——赌输了。

”

刚结婚不久，张汝舟就撕下了温良的面具。原来他从一开始接近李清照就是为了那些价值连城的文物！当知道文物所剩无几且李清照坚决不给一分一毫时，达不到目的的张汝舟对李清照实施了家暴，甚至还一度动了杀心！

“你不给我？等你死了你的东西都是我的！”

让他张汝舟也不打听打听——赵姐可不是吃素的！

李清照做出了一个惊人的决定：**离婚！**大才女结婚不到百日就要提出离婚，放到现代都是能上热搜的程度，更何况是在封建时代？！

让张汝舟主动和离？不可能，这种伪君子最会纠缠。宋朝法律规定：妻子告丈夫，即使罪名成立，自己也要坐牢两年。很多人劝她算了吧，忍忍就过去了。

但李清照是什么人？从年轻时就没弯过的腰，现在更不会折！坐牢就坐牢，这个婚我离定了！

收集证据

发现张汝舟靠弄虚作假当上官儿，一纸诉状告上公堂

案件结果

张汝舟被流放江西，据说连皇帝都惊动了

代价

李清照按律入狱九天后被亲友营救释放

走出监狱的那一刻，恍如隔世。物是人非事事休，欲语泪先流。

改嫁休夫这件事在当时成了李清照最大的污点。经过这场荒唐的婚变，本就多病缠身的她更加清瘦了。头发已经花白，脸上满是风霜，但她的眼睛依然炯炯有神，闪着寒光。

《声声慢·寻寻觅觅》

寻寻觅觅，冷冷清清，凄凄惨惨戚戚。

乍暖还寒时候，最难将息。

三杯两盏淡酒，怎敌他、晚来风急！

雁过也，正伤心，却是旧时相识。

满地黄花堆积，憔悴损，如今有谁堪摘？

守着窗儿，独自怎生得黑！

梧桐更兼细雨，到黄昏、点点滴滴。

这次第，怎一个愁字了得！

叠字开篇，字字泣血——这是她最夺目、也最令人心碎的作品

🕯️ 🕯️ 🕯️

陆

孤灯残卷 · 笔耕不辍#

晚年 — 临安岁月 · 最后的光芒

📖

晚年李清照：孤灯下整理金石录后序

晚年的李清照投靠弟弟，一直生活在临安（今杭州）。

曾经名动天下的才女会怎样老去？她回忆着自己的前半生——童年的欢愉、少年的美满、破碎的家国、凄凉的晚景。丈夫的模样有些模糊了，她热爱的金石文物大多也已遗失。

可她没有放弃。趁着记忆还没褪色，趁着手指还能活动，她要完成丈夫未竟的事业。

李清照开始回顾两人三十年来收集、整理、保护上万件金石字画的经历，写下了**《金石录后序》**。这篇文字多年后读起来依然让人潸然泪下——那是对逝去的丈夫最深情的告白，是对破碎的山河最沉痛的追忆，也是对自己一生最真实的写照。

”

《金石录后序》不仅仅是一篇学术文章，它是李清照用生命写就的爱情史诗。每一个字的背后，都是一段刻骨铭心的记忆，每一句话里，都藏着一个时代的眼泪。

七十岁那年，她遇见了一个邻家小女孩。那女孩聪颖活泼、有灵气，李清照看着她，就像看见了少女时的自己。于是她动了收徒的念头，想把自己毕生所学都交给这个小丫头。

“你要不要跟我读书写词啊？”

面对诗词大家的盛情邀请，小姑娘竟摇头拒绝了：

最后的对话

“我爹说了，写诗词不是女孩子该干的事。
您读了那么多书，又有什么用呢？”

这个问题让李清照怔住，久久无言

读书可以做官？可那是男人们的权利。

读书可以明理？可满朝文武哪个不是饱读诗书，却只求偏安一隅！

读书可以写诗词？可纵使自己这般文采风流，又怎敌它晚来风急？

✦ 终章：千古流芳 ✦#

公元1155年，72岁的李清照躺在病榻之上。弥留之际，眼前闪过的是童年在藕花深处惊起的一滩鸥鹭，是与赵明诚赌书泼茶的欢笑，是国破家亡时漫天的烽火，是乌江边那句掷地有声的”生当作人杰”……最终定格在两年前那个小姑娘疑问的眼神里。

她想告诉她：读书有用。读书便可发声。

男人由外而内构筑女性形象，而我们由内而外地表达自己——怎会一样呢？

“她用一生证明了：

才华不分性别，勇气无关年龄，

一个女人的灵魂，可以比时代更强大。”

📜 李清照生平大事记#

1084年

出生于书香门第，父亲李格非为苏轼学生

约1100年

少年成名，《如梦令》轰动汴京文坛

1101年

21岁，与赵明诚结为夫妻

1107-1121年

青州隐居14年，完成《金石录》初稿

1121年

赵明诚赴莱州，感情出现裂痕

1127年

靖康之变，北宋灭亡，南渡逃亡

1129年

赵明诚病逝，46岁成为孀妇

约1132年

49岁再嫁张汝舟，百日内状告离婚

晚年

定居临安，完成《金石录后序》

约1155年

72岁，在临安辞世

🌸 千古第一才女李清照 · 一生感动无数后人 🌸

愿每个女子都能如她一般，活得热烈、真实、无畏

一生坎坷的伟大灵魂

Mon, 04 May 2026 00:00:00 GMT

诗圣杜甫：一生坎坷的伟大灵魂

圣杜甫#

一生坎坷 · 忧国忧民 · 诗史千秋

“安得广厦千万间，大庇天下寒士俱欢颜”

在中国文学浩瀚的长河中，有这样一位诗人：他生于盛唐繁华之世，却亲历安史之乱的腥风血雨；他才华盖世、志存高远，却一生仕途坎坷、穷困潦倒；他身处泥泞之中，心中却始终装着天下苍生。他就是被后世尊为”诗圣”的伟大诗人——杜甫。他的一千五百余首诗作，如同一部用血泪书写的史诗，记录了一个王朝由盛转衰的历史巨变，也映照出一个伟大灵魂在苦难中永不熄灭的光芒。

壹

少年壮志：书香门第的璀璨起点#

公元712年 — 735年

唐睿宗先天元年（公元712年），杜甫出生于河南巩县（今河南巩义市）一个显赫的书香世家。他的祖父杜审言是初唐时期著名的诗人，官至修文馆直学士；父亲杜闲曾任奉天县令。在这样的家庭环境中，杜甫自幼便浸润在浓郁的文化氛围中，展现出惊人的天赋与对文学的热爱。

**📖 少年轶事：**据史料记载，杜甫七岁便能作诗，曾写下”凤凰鸣旭日，龙跃云汉津”这样气魄非凡的诗句。九岁时便已将大量经典诗文烂熟于心，十五岁时已在家乡文坛崭露头角，与当时的名士们诗文酬唱，被誉为”神童”。

青年时代的杜甫，意气风发，胸怀大志。他在一首回忆少年生活的诗中写道：“忆年十五心尚孩，健如黄犊走复来。庭前八月梨枣熟，一日上树能千回。“这生动描绘了他少年时代活泼好动、充满活力的形象。然而，杜甫并非只知玩耍的顽童，他更是一位有着远大抱负的读书人。“读书破万卷，下笔如有神”，这句后来成为千古名言的诗句，正是他对自己刻苦攻读生涯的真实写照。

岱宗夫如何？齐鲁青未了。

造化钟神秀，阴阳割昏晓。

荡胸生曾云，决眦入归鸟。

会当凌绝顶，一览众山小。

——《望岳》· 杜甫（二十四岁时登泰山所作）

开元十九年至二十三年（731—735年），年轻的杜甫开始了人生中的第一次远游。他漫游吴越（今江苏、浙江一带），足迹遍及江南山水之间。这次游历不仅开阔了他的眼界，也让他饱览了祖国的大好河山，为他日后的诗歌创作积累了丰富的素材和情感体验。二十岁时，他又来到当时的东都洛阳，在那里度过了四年的时光，结识了许多文人雅士，进一步提升了文学修养。

开元二十四年（736年），二十四岁的杜甫来到山东，登上五岳之首的泰山。面对巍峨雄伟的泰山，这位年轻诗人豪情万丈，挥笔写下了那首脍炙人口的《望岳》。其中”会当凌绝顶，一览众山小”两句，不仅是对泰山壮美景色的赞美，更是年轻杜甫远大志向的自我写照——他要登上人生和艺术的最高峰，俯瞰世间一切艰难险阻！

📜 少年杜甫苦读诗书 —— “读书破万卷，下笔如有神”

✦ ✦ ✦

贰

长安十年：梦想与现实的残酷碰撞#

公元735年 — 755年

开元二十三年（735年），二十四岁的杜甫第一次参加进士考试。然而，命运似乎有意要考验这位天才——他落榜了。这次失利并没有让杜甫气馁，相反，他选择继续漫游，充实自己。此后几年，他游历齐赵大地，过着”放荡齐赵间，裘马颇清狂”的生活。这一时期，他与好友李白相识，两位伟大的诗人在洛阳相遇，结下了深厚的友谊。李白比杜甫大十一岁，当时已是名满天下的大诗人，而杜甫还是一位默默无闻的后辈。但两人一见如故，携手同游梁宋一带，饮酒赋诗，畅谈理想。这段珍贵的友谊成为中国文学史上最动人的佳话之一。

**🤝 李杜之交：**天宝三载（744年），杜甫与李白在洛阳初次相见。两人一起游历梁宋（今河南商丘、开封一带）、齐鲁等地，“醉眠秋共被，携手日同行”。尽管相处时间不长，但这份真挚的友情影响了杜甫的一生，他后来写下了许多怀念李白的动人诗篇。

然而，美好的日子终究是短暂的。天宝五载（746年），三十五岁的杜甫怀着满腔热忱来到长安，希望能在政治上有所作为。他以为凭借自己的才华和家族背景，一定能够获得朝廷的重用，实现”致君尧舜上，再使风俗淳”的政治理想。但他万万没想到，这一待就是整整十年，而等待他的却是接二连三的打击与失望。

长安十年是杜甫人生中最黑暗、最痛苦的时期之一。当时的朝政已被权相李林甫把持，科举制度形同虚设。天宝六载（747年），唐玄宗下诏选拔天下贤才，杜甫满怀希望地参加，结果李林甫为了独揽大权，竟然上奏称”野无遗贤”，让所有应试者全部落榜。这对杜甫来说无疑是晴天霹雳。

747年

应诏试而落榜，李林甫以”野无遗贤”蒙蔽皇帝，杜甫的政治梦想首次遭受重创

751年

向玄宗进献《三大礼赋》，得到赏识，命待制集贤院，但仍未获实际任用

755年

四十四岁终于获得右卫率府胄曹参军的小官，负责看守兵器钥匙，俸禄微薄

在长安的漫长岁月里，杜甫的生活日益困顿。他不得不依靠亲友的接济维持生计，甚至一度寄居在大女婿家中，过着寄人篱下的生活。他曾写道：“朝扣富儿门，暮随肥马尘。残杯与冷炙，到处潜悲辛。“这几句诗真实地记录了他当年在长安四处碰壁、饱受冷眼的屈辱经历。一个曾经意气风发的才子，如今竟沦落到如此境地，其中的辛酸与无奈可想而知。

然而，正是这段痛苦的经历，使杜甫真正接触到了底层人民的生活，深刻体会到了社会的不公与黑暗。他的诗歌风格开始发生转变，从早期的浪漫主义逐渐转向现实主义。他开始关注普通人的疾苦，用自己的笔触记录社会的真相，为那些被遗忘的人发出声音。长安十年虽然摧毁了杜甫的政治梦想，但却成就了一位伟大的现实主义诗人。

✦ ✦ ✦

叁

安史之乱：家国破碎的血泪岁月#

公元755年 — 759年

天宝十四载（755年）十一月，范阳节度使安禄山起兵反唐，安史之乱爆发。这场持续八年之久的战乱彻底改变了大唐帝国的命运，也彻底改变了杜甫的人生轨迹。当时，杜甫将家人安置在鄜州（今陕西富县）的羌村，独自北上灵武投奔新即位的唐肃宗，想要为国效力。不幸的是，他在途中被叛军俘获，押解回长安。

国破山河在，城春草木深。

感时花溅泪，恨别鸟惊心。

烽火连三月，家书抵万金。

白头搔更短，浑欲不胜簪。

——《春望》· 杜甫（被囚长安时所作）

在被叛军软禁的长安城中，杜甫目睹了昔日繁华的京城沦为废墟的惨状。曾经热闹非凡的大街小巷如今杂草丛生，昔日的歌舞升平变成了断壁残垣。这种强烈的对比让杜甫心如刀绞，他含泪写下了千古绝唱《春望》。“国破山河在，城春草木深”——短短十个字，道尽了对国家命运的深切忧虑和个人身世的无限感慨。“烽火连三月，家书抵万金”则表达了对远方家人的深切思念和对和平的渴望。这首诗不仅是杜甫个人情感的抒发，更是整个民族在那个动荡年代共同心声的表达。

至德二载（757年）夏，杜甫冒险逃出长安，穿过叛军的重重封锁，历经千难万险，终于抵达凤翔（今陕西凤翔）行在所。唐肃宗对他的忠诚深感欣慰，任命他为左拾遗。这是杜甫一生中担任过的最高官职，也是他离政治理想最近的一次。然而好景不长，仅仅几个月后，因为营救房琯一事触怒肃宗，杜甫遭到贬斥，从此再未受到重用。

乾元二年（759年），杜甫辞去华州司功参军的职务，开始了更为艰辛的流亡生活。他携全家西行，先后流寓秦州（今甘肃天水）、同谷（今甘肃成县）等地。这是一段极其艰苦的旅程，一路上饥寒交迫，甚至到了靠挖掘野生植物充饥的地步。他在《秦州杂诗》中描述当时的处境：“满目悲生事，因人作远游。西征问烽火，心折此淹留。“字里行间充满了无尽的凄凉与无奈。

📜 “三吏三别”——战争最真实的写照：

在这一时期，杜甫创作了中国文学史上最杰出的现实主义组诗——“三吏”（《石壕吏》《潼关吏》《新安吏》）和”三别”（《新婚别》《垂老别》《无家别》）。这些诗歌以第一人称或第三人称的视角，深刻揭露了战争给百姓带来的深重灾难。《石壕吏》中有这样的描写：“吏呼一何怒！妇啼一何苦！“老翁逾墙走，老妇出门看。差役的凶残暴虐与百姓的无助绝望形成了强烈对比，读来令人潸然泪下。

在从华州前往秦州的途中，杜甫亲眼目睹了无数百姓因战争而家破人亡的惨剧。他在《石壕吏》中记录了一户农家在深夜遭遇差役抓丁的场景：老翁翻墙逃跑，老妇硬着头皮出门应对。最终，老妇被带走服役，留下老弱病残的一家老小相依为命。这首诗没有一句议论，只是冷静地叙述事件的经过，但其蕴含的情感力量却足以震撼每一个读者的心灵。这正是杜甫诗歌最了不起的地方——他用最朴素的语言，讲述最震撼人心的故事。

✦ ✦ ✦

肆

成都草堂：风雨中的短暂安宁#

公元759年 — 768年

乾元二年（759年）年底，在经历了漫长的颠沛流离之后，杜甫带着家人来到了成都。在这里，在朋友严武等人的帮助下，他在成都西郊浣花溪畔建起了一座简陋的茅草屋，这就是后来闻名天下的”杜甫草堂”（又称”浣花草堂”）。对于漂泊多年的杜甫来说，这间小小的草屋意味着难得的安宁与稳定。

成都时期是杜甫晚年生活中相对平静的一段时光。这里气候温和、物产丰富，远离了北方的战火硝烟。在这段时间里，杜甫创作了大量优秀的作品，《春夜喜雨》《蜀相》《客至》《江村》等名篇都是这一时期的产物。《春夜喜雨》中”好雨知时节，当春乃发生。随风潜入夜，润物细无声”几句，以细腻的笔触描绘了春夜降雨的美景，表达了诗人对自然万物生长的喜悦之情。这首诗语言清新自然，意境优美，千百年来一直深受人们的喜爱。

八月秋高风怒号，卷我屋上三重茅。

茅飞渡江洒江郊，高者挂罥长林梢，

下者飘转沉塘坳……

安得广厦千万间，

大庇天下寒士俱欢颜！

风雨不动安如山。

呜呼！

何时眼前突兀见此屋，

吾庐独破受冻死亦足！

——《茅屋为秋风所破歌》· 节选

然而，即便是在这短暂的安宁时刻，杜甫依然无法忘记天下苍生的疾苦。上元二年（761年）秋天的一个夜晚，狂风骤起，吹破了杜甫草堂的屋顶。大雨倾盆而下，漏得屋里没有一块干燥的地方。全家人蜷缩在被雨水打湿的被褥里，瑟瑟发抖。面对这样的困境，普通人可能会怨天尤人或哀叹自己的不幸，但杜甫想到的却是普天下所有像自己一样遭受苦难的人。

“安得广厦千万间，大庇天下寒士俱欢颜！“——这是何等的博大胸怀！在自己最困难的时候，杜甫关心的不是个人的得失，而是千千万万个与自己一样贫苦的知识分子能否有一个遮风避雨的地方。“何时眼前突兀见此屋，吾庐独破受冻死亦足！“他宁愿自己一个人承受所有的苦难，也希望所有人都能过上幸福的生活。这种推己及人、舍己为人的精神，让一千多年后的我们依然为之动容。这就是杜甫之所以被称为”诗圣”的原因——他不仅仅是一个伟大的诗人，更是一个拥有伟大人格和高尚情操的人！

广德二年（764年），经严武推荐，杜甫担任检校工部员外郎，因此后世也称他为”杜工部”。这是杜甫最后一次出仕。然而，由于身体状况和政治环境的原因，他在这个职位上没待多久就辞职了。永泰元年（765年）四月，严武病逝，杜甫失去了在成都最大的依靠。五月，他带着家人离开了居住了近六年的草堂，再次踏上了漂泊之路。

✦ ✦ ✦

伍

漂泊西南：生命最后的孤独旅程#

公元768年 — 770年

离开成都之后，杜甫的生命进入了最后的阶段。他先是乘船沿长江东下，经过嘉州（今四川乐山）、戎州（今四川宜宾）、渝州（今重庆）、夔州（今重庆奉节）等地，最终到达夔州并在此居住了将近两年时间。夔州时期是杜甫创作的又一个高峰期，他在此期间创作了约四百首诗歌，包括《秋兴八首》《登高》等代表作。

风急天高猿啸哀，渚清沙白鸟飞回。

无边落木萧萧下，不尽长江滚滚来。

万里悲秋常作客，百年多病独登台。

艰难苦恨繁霜鬓，潦倒新停浊酒杯。

——《登高》· 杜甫（夔州时期代表作）

《登高》被公认为杜甫最杰出的作品之一，也是中国古典诗歌中七言律诗的巅峰之作。“无边落木萧萧下，不尽长江滚滚来”这两句，以宏大的时空视角展现了自然的永恒与人生的渺小，意境深远，气势磅礴。而”万里悲秋常作客，百年多病独登台”则浓缩了杜甫一生的悲剧经历——万里漂泊、暮年作客、多病缠身、佳节登高、无人陪伴……短短十四个字包含了八重悲愁，令人读来不禁扼腕叹息。

大历三年（768年），杜甫再次踏上旅途，乘船出三峡，继续向东漂泊。此时的他已经是一个风烛残年的老人，疾病缠身，贫困交加。他先后辗转于江陵（今湖北荆州）、公安（今湖北公安）等地，最终于大历四年（769年）抵达潭州（今湖南长沙）和衡州（今湖南衡阳）。这一路上，杜甫的生活极为艰难，有时甚至需要靠乞讨度日。他在诗中写道：“饥借家家米，愁征处处杯。“可见其境遇之窘迫。

768年

离开夔州，乘舟出峡，开始最后的漂泊旅程

769年

辗转潭州、衡州等地，生活极度贫困，疾病缠身

770年

冬，在由潭州往岳阳的一条小船上病逝，享年五十九岁

大历五年（770年）四月，潭州发生兵乱，杜甫再次被迫逃亡。他原本计划前往郴州投靠亲戚，但在逆流而上的途中遭遇洪水，被困在耒阳一带数天，几乎饿死。幸亏有县令送来牛肉和白酒，他才得以活下来。然而，这次劫难严重损害了本就虚弱的身体。杜甫改变了计划，顺流而下返回潭州。

大历五年（770年）冬天，杜甫在一条由潭州驶往岳阳的小船上永远地闭上了双眼，享年五十九岁。据记载，他临终前的最后时刻仍然在吟诗。这位伟大的诗人就这样在贫穷与疾病中结束了他坎坷的一生。他死后，家人无力将其归葬故乡，只能临时将他安葬在岳阳。直到四十三年后（813年），他的孙子杜嗣业才将他的灵柩迁回故乡河南偃师，与夫人杨氏合葬。

**🏛️ 绝唱：**杜甫生前最后一首重要作品是《登岳阳楼》。当时他途经岳阳，登上著名的岳阳楼，面对浩瀚的洞庭湖，写下了”吴楚东南坼，乾坤日夜浮”的千古名句。这首诗既写出了洞庭湖气象万千的壮观景象，也隐含了诗人对国家破碎、身世飘零的深沉感伤。一个即将走到生命终点的老人，面对浩瀚的湖山，心中装的依然是家国天下——这就是杜甫，这就是诗圣！

✦ ✦ ✦

千秋诗圣万古流芳#

回顾杜甫的一生，我们看到的是一部充满苦难与奋斗的史诗。他生于盛唐，却经历了唐朝由极盛转向衰落的全过程；他有旷世之才，却一生怀才不遇、穷困潦倒；他自身难保，却始终心怀天下苍生。正是这些看似矛盾的因素，造就了中国文学史上独一无二的”诗圣”。

杜甫留给我们的，不仅仅是一千五百多首优秀的诗歌，更是一种崇高的人格力量和精神境界。在他身上，我们看到了什么是真正的忧国忧民，什么是推己及人的博大情怀，什么是在逆境中坚守理想的执着精神。他的诗歌被誉为”诗史”，因为他忠实地记录了自己所处的时代；他被尊为”诗圣”，因为他用生命诠释了什么是真正的文人风骨。

一千二百多年过去了，当我们今天重新诵读杜甫的诗篇时，依然会被其中蕴含的深厚情感所打动。“朱门酒肉臭，路有冻死骨”——对社会不公的控诉至今振聋发聩；“安得广厦千万间，大庇天下寒士俱欢颜”——对他人的关怀依然温暖人心；“无边落木萧萧下，不尽长江滚滚来”——对宇宙人生的思考依然启迪着我们。杜甫的精神早已融入中华民族的文化血脉之中，成为我们宝贵的精神财富。

✍️ 文章整理 | 诗圣杜甫生平传记

“文章千古事，得失寸心知。” —— 致敬伟大的诗圣杜甫

苏轼与苏辙：千年兄弟情的传奇

Mon, 04 May 2026 00:00:00 GMT

苏轼与苏辙#

千年兄弟情的传奇

“与君世世为兄弟，更结来生未了因”

在中国文学史上，有这样一对兄弟，他们的名字永远镌刻在唐宋八大家的丰碑之上。哥哥苏轼，字子瞻，号东坡居士，是北宋最耀眼的文学巨星；弟弟苏辙，字子由，官至副宰相，是沉稳内敛的政治家。他们相差两岁，却携手走过了一生中最跌宕起伏的岁月。

苏轼和苏辙谁更厉害？这个问题本身就错了。他们从来不是竞争对手，而是彼此生命中最坚实的依靠。

* * *

壹

名字里的深意#

公元1037年1月8日，苏轼出生。两年后的1039年3月18日，苏辙降临人世。他们的父亲苏洵，一位大器晚成的文学家，为两个儿子取了意味深长的名字。

轼

苏轼 · 字子瞻#

**“轼”是古代马车前方的横木，看似没什么作用，但去掉它，整个车就不完整。父亲担心苏轼不懂得隐藏锋芒，希望他能学会收敛自己。“子瞻”**意为扶着把手向远处眺望，凡事多看多想，三思而后行。

辙

苏辙 · 字子由#

**“辙”是马车留下的车轮印，一旦车毁人亡，车轮印却可以免于灾祸。苏辙性格内敛，父亲希望他”由”**着心来，放心大胆地往前走，在取得成就的同时，又能免于灾祸。

知子莫若父。苏洵对两个儿子的定位精准得令人叹服——一个光芒四射却需懂得收敛，一个沉稳内敛却能明哲保身。后来的历史证明，这位老父亲的预判分毫不差。

* * *

贰

少年成名同登进士#

1056年，年仅19岁的苏轼和17岁的苏辙，在父亲苏洵的带领下，踏上了前往京城参加科举考试的漫漫征途。这是兄弟俩第一次远离家乡，也是他们辉煌人生的起点。

1056年 · 科举及第

兄弟俩双双考中进士，相当于今天的博士学位。主考官欧阳修对苏轼的文章给予了极高的评价，称其”他日文章必独步天下”。苏轼自此名声大噪，震动京师。

1061年 · 制科考试

通过欧阳修推荐，兄弟俩参加最高级别的制科考试，再次同时被录取。苏轼获得第三等，被称为”百年第一人”，被皇帝亲自看见，开启了仕途之路。

当朝大臣张方平曾这样评价两兄弟：“哥哥性格开朗，将来一定是人见人爱；弟弟性格严谨，将来的成就或许比哥哥还高。“后来的发展，果然如他所言。

上任的第一天，想弟弟；路过同游的地方，想弟弟；想到离弟弟这么远，想弟弟……

—— 苏轼给苏辙的信

从踏入仕途的第一天起，苏轼就开始了给弟弟写信的”日常”。出差写信，放假游玩也写信，实在不过瘾，就直接画亭台池院给弟弟分享。他在信中发出感慨：天下谁也没有他弟弟好。

* * *

叁

乌台诗案生死与共#

1066年，父亲苏洵去世。两兄弟守孝三年后回到朝廷，却正值王安石推行变法。由于对变法持有异议，兄弟俩双双被贬离京。1076年中秋，已经七年没有团聚的苏轼，望着明月写下了那首传唱千古的《水调歌头》：

水调歌头 · 明月几时有#

但愿人长久，千里共婵娟。

四年后，苏辙写下《逍遥堂会宿》，回忆与哥哥从小一起读书、没有一天分开的日子。他们相约：老了要住在一起，“安知风雨夜，复此对床眠”。

1079年，苏轼被调任时给皇帝写了一封感谢信，却因言语中嘲讽新政而触怒龙颜。皇帝下令对其诗作进行全面调查，酿成了著名的”乌台诗案”。

哥哥进了大牢，眼看性命不保。在狱中，苏轼给弟弟写下绝命诗：

狱中寄子由#

与君世世为兄弟，

更结来生未了因。

意思是：自己死了不要紧，随便找个地方埋了就是。但想到之前和弟弟的约定，以后怕是只能留弟弟一个人悲伤了，希望来生还能做兄弟，再续这份情谊。

而苏辙这边，心痛不已。他请求用自己的官职为哥哥赎罪——这是何等的兄弟情深！最终，被囚禁了130天的苏轼出狱了，小命算是保住，但兄弟俩再次双双被贬。

* * *

肆

黄岁月患难真情#

1080年，苏轼来到被贬之地黄州。这里的日子贫苦不堪，但苏轼以他特有的豁达，在逆境中活出了诗意。

**东坡居士的由来：**第二年，为了不饿肚子，苏轼在东坡外的山坡上种了十亩地，从此自称”东坡居士”。
**东坡肉的发明：**第三年，为了省钱，他发明了著名的东坡肉。在明朝之前，猪肉被视为贱肉，非常便宜，这让贫困中的苏轼也能吃上肉。
**文学创作的高峰：**这四年间，苏轼留下了100多首诗，占他一生作品的四分之一。正是这段被贬的岁月，成就了他文学创作的巅峰。

在这四年里，兄弟俩来往信件频繁。苏辙叮嘱哥哥照顾身体、少喝酒；苏轼则告诉弟弟：不高兴了，大不了就不干了，来找我，咱们一起安家听雨。

* * *

伍

仕途分野守护之情#

1085年，高太后上台打压王安石变法，苏轼、苏辙再次被启用，兄弟俩总算在京师重逢。然而好景不长——苏轼在被贬期间认识到王安石变法的某些好处，开始攻击高太后欣赏的司马光，于是又一次被贬。

这一次，两兄弟的仕途出现了分野：

轼

苏轼 · 造福一方#

在被贬期间，苏轼治理西湖，留下了苏堤春晓、三潭印月等传世美景。他每到一处，都全心投入造福百姓。

辙

苏辙 · 位极人臣#

苏辙深得高太后倚重，一路升职加薪，成为位高权重的副宰相。仿佛在用行动告诉哥哥：只有我一直往上爬，才能更好地守护你。

1094年，新党再次上台，兄弟俩又双双被贬。57岁的苏轼被贬到广东惠州，苏辙去了江西。即便到了这个年纪，苏轼依然没有破罐子破摔，反而随遇而安，在惠州两年间为当地百姓做了无数好事：

**提高农业生产力：**改善当地的插秧模式，提高农作物产量。
**帮助百姓创收：**建议村民利用溪流落差建造水碓水磨，将檀香、樟木等研成粉销往广州等地。
**为百姓安全建桥：**建议修建两桥一堤，资金不足时动员弟弟弟媳捐款，这就是后来的”苏公堤”。

就在哥哥忙着造福百姓、没空给弟弟写信的时候，苏辙来信催促：“快过年了，哥哥别忘了寄新诗词给我！”

—— 苏辙来信

苏轼回复：“我忙着造福百姓呢，而且我又发明了美食羊蝎子！“——即便在最艰难的时刻，这对兄弟依然保持着乐观与温情。

* * *

陆

海南岁月文化播种#

1097年，两兄弟再次被贬。这一次，苏轼被贬到了海南海口——在宋朝，放逐海南是比满门抄斩罪轻一等的处罚。1000年前的海南，是”中原人去海南，十去九不还”的荒蛮之地。

在前往被贬之地的路上，两兄弟心中都清楚：无论从年龄还是看不到头的被贬之路来看，这都有可能是他们最后在一起的日子了。

然而，即便到了海南，生活如此艰难，苏轼却以一己之力给海南带来了文化繁荣：

**创办海南第一所学堂：**他带领百姓盖学堂、做老师，把荒蛮之地变成了书声朗朗、弦歌四起的文化中心。不久后，海南就有了第一位进士。
**发明海南第一块墨：**用树枝烧成灰，混合牛皮胶制成。
**贡献海南第一个插秧机：**挖了第一口水井，开办了第一家医院，亲自当医生救死扶伤。

苏轼·诗#

沧海何曾断地脉，

朱崖从此破天荒。

一个荒蛮之地完成了科举零突破，这确实称得上是”破天荒”。当地百姓对苏东坡简直是膜拜——他们对帝王将相都没有兴趣，却因为能拥有”我们的苏东坡”而自豪。

流传至今的东坡村、东坡井、东坡田、东坡路、东坡桥、东坡帽……都表达了当地人对他的尊敬和缅怀。这就是文化的力量——读的书多、学问多，自然就懂得多，走到哪里都能造福一方。

* * *

柒

生死离别终成永恒#

1100年，新皇帝继位，兄弟俩再次被启用。他们非常高兴，因为那个”对床饮酒听雨声”的愿望马上就要实现了。

然而，命运弄人。1101年8月24日，苏轼在北归途中重病逝世，享年66岁。

唯吾子由，不及一见而绝，死痛难堪。

—— 苏轼临终遗言

临终前，苏轼遗憾地写下：只有子由，来不及见最后一面就要走了，这种痛苦难以承受。

苏辙得知哥哥过世，悲痛不已，为哥哥写下：

手足之爱，平生一人。

—— 苏辙祭文

11年后，苏辙去世，他们葬在了一处。此时，他们终于实现了年少时的约定：

终成现实#

安知风雨夜，

复此对床眠。

* * *

捌

千古流芳兄弟典范#

苏辙，唐宋八大家之一，北宋文学家，好丈夫，一生未纳妾。

苏轼，唐宋八大家之一，北宋文学家、书法家、画家，光芒万丈的文化巨星。

唐宋八大家之中，光他们家就占了三个——还有他们的父亲苏洵。这一家人，是真厉害！

论仕途，苏辙的官位高；论对百姓的贡献，苏轼更高。

他为人谨慎，他为人洒脱。

他喜欢被贬的每一个地方，就连他只待过5天的登州，也有”五天登州府，千年苏公祠”的后话。

苏轼不管被贬到哪里，都能活下去，而且可以快乐地活下去。他能享受命运的馈赠，也能承担命运的打击。这两兄弟都在各自擅长的地方发光，做了最好的自己。

《宋史》记载了两个人的兄弟情，用了四个字：“禁锢罕见”。

大家都说”大难临头各自飞”，但他们始终相互扶持，在他们身上没有看到对对方的一点怨言。这是难得的兄弟情谊，是千古传颂的典范。

✦ 尾声 ✦#

苏轼与苏辙的故事告诉我们：

真正的兄弟，不是比较谁更厉害，

而是在彼此的生命中，成为最坚实的依靠。

愿我们都能拥有这样的情谊，

愿天下有情人，都能”但愿人长久，千里共婵娟”。

千古第一意难平-陆游与唐婉的爱情故事

Mon, 04 May 2026 00:00:00 GMT

千古第一意难平 陆游与唐婉的爱情故事

有些爱，赢了时光，却输了世俗

有些成全，暖了岁月，却敌不过一句故人难忘

世人皆知钗头凤，少有人怜赵士诚。

我们总说爱能抵万难，可读完这两首词以及三个人的故事，才懂——有些爱，赢了时光，却输了世俗；有些成全，暖了岁月，却敌不过一句故人难忘。

为什么陆游的一句”错错错”能让唐婉抑郁而终？赵士诚的极致深情又为何鲜少被人提及？

壹

凤钗定情

那年春风恰好

南宋绍兴年间，越州山阴（今浙江绍兴），有一对璧人。

陆游，字务观，出身书香门第，少年便负才名；唐婉，字蕙仙，自幼聪慧灵秀，精通诗词文墨。两家本为世交，二人自幼便在彼此的视线里长大——她是他的青梅，他是她的竹马。

那一年，陆家以一只祖传凤钗为聘，将唐婉迎娶过门。

凤钗映烛光，红烛照新人。婚礼那夜，满堂宾客都说，这分明是天作之合。

婚后的小日子，甜得像浸了蜜。陆游与唐婉不是寻常夫妻，更是知音。他写诗，她续句；他抚琴，她低唱。两个人常常秉烛夜谈，从诗词歌赋聊到人生哲学，从晨光熹微聊到月落乌啼。

陆游曾以为，此生最好的光景，不过是眼前人与枕边书。

可他不知道，这份让世人艳羡的甜蜜，在另一个人眼里，却是刺目的祸水。

那个人，是他的母亲。

◆◆◆

贰

东风恶

母命如山，情薄如纸

陆母是个传统的大家闺秀，在她看来，男儿当以功名为重，岂能沉溺于儿女情长？

她看着儿子日日与妻子诗词唱和、耳鬓厮磨，心里的不满像野草一样疯长。更要命的是——唐婉嫁入陆家数年，膝下无子。

在那个”不孝有三，无后为大”的年代，这几乎是最致命的罪名。

陆母多次旁敲侧击，唐婉心中委屈却不敢辩驳。她何尝不想为陆家开枝散叶？只是这世间事，从来不是想就能成的。

终于有一天，陆母下了最后通牒：休了她。

陆游跪在母亲房前，长跪不起。他哀求，他痛哭，他甚至悄悄在外面租了宅院将唐婉藏起来——可纸终究包不住火，陆母发现后勃然大怒，以死相逼。

一边是生养之恩，一边是挚爱之人。

陆游选择了母亲。

他在休书上落笔的那一刻，手是抖的。他不敢看唐婉的眼睛，不敢看她鬓边那支凤钗——那是他给她的承诺，如今却成了最讽刺的笑话。

唐婉被休了。

在南宋，被休的女子几乎等同于不祥之人。流言蜚语像刀子一样追着她——“克夫""无后""命硬”……每一句都往骨头缝里扎。

曾经满腹诗书的才女，一夜之间成了人人避之不及的弃妇。她日渐憔悴，像一株被连根拔起的花，在风中摇摇欲坠。

◆◆◆

叁

一诺千金

赵士诚的极致深情

赵士诚

永嘉郡王 · 宋太宗玄孙

身份显赫，家世煊赫，要什么样的女子没有？可他偏偏看上了唐婉——一个被休的弃妇，一个世人眼中的不祥之人。

消息传出，整个赵氏宗族炸了锅。

长辈们轮番劝阻，族中长老拍案而起，连皇族宗亲都出面施压——堂堂郡王，娶一个弃妇，皇家颜面何在？

可赵士诚铁了心。

“高官厚禄、名声地位，都不及她半分。”

他不只是嘴上说说。他用一场最隆重的婚礼，给了唐婉这个世间最体面的救赎。十里红妆，八抬大轿，他要让所有人知道——他娶的不是一个弃妇，是他此生唯一想要守护的人。

新婚之夜，他对唐婉说：

“此生只护你一人。”

在那个三妻四妾再寻常不过的年代，这句话的分量，比任何山盟海誓都重。

赵士诚说到做到。他待唐婉极好——春天陪她赏花，夏夜陪她纳凉，秋天给她添衣，冬天为她暖汤。他不催她忘掉过去，不逼她笑脸相迎，只是默默地在她身边，像一把伞，替她挡住世间的风雨。

慢慢地，唐婉脸上又有了笑容。

她偶尔也会写写诗词，虽然笔下的风月多了几分沧桑，但至少，她重新活了过来。

赵士诚看着妻子的笑容，觉得这些年所有的压力都值了。

可命运偏偏要开一场最残忍的玩笑。

◆◆◆

肆

沈园重逢

一首杀人的词

绍兴二十五年，春。

赵士诚陪唐婉游沈园，满园春色，柳絮纷飞。唐婉的心情难得地好，甚至主动提议走走当年常走的石径。

谁也没想到，就在那条小径的尽头，他们撞见了陆游。

十年未见。

他老了，她也瘦了。可四目相对的刹那，时光仿佛倒流，回到了当年凤钗定情的那一夜。

空气凝固了。

唐婉愣在原地，一时不知该进还是该退。赵士诚看在眼里，心中五味杂陈，可他到底是那个温润如玉的君子——他轻轻点了点头，示意唐婉不必顾忌。

征得丈夫的同意，唐婉命人给陆游送去一杯黄縢酒，几碟小菜。

这杯酒，是旧情的最后一丝体面，也是故人的最后一次温柔。

陆游接过酒，手在抖。他望着唐婉离去的背影，想起当年花前月下的誓言，想起自己亲手签下的休书，想起这十年来每一个辗转难眠的夜晚——

他崩溃了。

借着酒劲，陆游踉跄着走到沈园的粉壁前，提笔写下了那首流传千古的词——

◆◆◆

伍

钗头凤 · 陆游

错错错，一错再错

📜 钗头凤 · 红酥手 陆游

红酥手，黄縢酒，满城春色宫墙柳。

东风恶，欢情薄，一怀愁绪，几年离索。

错！错！错！

春如旧，人空瘦，泪痕红浥鲛绡透。

桃花落，闲池阁，山盟虽在，锦书难托。

莫！莫！莫！

起笔：美得心碎

“红酥手，黄縢酒，满城春色宫墙柳。”

你红润酥腻的手捧着黄縢酒，满城春花开，宫墙旁的柳枝随风摇曳——一如当年我们共度的时光。

可如今，这眼前景，全是我当年亲手推开的。

物是人非的对比，比刀割还疼。

转折：恨入骨髓

“东风恶，欢情薄，一怀愁绪，几年离索。”

东风太恶毒了，把我们的欢情吹得那么稀薄。这几年，我满怀愁绪，我们各自飘零——明明相爱，却只能相望。

这里的”东风”不是春风，是陆母的苛责，是封建礼教的条条框框，是那座压得他喘不过气来的伦理之山。

这是陆游的自责，也是他的无奈。他恨自己护不住爱人，恨世俗拆散了彼此，他什么也做不了，只能任由愁绪填满心底。

爆发：三个”错”字

“错！错！错！”

错在不敢违逆母亲，错在当初放手，错在十年未忘，再见仍乱了心神。

三个”错”字，没有任何修饰，却比千言万语更有力量。就像一个人被逼到绝境，只能用最简单的字宣泄最极致的痛苦。

陆游在这里扇的是自己的耳光。他知道一切都晚了，所有的错误都无法挽回。

凝望：你瘦了

“春如旧，人空瘦，泪痕红浥鲛绡透。”

春天还像以前一样，可你怎么瘦成了这样？你的手帕都被带着胭脂的眼泪湿透了。

他心疼了。可他不知道——唐婉肩上披着的，是赵士诚送的暖裘；绣囊里藏着的，是赵士诚写的平安信。

他以为她过得不好，却不知道，是另一个人替他完成了他没能做到的事。

绝笔：三个”莫”字

“山盟虽在，锦书难托。”

我们当年的海誓山盟还在，可现在就算写了信，也没法寄给你了——你已经是赵家人了，而我只是个路人甲。

他的任何念想，都是对唐婉现有幸福的冒犯。

“莫！莫！莫！”

罢了罢了。莫再想，莫再念，莫再扰。

这三个”莫”字，是绝望，是放手，是明知不可为而为之后的彻底放弃。

陆游写完，哭着走了。

他不知道，这首词，成了一把插进唐婉心里的刀。

◆◆◆

陆

钗头凤 · 唐婉

难难难，无路可退

第二年春天，唐婉重游沈园。

她看到了墙上那首词——墨迹斑斑，全是前夫的血泪。

那一刻，她心里筑了十年的防线，轰然崩塌。

于是她提笔，在陆游的词旁，写下了自己的回答——

📜 钗头凤 · 世情薄 唐婉

世情薄，人情恶，雨送黄昏花易落。

晓风干，泪痕残，欲笺心事，独语斜阑。

难！难！难！

人成各，今非昨，病魂常似秋千索。

角声寒，夜阑珊，怕人寻问，咽泪装欢。

瞒！瞒！瞒！

写完这首词不久，唐婉抑郁而终，香消玉殒。

世情薄：人心比夜更凉

“世情薄，人情恶，雨送黄昏花易落。”

如果说陆游的词是悔，那唐婉的词就是疼。

陆游骂东风，唐婉叹世情。这个世道太凉薄，人心太险恶，我就像那黄昏雨中的花——哪怕再美，也注定要凋落。

这是她的亲身感受。被休之后，她成了别人口中的弃妇，流言蜚语、冷眼相待，唯有赵士诚将她护在伞下。

可陆游的词一出来，那把伞就破了。风雨全往旧伤口里钻。

独语斜阑：连倾诉的资格都没有

“晓风干，泪痕残，欲笺心事，独语斜阑。”

早晨的风吹干了泪痕，我想把心事写下来——可写给谁？

写给陆游，是对赵士诚的辜负；写给赵士诚，是让他十年的温柔都成了笑话；写给自己，又怕眼泪晕开了墨迹。

只能独自靠在栏杆上，对着空庭自言自语。

**这份孤独，比分离更让人绝望。**陆游至少还能把愁绪写在墙上，可唐婉连倾诉的资格都没有，只能把心事一层一层地压在心底。

三个”难”字：无路可走

“难！难！难！”

陆游说”错”，是悔恨；唐婉说”难”，是无路可走。

相见难，倾诉难，放下难——旧爱新欢缠成死结。

她不像陆游，还能有一丝悔恨的余地。她的处境只有无尽的艰难，没有任何出路，这份痛苦永远也解脱不了。

病魂秋千：身体与精神的双重崩塌

“人成各，今非昨，病魂常似秋千索。”

如今我们各自安好，再也不是当年的模样。病魂常似秋千索——这是最让人心疼的一句。

唐婉因为长期的悲伤，身体早已垮了。被休时病过一次，被陆游的词又勾病了。就像秋千上的绳索，晃晃悠悠，找不到安稳。

咽泪装欢：最扎心的一幕

“角声寒，夜阑珊，怕人寻问，咽泪装欢。”

深夜，角声传来，寒意刺骨，她独自落泪。赵士诚给她暖汤盖被，她却不敢说——不是天冷，是心冷。

陆游可以发泄，可以写词骂东风；可唐婉不行。她夹在中间，不能负了旧情，又不敢伤了新人，所以连痛苦都要藏着掖着。

“她的装欢，比痛哭更让人心疼。”

就像我们受了委屈，却要在家人面前强颜欢笑

就像我们心里难过，却要在朋友面前假装没事

三个”瞒”字：耗尽了一生

“瞒！瞒！瞒！”

瞒住对陆游的念想，瞒住心里的伤痛，瞒住所有人——假装幸福。

可惜她瞒过了所有人，却瞒不过自己的身体。

三个”瞒”字，耗尽了她的生命。

◆◆◆

柒

赵士诚

被历史遗忘的深情

唐婉死后，赵士诚的世界也塌了。

他终身没有再娶，没有纳妾。

在那个三妻四妾再寻常不过的年代，这几乎是个奇迹。堂堂郡王，皇族之后，却为一个人守了一辈子的寡。

后来，赵士诚主动请缨，奔赴沙场。

他不是好战，他是找不到活着的理由了。战场上刀剑无眼，他不在乎。他要用最决绝的方式，去陪他的爱人——

生不同衾，死同穴。

那天在沈园，是他大度地让妻子给前夫送酒。他以为这能解开妻子的心结，以为自己的十年温柔终能抚平她的伤疤。

可他万万没想到，陆游的一首词，摧毁了他十年的全部努力。

他的温柔，他的守护，他的不离不弃——在陆游那面墙的墨迹面前，轻得像一缕风。

可这缕风，暖了唐婉整整十年。

◆◆◆

捌

陆游的余生

一辈子没走出沈园

反观陆游，虽然活到了八十五岁，但他这辈子都没走出那个沈园。

他晚年写了无数首诗怀念唐婉——

城上斜阳画角哀，沈园非复旧池台。
伤心桥下春波绿，曾是惊鸿照影来。

陆游《沈园二首 · 其一》

梦断香消四十年，沈园柳老不吹绵。
此身行作稽山土，犹吊遗踪一泫然。

陆游《沈园二首 · 其二》

临死前一年，八十四岁的陆游还挣扎着去了一趟沈园。

他站在那面墙前，墙上的字迹早已斑驳，可他的眼泪还是止不住地流。

那是他对唐婉最后的告白。

五十年了，他还是没有放下。

今浙江绍兴沈园

◆◆◆

尾声 · 爱情最狠的真相

有人说，唐婉是虚构的，钗头凤是后人附会的，赵士诚的深情也是假的。

但真假已经不重要了。

因为这个故事记录的那种痛，是真实的。
它代表了千百年来那些被封建礼教拆散的、爱而不得的灵魂。

我们总为陆游的”错”叹息，为唐婉的”苦”流泪，
却忘了问一句——

赵士诚的十年温柔，到底算什么？

两首钗头凤，一首是男人的懦弱与悔恨，
一首是女人的隐忍与绝望。

字里行间全是对旧爱的执念，
却唯独欠了赵士诚一句——

谢谢你。

这才是爱情最狠的真相：
有些人，一旦错过，就是一辈子。
有些爱，一旦回头，就是万丈深渊。

如果你身边有一个赵士诚这样的人，
请千万千万要珍惜。
别为了那个已经错过的陆游，伤了眼前人的心。

满目山河空念远
不如怜取眼前人

但愿这世间
少一些”错错错”的遗憾
少一些”瞒瞒瞒”的悲凉

若爱，请深爱。
莫待锦书难托，人空瘦。

💬 评论区

读完陆游与唐婉的故事，你更心疼谁？
是爱而不得的陆游，隐忍成疾的唐婉，还是深情不被看见的赵士诚？
欢迎在评论区分享你的感受 ✍️

#

— 附录 · 钗头凤二首 —

《钗头凤 · 红酥手》— 陆游

红酥手，黄縢酒，满城春色宫墙柳。

东风恶，欢情薄，一怀愁绪，几年离索。

错！错！错！

春如旧，人空瘦，泪痕红浥鲛绡透。

桃花落，闲池阁，山盟虽在，锦书难托。

封狼居胥霍去病——那个用一生燃烧大汉荣耀的少年

Mon, 04 May 2026 00:00:00 GMT

封狼居胥——那个用一生燃烧大汉荣耀的少年

漢

大汉战神 · 霍去病

封狼居胥

那个用一生燃烧大汉荣耀的少年

岁辞世

次出征

11万+

斩首俘获

公元前119年，狼居胥山上站着一个21岁的青年。他在匈奴人的神山之上，祭拜了汉人的天地。这是华夏历史上，唯一一个非帝王身份的男人完成的封禅，也是第一个在敌人领土上进行的封禅。

他叫霍去病。

壹

七十年的屈辱，一朝清算#

公元前200年，刘邦一时头脑发热，亲率几千人追着几万匈奴猛砍，结果被匈奴单于冒顿来了个”回首掏”，被困白登山七天七夜。这场白登之围，让大汉丢尽了脸面，此后七十余年，汉朝只能靠送公主、送财物换来表面的和平。

然而匈奴依然年年南下劫掠，杀人放火，如入无人之境。这种屈辱，一直压到一个叫刘彻的皇帝登基。

汉武帝刘彻恨透了靠女人和亲换来的和平。

他要彻底扭转——汉守匈攻的局面。

于是，这位野心极大的皇帝在走访姐姐平阳公主府时，随手就从一个舞女身上，给大汉抽到了三张SSR——卫青、霍去病、霍光。

✦

贰

私生子出道，天子亲自调教#

公元前140年，平阳侯府的女奴魏少儿为一个小吏生下了一个私生子，那个渣男叫霍仲儒，提上裤子就跑，从此断了联系。

但霍仲儒可能做梦也没想到，魏少儿的妹妹卫子夫后来上了刘彻的龙床，老魏家瞬间草鸡变凤凰，成了皇家外戚。而这个叫霍去病的私生子，因为极强的骑射天赋被刘彻看中，提拔为近臣侍中——天子亲信。

刘彻太喜欢这个孩子了，准备亲自传授他孙吴兵法。然而霍去病直接婉拒了：

”

顾方略何如耳，不至学古兵法。

打仗只需要看准方针策略，不需要学古人那些用不着的东西。

—— 霍去病，拒绝天子教授兵法

刘彻没有生气，反而更爱了。因为这个孩子身上有一种让他着迷的东西——纯粹的、不可遏制的战场直觉。

✦

叁

出道即巅峰：八百骑，斩首两千#

公元前123年，17岁的霍去病第一次跟着舅舅卫青出征。卫青给了外甥八百精锐壮士，然后霍去病带着这八百人，脱离大部队，直插大漠深处。

⚔ 首战战报 · 公元前123年

800

出征骑兵

2028

斩首+俘虏

俘获匈奴相国、当户等高级官员，斩杀匈奴大单于的祖父若侯铲，俘虏单于的叔父罗姑比。

与此同时，汉军主力右将军苏建、前将军赵信率三千骑兵与匈奴激战，全军覆没，赵信更是直接投降了匈奴。

**有对比，才知道天才和普通人的差距。**八百 vs 两千，出道即巅峰的霍去病，成了汉武帝刘彻心中那个”亲临战场的化身”。

刘彻封霍去病为冠军侯

赐豪华宅邸，让他去住。霍去病说——

“匈奴未灭，无以家为。”

✦

肆

两打河西，打通丝绸之路#

公元前121年，刘彻将目光投向河西走廊——中原通往西域的咽喉要道，当时被匈奴浑邪王和休屠王控制，与羌人联合，从西边威胁大汉。刘彻想要剁掉匈奴的这条右臂，为最终的漠北决战扫清后路。

这年春天，19岁的霍去病率一万骑兵出征。他越乌鞘岭，渡黄河，六天转战千余里，踏破匈奴五王国。匈奴单于的儿子不服，想和霍去病过两招，被瞬间打崩，险些被活捉。

📜 河西两战战绩对比

春季第一战

夏季第二战

兵力

10,000骑

孤军深入

斩获

8,960级

歼敌3万+

战果

斩折兰王、卢侯王，俘浑邪王子

俘获单于阏氏、王子等59人

特殊战利品

抢走匈奴祭天金人

封侯部将3人

第二次河西之战，霍去病发现队友全是拖后腿的——公孙敖走岔了路，李广又一次被包围差点全军覆没，张骞迷路来晚了。四路人马只剩霍去病孤军深入2000余里，绕到敌军侧后突然猛攻。

骄傲的骠骑将军眼里只有陛下和舅舅，至于一些累赘，跟不上就别跟。

🔍 霍去病能深入大漠2000里还能找到敌人的秘密

他敢于、善于用匈奴人当手下——

◈

校尉高不识 — 匈奴小王出身，本家人带路

◈

司马赵破奴 — 长期生活在匈奴的汉人，熟悉地形

◈

部署几乎全是匈奴人 — 以战养战，轻装奔袭

匈奴之歌（哀歌）

失我祁连山，使我六畜不蕃息；

失我焉支山，令我妇女无颜色。

对匈奴，这是耻辱的哀歌；对大汉，这是踏血的荣耀。

✦

伍

漠北大决战：封狼居胥，饮马瀚海#

公元前119年，汉武帝刘彻发动了对匈奴最大规模的决战。卫青、霍去病各率五万骑兵，分两路深入漠北，力求一战定乾坤。

原定由霍去病直取匈奴大单于，但俘虏透露大单于已向东移动，于是舅舅与外甥换了位置。卫青西出，遭遇大单于；霍去病东出代郡，迎战左贤王。

卫青路线

出定襄，遇大单于主力

趁沙尘暴双翼包抄

歼敌 19,000 人

大单于西北突围逃遁

霍去病路线

出代郡，北进 2000+ 里

大破左贤王，歼敌 70,000

俘获王侯将相 80+ 人

追至狼居胥山，封禅

⚑ 公元前119年 · 狼居胥山顶 ⚑

这个21岁的青年，站在匈奴人的神山之上，筑坛祭拜大汉的天。

随后，又马不停蹄赶到姑衍山，筑坛祭拜大汉的地。

在那个封建迷信的年代，这是在杀人诛心——他要斩断匈奴的龙脉，断绝匈奴的国运。

完成封禅后，霍去病率军一路向北，直抵今天的贝加尔湖畔。

饮马瀚海，遥望长安。

漠北大决战后，匈奴势力被严重削弱，大单于逃至漠北，匈奴远遁漠南，再无王庭。

✦

陆

流星划过，年仅二十三岁#

公元前117年，就在汉武帝准备再次出击匈奴时，才发现他的这张最强战牌，到期了。

或许是多次领兵千里奔袭后的积劳成疾，或许是感染了大漠中的瘟疫，年仅23岁的霍去病突然病逝。

痛苦万分的武帝刘彻，下令让霍去病陪葬茂陵，赐谥号”景桓”，调遣河西五郡的铁甲军列阵为他送葬，并将坟墓修成祁连山的形状，以彰显他克敌制胜的奇功。

坟墓形如祁连山 · 铁甲军送葬

千年已过，那个在河西、在祁连山、在狼居胥、
在瀚海纵马狂奔的少年，

已经成为了一颗耀眼的流星，
永远铭刻在汉家儿郎的脑海里。

✦

终

开疆拓土，是刻在基因里的荣耀#

霍去病留给这个民族的，不只是那一场场战役的胜利，而是一种精神——无论什么时代，为民族、为国家收复失地、开疆拓土，永远是华夏儿郎最高的功勋。

流传千古的名言

匈奴未灭，无以家为。

这五个字，是一个少年的志向，也是一个时代的回响。

这一颗流星虽然短暂，
却给了后人喊出那句话的底气——

犯强汉者，虽远必诛。

汉武、长平、冠军，他们让开疆拓土，
成为每一个汉人铭刻在基因里的荣耀使命。

大汉荣耀

中国历史文化人物

在历史中寻找力量，在人物中看见自己

blog布局系统详解

Sat, 03 Jan 1970 00:00:00 GMT

📖 概述#

Firefly 提供了灵活的布局系统，允许您根据内容需求和个人喜好自定义博客的视觉呈现方式。布局系统主要包括侧边栏布局和文章列表布局两个维度，它们相互配合，共同决定了页面的整体结构。

本文将详细介绍 Firefly 的各种布局模式、它们的特点、使用场景，以及不同布局组合的效果。

左侧边栏+列表布局

右侧边栏+网格布局

左侧边栏+三列网格布局

双侧边栏+列表布局

双侧边栏+网格布局

双侧边栏+网格瀑布流布局

一、侧边栏布局系统#

侧边栏是博客页面的重要组成部分，用于展示导航、分类、标签、统计信息等辅助内容。Firefly 支持两种侧边栏布局模式。

1.1 单侧边栏模式#

左侧边栏 (position: “left”)#

左侧边栏布局

右侧边栏 (position: “right”)#

右侧边栏布局

特点#

侧边栏固定在页面其中一侧
文章阅读区域体验更佳，更宽敞
更加简约，没有那么紧凑

适用场景#

传统博客风格
强调导航和分类的博客
需要突出用户资料的个人博客
内容为主，辅助信息次之的场景

Tip

可以通过showBothSidebarsOnPostPage配置是否在文章详情页显示双侧边栏

当position为left或right时开启此项后，文章详情页将显示双侧边栏，主页等其他页面保持单侧边栏

适用在只想用单侧栏，但在文章详情页想用对侧栏的目录等组件的场景

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "left", // 左侧边栏
4
  showBothSidebarsOnPostPage: true, // 是否在文章详情页显示双侧边栏
5
};

1.2 双侧边栏模式 (position: “both”)#

特点#

左右两侧同时存在侧边栏
主内容区域位于中间
最大化利用屏幕空间
可以展示更多辅助信息
适合宽屏显示器

布局结构#

双侧边栏+列表布局

双侧边栏+网格布局

适用场景#

宽屏桌面端浏览
信息密集型博客
需要展示大量辅助内容
专业性强的技术博客

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "both", // 双侧边栏

二、文章列表布局系统#

文章列表是博客首页和归档页的核心内容，Firefly 提供两种展示方式，并支持多种网格配置。

2.1 列表模式 (defaultMode: “list”)#

特点#

单列纵向排列
显示文章封面图
展示更多文章摘要
适合深度阅读

列表布局结构#

列表模式布局

优点#

✅ 视觉冲击力强，封面图吸引眼球
✅ 可以展示更多文章信息（摘要、标签等）
✅ 适合图片内容丰富的博客
✅ 移动端友好，单列更易阅读
✅ 兼容所有侧边栏配置（单侧、双侧）

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "list", // 列表模式
4
    allowSwitch: true,   // 允许用户切换
5
  },
6
};

2.2 网格模式 (defaultMode: “grid”)#

特点#

自适应列数，根据浏览器宽度自动调整
紧凑布局，信息密度高
适合快速浏览

自适应网格#

网格模式通过 columnWidth 配置卡片的最小宽度（单位 px），浏览器会根据容器可用宽度自动计算能容纳多少列。

网格布局

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "grid",
4
    allowSwitch: true,
5
    grid: {
6
      masonry: true,      // 开启瀑布流
7
      columnWidth: 320,   // 卡片最小宽度(px)，浏览器自动计算列数
8
    },
9
  },
10
};

2.3 瀑布流布局 (Masonry)#

Firefly 的网格模式内置了智能瀑布流布局支持，解决了网格布局中因图文混合文章导致的卡片高度不一致导致的空白问题。

瀑布流布局

智能排版：自动将卡片放置到最短的列，最大化利用垂直空间。
消除空白：通过绝对定位精确计算每个卡片的位置，让卡片紧贴上方卡片，消除垂直方向的空白间隙。
自适应列数：瀑布流同样根据 columnWidth 和容器宽度动态计算列数，无需固定配置。
配置灵活：您可以在 siteConfig.ts 中通过 postListLayout.grid.masonry 选项自由开启或关闭此功能。

三、布局组合指南#

Firefly 允许您自由组合侧边栏和文章列表布局。以下是各种组合的效果说明。

侧边栏模式	文章列表模式	推荐度	适用场景
单侧边栏	列表模式	⭐⭐⭐⭐⭐	摄影、设计、生活类博客，强调图片和沉浸感
单侧边栏	网格模式	⭐⭐⭐⭐⭐	技术、笔记类博客，平衡阅读与检索效率
双侧边栏	列表模式	⭐⭐⭐⭐⭐	需要展示大量侧边栏信息的站点
双侧边栏	网格模式	⭐⭐⭐⭐⭐	极客风格，追求最高信息密度

四、响应式布局行为#

Firefly 的布局系统具有智能的响应式设计，会根据屏幕尺寸自动调整。

为了保证最佳阅读体验，系统会在屏幕变窄时自动调整布局：

网格列数自动减少：网格模式的列数由 columnWidth 和容器宽度自动决定，屏幕越窄列数越少。
列表模式 -> 网格模式：当屏幕宽度小于 380px（超小屏设备）时，列表模式会自动切换为网格模式，以保证卡片内容的可读性。
双侧边栏 -> 单侧边栏：当屏幕宽度小于 1280px 时，会根据tabletSidebar配置显示单侧边栏，隐藏其中一个侧边栏，文章目录导航会切换成浮动目录导航。

五、常见问题#

Q1: 如何调整网格列数？#

A: 通过 columnWidth 配置卡片最小宽度即可。值越小，同等宽度下列数越多；值越大，列数越少。浏览器会自动根据可用宽度计算最佳列数。

六、总结#

Firefly 的布局系统给予了您更大的自由度，您都可以通过简单的配置实现。

我们建议您根据自己的内容类型和目标读者的设备偏好，尝试不同的组合，找到最适合您的博客形态。

Firefly 代码块示例

Sat, 03 Jan 1970 00:00:00 GMT

在这里，我们将探索如何使用 Expressive Code 展示代码块。提供的示例基于官方文档，您可以参考以获取更多详细信息。

表达性代码#

语法高亮#

语法高亮

常规语法高亮#

1
console.log('此代码有语法高亮!')

渲染 ANSI 转义序列#

Terminal window展开收起

1
Standard ANSI colors:
2
- Dimmed:      Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
3
- Foreground:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
4
- Background:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
5
- Reversed:    Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
6

7
8-bit colors (showing colors 160-171 as an example):
8
- Dimmed:      160  161  162  163  164  165  166  167  168  169  170  171 
9
- Foreground:  160  161  162  163  164  165  166  167  168  169  170  171 
10
- Background:  160  161  162  163  164  165  166  167  168  169  170  171 
11
- Reversed:    160  161  162  163  164  165  166  167  168  169  170  171 
12

13
24-bit colors (full RGB):
14
- Dimmed:      ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
15
- Foreground:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
16
- Background:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
17
- Reversed:    ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
18

19
Font styles:
20
- Default
21
- Bold
22
- Dimmed
23
- Italic
24
- Underline
25
- Reversed
26
- Strikethrough

展开收起

编辑器和终端框架#

编辑器和终端框架

代码编辑器框架#

my-test-file.js

1
console.log('标题属性示例')

src/content/index.html

1
<div>文件名注释示例</div>

终端框架#

Terminal window

1
echo "此终端框架没有标题"

PowerShell 终端示例

1
Write-Output "这个有标题!"

覆盖框架类型#

1
echo "看，没有框架!"

PowerShell Profile.ps1

1
# 如果不覆盖，这将是一个终端框架
2
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
3
New-Alias tail Watch-Tail

文本和行标记#

文本和行标记

标记整行和行范围#

1
// 第1行 - 通过行号定位
2
// 第2行
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行
6
// 第6行
7
// 第7行 - 通过范围 "7-8" 定位
8
// 第8行 - 通过范围 "7-8" 定位

选择行标记类型 (mark, ins, del)#

line-markers.js

1
function demo() {
2
  console.log('此行标记为已删除')
3
  // 此行和下一行标记为已插入
4
  console.log('这是第二个插入行')
5

6
  return '此行使用中性默认标记类型'
7
}

为行标记添加标签#

labeled-line-markers.jsx

1
<button
2
  role="button"
3
  {...props}
4
  value={value}
5
  className={buttonClassName}
6
  disabled={disabled}
7
  active={active}
8
>
9
  {children &&
10
    !active &&
11
    (typeof children === 'string' ? <span>{children}</span> : children)}
12
</button>

在单独行上添加长标签#

labeled-line-markers.jsx展开收起

1
<button
2
  role="button"
3
  {...props}
4

5
  value={value}
6
  className={buttonClassName}
7

8
  disabled={disabled}
9
  active={active}
10
>
11

12
  {children &&
13
    !active &&
14
    (typeof children === 'string' ? <span>{children}</span> : children)}
15
</button>

展开收起

使用类似 diff 的语法#

1
此行将标记为已插入
2
此行将标记为已删除
3
这是常规行

1
--- a/README.md
2
+++ b/README.md
3
@@ -1,3 +1,4 @@
4
+this is an actual diff file
5
-all contents will remain unmodified
6
 no whitespace will be removed either

结合语法高亮和类似 diff 的语法#

1
function thisIsJavaScript() {
2
  // 整个块都会以 JavaScript 高亮显示，
3
  // 并且我们仍然可以为其添加 diff 标记！
4
  console.log('要删除的旧代码')
5
  console.log('新的闪亮代码！')
6
}

标记行内的单独文本#

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配项';
4
}

正则表达式#

1
console.log('单词 yes 和 yep 将被标记。')

转义正斜杠#

Terminal window

1
echo "Test" > /home/test.txt

选择内联标记类型 (mark, ins, del)#

1
function demo() {
2
  console.log('这些是插入和删除的标记类型');
3
  // return 语句使用默认标记类型
4
  return true;
5
}

自动换行#

自动换行

为每个块配置自动换行#

1
// 启用换行的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// wrap=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

配置换行的缩进#

1
// preserveIndent 示例（默认启用）
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// preserveIndent=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

可折叠部分#

可折叠部分


5 collapsed lines
1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate'
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
4

5
const engine = someBoilerplateEngine(evenMoreBoilerplate())
6

7
// 这部分代码默认可见
8
engine.doSomething(1, 2, 3, calcFn)
9

10
function calcFn() {
11
  // 您可以有多个折叠部分
3 collapsed lines
12
  const a = 1
13
  const b = 2
14
  const c = a + b
15

16
  // 这将保持可见
17
  console.log(`计算结果: ${a} + ${b} = ${c}`)
18
  return c
19
}
20

4 collapsed lines
21
// 直到块末尾的所有代码将再次被折叠
22
engine.closeConnection()
23
engine.freeMemory()
24
engine.shutdown({ reason: '示例样板代码结束' })

展开收起

行号#

行号

为每个块显示行号#

1
// 此代码块将显示行号
2
console.log('来自第2行的问候!')
3
console.log('我在第3行')

// 此块禁用行号
console.log('你好?')
console.log('抱歉，你知道我在第几行吗?')

更改起始行号#

5
console.log('来自第5行的问候!')
6
console.log('我在第6行')

Firefly 布局系统详解

Sat, 03 Jan 1970 00:00:00 GMT

📖 概述#

本文将详细介绍 Firefly 的各种布局模式、它们的特点、使用场景，以及不同布局组合的效果。

左侧边栏+列表布局

右侧边栏+网格布局

左侧边栏+三列网格布局

双侧边栏+列表布局

双侧边栏+网格布局

双侧边栏+网格瀑布流布局

一、侧边栏布局系统#

侧边栏是博客页面的重要组成部分，用于展示导航、分类、标签、统计信息等辅助内容。Firefly 支持两种侧边栏布局模式。

1.1 单侧边栏模式#

左侧边栏 (position: “left”)#

左侧边栏布局

右侧边栏 (position: “right”)#

右侧边栏布局

特点#

侧边栏固定在页面其中一侧
文章阅读区域体验更佳，更宽敞
更加简约，没有那么紧凑

适用场景#

传统博客风格
强调导航和分类的博客
需要突出用户资料的个人博客
内容为主，辅助信息次之的场景

Tip

可以通过showBothSidebarsOnPostPage配置是否在文章详情页显示双侧边栏

当position为left或right时开启此项后，文章详情页将显示双侧边栏，主页等其他页面保持单侧边栏

适用在只想用单侧栏，但在文章详情页想用对侧栏的目录等组件的场景

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "left", // 左侧边栏
4
  showBothSidebarsOnPostPage: true, // 是否在文章详情页显示双侧边栏
5
};

1.2 双侧边栏模式 (position: “both”)#

特点#

左右两侧同时存在侧边栏
主内容区域位于中间
最大化利用屏幕空间
可以展示更多辅助信息
适合宽屏显示器

布局结构#

双侧边栏+列表布局

双侧边栏+网格布局

适用场景#

宽屏桌面端浏览
信息密集型博客
需要展示大量辅助内容
专业性强的技术博客

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "both", // 双侧边栏

二、文章列表布局系统#

文章列表是博客首页和归档页的核心内容，Firefly 提供两种展示方式，并支持多种网格配置。

2.1 列表模式 (defaultMode: “list”)#

特点#

单列纵向排列
显示文章封面图
展示更多文章摘要
适合深度阅读

列表布局结构#

列表模式布局

优点#

✅ 视觉冲击力强，封面图吸引眼球
✅ 可以展示更多文章信息（摘要、标签等）
✅ 适合图片内容丰富的博客
✅ 移动端友好，单列更易阅读
✅ 兼容所有侧边栏配置（单侧、双侧）

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "list", // 列表模式
4
    allowSwitch: true,   // 允许用户切换
5
  },
6
};

2.2 网格模式 (defaultMode: “grid”)#

特点#

自适应列数，根据浏览器宽度自动调整
紧凑布局，信息密度高
适合快速浏览

自适应网格#

网格模式通过 columnWidth 配置卡片的最小宽度（单位 px），浏览器会根据容器可用宽度自动计算能容纳多少列。

网格布局

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "grid",
4
    allowSwitch: true,
5
    grid: {
6
      masonry: true,      // 开启瀑布流
7
      columnWidth: 320,   // 卡片最小宽度(px)，浏览器自动计算列数
8
    },
9
  },
10
};

2.3 瀑布流布局 (Masonry)#

Firefly 的网格模式内置了智能瀑布流布局支持，解决了网格布局中因图文混合文章导致的卡片高度不一致导致的空白问题。

瀑布流布局

智能排版：自动将卡片放置到最短的列，最大化利用垂直空间。
消除空白：通过绝对定位精确计算每个卡片的位置，让卡片紧贴上方卡片，消除垂直方向的空白间隙。
自适应列数：瀑布流同样根据 columnWidth 和容器宽度动态计算列数，无需固定配置。
配置灵活：您可以在 siteConfig.ts 中通过 postListLayout.grid.masonry 选项自由开启或关闭此功能。

三、布局组合指南#

Firefly 允许您自由组合侧边栏和文章列表布局。以下是各种组合的效果说明。

侧边栏模式	文章列表模式	推荐度	适用场景
单侧边栏	列表模式	⭐⭐⭐⭐⭐	摄影、设计、生活类博客，强调图片和沉浸感
单侧边栏	网格模式	⭐⭐⭐⭐⭐	技术、笔记类博客，平衡阅读与检索效率
双侧边栏	列表模式	⭐⭐⭐⭐⭐	需要展示大量侧边栏信息的站点
双侧边栏	网格模式	⭐⭐⭐⭐⭐	极客风格，追求最高信息密度

四、响应式布局行为#

Firefly 的布局系统具有智能的响应式设计，会根据屏幕尺寸自动调整。

为了保证最佳阅读体验，系统会在屏幕变窄时自动调整布局：

网格列数自动减少：网格模式的列数由 columnWidth 和容器宽度自动决定，屏幕越窄列数越少。
列表模式 -> 网格模式：当屏幕宽度小于 380px（超小屏设备）时，列表模式会自动切换为网格模式，以保证卡片内容的可读性。
双侧边栏 -> 单侧边栏：当屏幕宽度小于 1280px 时，会根据tabletSidebar配置显示单侧边栏，隐藏其中一个侧边栏，文章目录导航会切换成浮动目录导航。

五、常见问题#

Q1: 如何调整网格列数？#

A: 通过 columnWidth 配置卡片最小宽度即可。值越小，同等宽度下列数越多；值越大，列数越少。浏览器会自动根据可用宽度计算最佳列数。

六、总结#

Firefly 的布局系统给予了您更大的自由度，您都可以通过简单的配置实现。

我们建议您根据自己的内容类型和目标读者的设备偏好，尝试不同的组合，找到最适合您的博客形态。

Firefly 文章加密

Fri, 02 Jan 1970 00:00:00 GMT

这是一篇密码保护的示例文章，用于演示文章加密功能。

KaTeX 数学公式示例

Fri, 02 Jan 1970 00:00:00 GMT

本文展示了 Firefly 主题对 KaTeX 数学公式的渲染支持。

行内公式 (Inline)#

行内公式使用单个 $ 符号包裹。

例如：欧拉公式 eiπ+1=0e^{i\pi} + 1 = 0eiπ+1=0 是数学中最优美的公式之一。

质能方程 E=mc2E = mc^2E=mc2 也是家喻户晓。

块级公式 (Block)#

块级公式使用两个 $$ 符号包裹，会居中显示。

∫−∞∞e−x2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}∫−∞∞e−x2dx=πx=−b±b2−4ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}x=2a−b±b2−4ac

复杂示例#

矩阵 (Matrices)#

(abcd)(αβγδ)=(aα+bγaβ+bδcα+dγcβ+dδ)\begin{pmatrix} a & b \\ c & d \end{pmatrix} \begin{pmatrix} \alpha & \beta \\ \gamma & \delta \end{pmatrix} = \begin{pmatrix} a\alpha + b\gamma & a\beta + b\delta \\ c\alpha + d\gamma & c\beta + d\delta \end{pmatrix}(acbd)(αγβδ)=(aα+bγcα+dγaβ+bδcβ+dδ)

极限与求和 (Limits and Sums)#

∑n=1∞1n2=π26\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}n=1∑∞n21=6π2lim⁡x→0sin⁡xx=1\lim_{x \to 0} \frac{\sin x}{x} = 1x→0limxsinx=1

麦克斯韦方程组 (Maxwell’s Equations)#

∇⋅E=ρε0∇⋅B=0∇×E=−∂B∂t∇×B=μ0J+μ0ε0∂E∂t\begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\ \nabla \cdot \mathbf{B} &= 0 \\ \nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\ \nabla \times \mathbf{B} &= \mu_0\mathbf{J} + \mu_0\varepsilon_0\frac{\partial \mathbf{E}}{\partial t} \end{aligned}∇⋅E∇⋅B∇×E∇×B=ε0ρ=0=−∂t∂B=μ0J+μ0ε0∂t∂E

化学方程式 (Chemical Equations)#

\ceCH4+2O2−>CO2+2H2O\ce{CH4 + 2O2 -> CO2 + 2H2O}\ceCH4+2O2−>CO2+2H2O

符号	代码	渲染结果
Alpha	`\alpha`	α\alphaα
Beta	`\beta`	β\betaβ
Gamma	`\Gamma`	Γ\GammaΓ
Pi	`\pi`	π\piπ
Infinity	`\infty`	∞\infty∞
Right Arrow	`\rightarrow`	→\rightarrow→
Partial	`\partial`	∂\partial∂

Markdown 扩展功能

Thu, 01 Jan 1970 00:00:00 GMT

GitHub 仓库卡片#

您可以添加链接到 GitHub 仓库的动态卡片，在页面加载时，仓库信息会从 GitHub API 获取。

CuteLeaf

Firefly

Waiting for api.github.com...

00K

Waiting...

使用代码 ::github{repo="CuteLeaf/Firefly"} 创建 GitHub 仓库卡片。

1
::github{repo="CuteLeaf/Firefly"}

提醒框(Admonitions)配置#

Firefly 采用了 rehype-callouts 插件，支持了三种风格的提醒框主题：GitHub、Obsidian 和 VitePress。您可以在 src/config/siteConfig.ts 中进行配置：

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  // ...
3
  rehypeCallouts: {
4
    // 选项: "github" | "obsidian" | "vitepress"
5
    theme: "github",
6
  },
7
  // ...
8
};

注意：更改配置后需要重启开发服务器才能生效。

以下是各个主题支持的类型列表，每个主题风格和语法不同，可根据喜好选择。

1. GitHub 主题风格#

这是 GitHub 官方支持的 5 种基本类型。

GitHub

基本语法

1
> [!NOTE] NOTE
2
> 突出显示用户应该考虑的信息。
3

4
> [!TIP] TIP
5
> 可选信息，帮助用户更成功。
6

7
> [!IMPORTANT] IMPORTANT
8
> 用户成功所必需的关键信息。
9

10
> [!WARNING] WARNING
11
> 关键内容，需要立即注意。
12

13
> [!CAUTION] CAUTION
14
> 行动的负面潜在后果。
15

16
> [!NOTE] 自定义标题
17
> 这是一个带有自定义标题的示例。

展开收起

2. Obsidian 主题风格#

Obsidian 风格支持非常丰富的类型和别名。

点击展开 Obsidian 语法列表

1
> [!NOTE] NOTE
2
> 通用的笔记块。
3

4
> [!ABSTRACT] ABSTRACT
5
> 文章的摘要。
6

7
> [!SUMMARY] SUMMARY
8
> 文章的总结（同 Abstract）。
9

10
> [!TLDR] TLDR
11
> 太长不看（同 Abstract）。
12

13
> [!INFO] INFO
14
> 提供额外信息。
15

16
> [!TODO] TODO
17
> 需要完成的事项。
18

19
> [!TIP] TIP
20
> 实用技巧或提示。
21

22
> [!HINT] HINT
23
> 暗示（同 Tip）。
24

25
> [!IMPORTANT] IMPORTANT
26
> 重要信息（Obsidian 风格通常使用类似的图标）。
27

28
> [!SUCCESS] SUCCESS
29
> 操作成功。
30

31
> [!CHECK] CHECK
32
> 检查通过（同 Success）。
33

34
> [!DONE] DONE
35
> 已完成（同 Success）。
36

37
> [!QUESTION] QUESTION
38
> 提出问题。
39

40
> [!HELP] HELP
41
> 寻求帮助（同 Question）。
42

43
> [!FAQ] FAQ
44
> 常见问题（同 Question）。
45

46
> [!WARNING] WARNING
47
> 警告信息。
48

49
> [!CAUTION] CAUTION
50
> 注意事项（同 Warning）。
51

52
> [!ATTENTION] ATTENTION
53
> 引起注意（同 Warning）。
54

55
> [!FAILURE] FAILURE
56
> 操作失败。
57

58
> [!FAIL] FAIL
59
> 失败（同 Failure）。
60

61
> [!MISSING] MISSING
62
> 缺失内容（同 Failure）。
63

64
> [!DANGER] DANGER
65
> 危险操作警告。
66

67
> [!ERROR] ERROR
68
> 错误信息（同 Danger）。
69

70
> [!BUG] BUG
71
> 报告软件缺陷。
72

73
> [!EXAMPLE] EXAMPLE
74
> 展示一个例子。
75

76
> [!QUOTE] QUOTE
77
> 引用一段话。
78

79
> [!CITE] CITE
80
> 引证（同 Quote）。
81

82
> [!NOTE] 自定义标题
83
> 这是一个带有自定义标题的示例。

展开收起

Obsidian

3. VitePress 主题风格#

VitePress 风格提供了一套现代化的、扁平的默认样式。目前仅包含与 GitHub 一致的 5 种 基础类型。

点击展开 VitePress 语法列表

1
> [!NOTE] NOTE
2
> 对应 GitHub 的 Note。
3

4
> [!TIP] TIP
5
> 对应 GitHub 的 Tip。
6

7
> [!IMPORTANT] IMPORTANT
8
> 对应 GitHub 的 Important。
9

10
> [!WARNING] WARNING
11
> 对应 GitHub 的 Warning。
12

13
> [!CAUTION] CAUTION
14
> 对应 GitHub 的 Caution。
15

16
> [!TIP] 自定义标题
17
> VitePress 风格同样支持自定义标题。

展开收起

VitePress

4. Docusaurus 风格语法#

仅支持语法，风格保持跟上面三个主题相同。

点击展开 Docusaurus 语法列表

支持以下类型的提醒框：note tip important warning caution

1
:::note
2
突出显示用户应该考虑的信息，即使在快速浏览时也是如此。
3
:::
4

5
:::tip
6
可选信息，帮助用户更成功。
7
:::
8

9
:::important
10
用户成功所必需的关键信息。
11
:::
12

13
:::warning
14
由于潜在风险需要用户立即注意的关键内容。
15
:::
16

17
:::caution
18
行动的负面潜在后果。
19
:::
20

21
:::tip[自定义标题]
22
可选信息，帮助用户更成功。
23
:::

展开收起

剧透#

您可以为文本添加剧透。文本也支持 Markdown 语法。

内容被隐藏了哈哈！

1
内容 :spoiler[被隐藏了 **哈哈**]！

图片画廊网格 (Image Grid)#

您可以使用 [grid] 和 [/grid] 标签将多张图片纵向并排展示。这对于展示照片画廊或对比图非常有用。系统会自动根据包裹在其中的图片数量（最多支持并排展示4张）以响应式网格进行布局。

自动补齐图片高度： 同一排中如果有高度、大小或者比例不一的图片，会像「九宫格画廊相册」一样自动撑满。较短或不协调的图片会自动使用 object-cover 进行完美中心裁剪补充视野。图片边框水平彻底对齐无缝隙，但被裁剪后，只有点击图片通过灯箱才能查看完整图片，所以建议尽量避免使用长宽比例不一致的图片在同一排中。

图注恒定底端对齐： 不论上面的图片长宽如何变化，在同一行的所有图像解释文字（图注）都会对标到一条完美的水平基线上了。

示例图片一

示例图片二

基本语法

1
[grid]
2
![示例图片一](./images/firefly1.avif)
3
![示例图片二](./images/firefly2.avif)
4
![示例图片二](./images/firefly3.avif)
5
[/grid]

Markdown Mermaid 图表

Thu, 01 Jan 1970 00:00:00 GMT

Markdown 中 Mermaid 图表完整指南#

本文演示如何在 Markdown 文档中使用 Mermaid 创建各种复杂图表，包括流程图、时序图、甘特图、类图和状态图。

流程图示例#

流程图非常适合表示流程或算法步骤。

是

否

选项 1

选项 2

选项 3

子过程详情

子步骤 1

子步骤 2

子步骤 3

开始

条件检查

处理步骤 1

处理步骤 2

另一个决策

结果 1

结果 2

结果 3

结束

是

否

选项 1

选项 2

选项 3

子过程详情

子步骤 1

子步骤 2

子步骤 3

开始

条件检查

处理步骤 1

处理步骤 2

另一个决策

结果 1

结果 2

结果 3

结束

时序图示例#

时序图显示对象之间随时间的交互。

数据库服务器网页应用用户数据库服务器网页应用用户alt[认证成功][认证失败]提交登录请求发送认证请求查询用户凭据返回用户数据返回认证结果显示欢迎页面请求用户数据获取用户偏好返回偏好设置返回用户数据加载个性化界面显示错误消息提示重新输入

甘特图示例#

甘特图非常适合显示项目进度和时间线。

10/01 10/08 10/15 10/22 10/29 11/05 11/12 11/19需求分析 UI设计数据库设计原型创建后端开发前端开发单元测试集成测试用户验收测试生产环境部署发布设计阶段开发阶段测试阶段部署网站开发项目时间线

类图示例#

类图显示系统的静态结构，包括类、属性、方法及其关系。

写作

发表

拥有

属于

User

+String username

+String password

+String email

+Boolean active

+login()

+logout()

+updateProfile()

Article

+String title

+String content

+Date publishDate

+Boolean published

+publish()

+edit()

+delete()

Comment

+String content

+Date commentDate

+addComment()

+deleteComment()

状态图示例#

状态图显示对象在其生命周期中经历的状态序列。

提交

拒绝

批准

发布

归档

撤回

草稿

审核中

已批准

已归档

已发布

临时隐藏

恢复

活跃

隐藏

提交

拒绝

批准

发布

归档

撤回

草稿

审核中

已批准

已归档

已发布

临时隐藏

恢复

活跃

隐藏

饼图示例#

饼图非常适合显示比例和百分比数据。

46%30%15%6%3%网站流量来源分析搜索引擎直接访问社交媒体推荐链接其他来源

总结#

Mermaid 是在 Markdown 文档中创建各种类型图表的强大工具。本文演示了如何使用流程图、时序图、甘特图、类图、状态图和饼图。这些图表可以帮助您更清晰地表达复杂的概念、流程和数据结构。

要使用 Mermaid，只需在代码块中指定 mermaid 语言，并使用简洁的文本语法描述图表。Mermaid 会自动将这些描述转换为美观的可视化图表。

尝试在您的下一篇技术博客文章或项目文档中使用 Mermaid 图表 - 它们将使您的内容更加专业且更易理解！

Markdown PlantUML 图表

Thu, 01 Jan 1970 00:00:00 GMT

Markdown 中 PlantUML 图表指南#

PlantUML 是一种使用纯文本描述图表的工具。你只需要写一段结构化语法，就可以生成时序图、类图、用例图、活动图等常见工程图。

它特别适合写在技术博客和项目文档里：

图表和正文一起版本管理，便于协作与审阅
修改图只需要改文本，适合频繁迭代
能和 Markdown 无缝结合，保持文档统一

在 Firefly 中，plantuml 代码块会在构建阶段编码并生成服务器 SVG 地址，页面端再根据亮暗主题自动切换图源，并支持缩放、拖拽和全屏交互。

如果你想快速上手，可以记住这个最小模板：

活动图示例#

状态图示例#

用例图示例#

组件图示例#

部署图示例#

ER 图示例#

时序图示例（登录与刷新令牌）#

C4 风格容器图示例#

Markdown 教程

Thu, 01 Jan 1970 00:00:00 GMT

这是一个展示如何编写 Markdown 文件的示例。本文档汇总了核心语法与常见扩展（GFM）。

块级元素
- 段落与换行
- 标题
- 引用
- 列表
- 代码块
- 分割线
- 表格
内联元素
- 链接
- 强调
- 行内代码
- 图片
- 删除线
杂项
- 自动链接
- 反斜杠转义
内联 HTML

块级元素#

段落与换行#

段落#

HTML 标签：<p>

使用一个或多个空行分隔段落。（仅包含空格或制表符的行也视为空行。）

代码：

1
This will be
2
inline.
3

4
This is second paragraph.

预览：

This will be inline.

This is second paragraph.

换行#

HTML 标签：<br />

在行末添加两个或更多空格来产生换行。

代码：

1
This will be not
2
inline.

预览：

This will be not
inline.

标题#

Markdown 支持两种标题样式：Setext 与 atx。

Setext#

HTML 标签：<h1>，<h2>

使用等号 (=) 表示 <h1>、使用短横线 (-) 表示 <h2>，数量不限，作为“下划线”。

代码：

1
This is an H1
2
=============
3
This is an H2
4
-------------

预览：

This is an H1#

This is an H2#

atx#

HTML 标签：<h1>，<h2>，<h3>，<h4>，<h5>，<h6>

在行首使用 1-6 个井号 (#)，对应 <h1> 至 <h6>。

代码：

1
# This is an H1
2
## This is an H2
3
###### This is an H6

预览：

This is an H1#

This is an H2#

This is an H6#

可选：你可以在行尾“闭合” atx 标题。末尾的井号数量不必与开头一致。

代码：

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

预览：

This is an H1#

This is an H2#

This is an H3#

引用#

HTML 标签：<blockquote>

Markdown 使用邮件风格的 > 作为引用符号。若手动换行并在每行前加 >，显示效果最佳。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown 允许“偷懒”：在一个硬换行段落中，只在第一行前加 > 即可。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

引用可以嵌套（引用中的引用），通过增加 > 层级实现。

代码：

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

预览：

This is the first level of quoting.
This is nested blockquote.
Back to the first level.

引用内可包含其他 Markdown 元素，包括标题、列表与代码块。

代码：

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

预览：

This is a header.#

This is the first list item.

This is the second list item.

Here’s some example code:
1
return shell_exec("echo $input | $markdown_script");

列表#

Markdown 支持有序（数字）与无序（圆点）列表。

无序列表#

HTML 标签：<ul>

无序列表可使用 星号 (*)、加号 (+) 或 短横线 (-)。

代码：

1
*   Red
2
*   Green
3
*   Blue

预览：

Red
Green
Blue

等价于：

代码：

1
+   Red
2
+   Green
3
+   Blue

或者：

代码：

1
-   Red
2
-   Green
3
-   Blue

有序列表#

HTML 标签：<ol>

有序列表使用数字加英文句点：

代码：

1
1.  Bird
2
2.  McHale
3
3.  Parish

预览：

Bird
McHale
Parish

注意：像下面这样可能会“意外触发”有序列表：

代码：

1
1986. What a great season.

预览：

What a great season.

你可以用反斜杠转义 (\) 句点：

代码：

1
1986\. What a great season.

预览：

1986. What a great season.

列表中的缩进内容#

列表项里的引用#

在列表项内放置引用，需要将 > 符号整体缩进：

代码：

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

预览：

A list item with a blockquote:

This is a blockquote inside a list item.

列表项里的代码块#

在列表项内放置代码块，需要缩进两层——8 个空格或两个 Tab：

代码：

1
*   A list item with a code block:
2

3
        <code goes here>

预览：

A list item with a code block:
```
1
<code goes here>
```

嵌套列表#

代码：

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

预览：

A
- A1
- A2
B
C

代码块#

HTML 标签：<pre>

将代码块中的每行缩进至少4 个空格或1 个制表符。

代码：

1
This is a normal paragraph:
2

3
    This is a code block.

预览：

This is a normal paragraph:

1
This is a code block.

代码块会一直持续，直到遇到未缩进的行（或文末）。

在代码块内，与号 (&) 和尖括号 (< >) 会自动转为 HTML 实体。

代码：

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

预览：

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

下文的“围栏代码块”和“语法高亮”属于扩展语法，你也可以用它们来书写代码块。

围栏代码块#

使用成对的反引号围起来（如下所示），就不需要四空格缩进了。

代码：

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

预览：

Here’s an example:

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

语法高亮#

在围栏代码块后添加可选的语言标识，即可启用语法高亮（参见支持语言列表）。

代码：

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

预览：

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

分割线（水平线）#

HTML 标签：<hr /> 一行中放置三个或以上的短横线 (-)、星号 (*) 或下划线 (_)。符号之间允许有空格。

代码：

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

预览：

表格#

HTML 标签：<table>

这是扩展语法。

用竖线 (|) 分隔列，用短横线 (-) 分隔表头，使用冒号 (:) 指定对齐方式。

两侧的竖线 (|) 与对齐可选。用于表头分隔时，每列至少需要 3 个短横线。

代码：

1
| Left | Center | Right |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

预览：

Left	Center	Right
aaa	bbb	ccc
ddd	eee	fff

A	B
123	456

A	B
12	45

内联元素#

链接#

HTML 标签：<a>

Markdown 支持两种链接样式：行内链接与引用式链接。

行内链接#

行内链接格式：[文本](URL "标题")

标题可选。

代码：

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

预览：

This is an example inline link.

This link has no title attribute.

如果引用同一站点的本地资源，可以使用相对路径：

代码：

1
See my [About](/about/) page for details.

预览：

See my About page for details.

引用式链接#

可以预定义链接引用。定义格式：[id]: URL "标题"

标题同样可选。引用时使用：[文本][id]

代码：

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

预览：

This is an example reference-style link.

说明：

方括号中包含链接标识（不区分大小写，可在左侧缩进最多三格空格）；
随后是冒号；
再跟一个或多个空格（或 tab）；
然后是链接 URL；
URL 可选地用尖括号包裹；
可选地跟随标题属性，用引号或圆括号包裹。

以下三种定义等价：

代码：

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

如果使用空的方括号，则链接文本本身会作为名称。

代码：

1
[Google]: http://google.com/
2
[Google][]

预览：

Google

强调#

HTML 标签：<em>，<strong>

Markdown 使用 星号 (*) 或 下划线 (_) 表示强调。一个分隔符对应 <em>；两个分隔符对应 <strong>。

代码：

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

预览：

single asterisks

single underscores

double asterisks

double underscores

但如果两侧有空格，则会被视作普通字符而非强调语法。

你可以使用反斜杠进行转义：

代码：

1
\*this text is surrounded by literal asterisks\*

预览：

*this text is surrounded by literal asterisks*

行内代码#

HTML 标签：<code>

用反引号 (`) 包裹。

代码：

1
Use the `printf()` function.

预览：

Use the printf() function.

若行内代码中需要包含反引号字符，可使用多重反引号作为定界符：

代码：

1
``There is a literal backtick (`) here.``

预览：

There is a literal backtick (`) here.

行内代码两侧的定界符允许包含空格（开头一个、结尾一个），方便在代码起始或结尾放置反引号字符：

代码：

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

预览：

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片#

HTML 标签：<img />

Markdown 的图片语法与链接类似，支持行内与引用两种方式。

行内图片#

行内图片语法：![替代文本](URL "标题")

标题可选。

代码：

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

预览：

Alt text

说明：

一个感叹号 !；
后接方括号，放置图片的替代文本；
再接圆括号，内含图片 URL/路径，及可选的标题（引号包裹）。

引用式图片#

引用式图片语法：![替代文本][id]

代码：

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

预览：

Alt text

删除线#

HTML 标签：<del>

这是扩展语法。

GFM 增加了删除线语法。

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

杂项#

自动链接#

Markdown 支持一种便捷写法来创建“自动链接”（URL 与邮箱地址）：只需用尖括号将其包住即可。

代码：

1
<http://example.com/>
2

3
<address@example.com>

预览：

http://example.com/

address@example.com

GFM 会自动识别标准 URL 并转换为链接。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许使用反斜杠来转义那些本用于 Markdown 语法的特殊字符，使其按字面显示。

代码：

1
\*literal asterisks\*

预览：

*literal asterisks*

以下字符可通过反斜杠转义以按字面量输出：

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark

内联 HTML#

对于 Markdown 语法未覆盖的标记，直接使用原生 HTML 即可。无需特别声明从 Markdown 切换到 HTML，直接写标签就行。

代码：

1
This is a regular paragraph.
2

3
<table>
4
    <tr>
5
        <td>Foo</td>
6
    </tr>
7
</table>
8

9
This is another regular paragraph.

预览：

This is a regular paragraph.

Foo

This is another regular paragraph.

请注意：在块级 HTML 标签内不会处理 Markdown 语法。

与块级标签不同，在行内级标签内会处理 Markdown 语法。

代码：

1
<span>**Work**</span>
2

3
<div>
4
    **No Work**
5
</div>

预览：

Work

**No Work**

***

Markdown 教程

Thu, 01 Jan 1970 00:00:00 GMT

这是一个展示如何编写 Markdown 文件的示例。本文档汇总了核心语法与常见扩展（GFM）。

块级元素
- 段落与换行
- 标题
- 引用
- 列表
- 代码块
- 分割线
- 表格
内联元素
- 链接
- 强调
- 行内代码
- 图片
- 删除线
杂项
- 自动链接
- 反斜杠转义
内联 HTML

块级元素#

段落与换行#

段落#

HTML 标签：<p>

使用一个或多个空行分隔段落。（仅包含空格或制表符的行也视为空行。）

代码：

1
This will be
2
inline.
3

4
This is second paragraph.

预览：

This will be inline.

This is second paragraph.

换行#

HTML 标签：<br />

在行末添加两个或更多空格来产生换行。

代码：

1
This will be not
2
inline.

预览：

This will be not
inline.

标题#

Markdown 支持两种标题样式：Setext 与 atx。

Setext#

HTML 标签：<h1>，<h2>

使用等号 (=) 表示 <h1>、使用短横线 (-) 表示 <h2>，数量不限，作为“下划线”。

代码：

1
This is an H1
2
=============
3
This is an H2
4
-------------

预览：

This is an H1#

This is an H2#

atx#

HTML 标签：<h1>，<h2>，<h3>，<h4>，<h5>，<h6>

在行首使用 1-6 个井号 (#)，对应 <h1> 至 <h6>。

代码：

1
# This is an H1
2
## This is an H2
3
###### This is an H6

预览：

This is an H1#

This is an H2#

This is an H6#

可选：你可以在行尾“闭合” atx 标题。末尾的井号数量不必与开头一致。

代码：

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

预览：

This is an H1#

This is an H2#

This is an H3#

引用#

HTML 标签：<blockquote>

Markdown 使用邮件风格的 > 作为引用符号。若手动换行并在每行前加 >，显示效果最佳。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown 允许“偷懒”：在一个硬换行段落中，只在第一行前加 > 即可。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

引用可以嵌套（引用中的引用），通过增加 > 层级实现。

代码：

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

预览：

This is the first level of quoting.
This is nested blockquote.
Back to the first level.

引用内可包含其他 Markdown 元素，包括标题、列表与代码块。

代码：

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

预览：

This is a header.#

This is the first list item.

This is the second list item.

Here’s some example code:
1
return shell_exec("echo $input | $markdown_script");

列表#

Markdown 支持有序（数字）与无序（圆点）列表。

无序列表#

HTML 标签：<ul>

无序列表可使用 星号 (*)、加号 (+) 或 短横线 (-)。

代码：

1
*   Red
2
*   Green
3
*   Blue

预览：

Red
Green
Blue

等价于：

代码：

1
+   Red
2
+   Green
3
+   Blue

或者：

代码：

1
-   Red
2
-   Green
3
-   Blue

有序列表#

HTML 标签：<ol>

有序列表使用数字加英文句点：

代码：

1
1.  Bird
2
2.  McHale
3
3.  Parish

预览：

Bird
McHale
Parish

注意：像下面这样可能会“意外触发”有序列表：

代码：

1
1986. What a great season.

预览：

What a great season.

你可以用反斜杠转义 (\) 句点：

代码：

1
1986\. What a great season.

预览：

1986. What a great season.

列表中的缩进内容#

列表项里的引用#

在列表项内放置引用，需要将 > 符号整体缩进：

代码：

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

预览：

A list item with a blockquote:

This is a blockquote inside a list item.

列表项里的代码块#

在列表项内放置代码块，需要缩进两层——8 个空格或两个 Tab：

代码：

1
*   A list item with a code block:
2

3
        <code goes here>

预览：

A list item with a code block:
```
1
<code goes here>
```

嵌套列表#

代码：

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

预览：

A
- A1
- A2
B
C

代码块#

HTML 标签：<pre>

将代码块中的每行缩进至少4 个空格或1 个制表符。

代码：

1
This is a normal paragraph:
2

3
    This is a code block.

预览：

This is a normal paragraph:

1
This is a code block.

代码块会一直持续，直到遇到未缩进的行（或文末）。

在代码块内，与号 (&) 和尖括号 (< >) 会自动转为 HTML 实体。

代码：

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

预览：

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

下文的“围栏代码块”和“语法高亮”属于扩展语法，你也可以用它们来书写代码块。

围栏代码块#

使用成对的反引号围起来（如下所示），就不需要四空格缩进了。

代码：

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

预览：

Here’s an example:

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

语法高亮#

在围栏代码块后添加可选的语言标识，即可启用语法高亮（参见支持语言列表）。

代码：

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

预览：

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

分割线（水平线）#

HTML 标签：<hr /> 一行中放置三个或以上的短横线 (-)、星号 (*) 或下划线 (_)。符号之间允许有空格。

代码：

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

预览：

表格#

HTML 标签：<table>

这是扩展语法。

用竖线 (|) 分隔列，用短横线 (-) 分隔表头，使用冒号 (:) 指定对齐方式。

两侧的竖线 (|) 与对齐可选。用于表头分隔时，每列至少需要 3 个短横线。

代码：

1
| Left | Center | Right |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

预览：

Left	Center	Right
aaa	bbb	ccc
ddd	eee	fff

A	B
123	456

A	B
12	45

内联元素#

链接#

HTML 标签：<a>

Markdown 支持两种链接样式：行内链接与引用式链接。

行内链接#

行内链接格式：[文本](URL "标题")

标题可选。

代码：

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

预览：

This is an example inline link.

This link has no title attribute.

如果引用同一站点的本地资源，可以使用相对路径：

代码：

1
See my [About](/about/) page for details.

预览：

See my About page for details.

引用式链接#

可以预定义链接引用。定义格式：[id]: URL "标题"

标题同样可选。引用时使用：[文本][id]

代码：

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

预览：

This is an example reference-style link.

说明：

方括号中包含链接标识（不区分大小写，可在左侧缩进最多三格空格）；
随后是冒号；
再跟一个或多个空格（或 tab）；
然后是链接 URL；
URL 可选地用尖括号包裹；
可选地跟随标题属性，用引号或圆括号包裹。

以下三种定义等价：

代码：

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

如果使用空的方括号，则链接文本本身会作为名称。

代码：

1
[Google]: http://google.com/
2
[Google][]

预览：

Google

强调#

HTML 标签：<em>，<strong>

Markdown 使用 星号 (*) 或 下划线 (_) 表示强调。一个分隔符对应 <em>；两个分隔符对应 <strong>。

代码：

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

预览：

single asterisks

single underscores

double asterisks

double underscores

但如果两侧有空格，则会被视作普通字符而非强调语法。

你可以使用反斜杠进行转义：

代码：

1
\*this text is surrounded by literal asterisks\*

预览：

*this text is surrounded by literal asterisks*

行内代码#

HTML 标签：<code>

用反引号 (`) 包裹。

代码：

1
Use the `printf()` function.

预览：

Use the printf() function.

若行内代码中需要包含反引号字符，可使用多重反引号作为定界符：

代码：

1
``There is a literal backtick (`) here.``

预览：

There is a literal backtick (`) here.

行内代码两侧的定界符允许包含空格（开头一个、结尾一个），方便在代码起始或结尾放置反引号字符：

代码：

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

预览：

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片#

HTML 标签：<img />

Markdown 的图片语法与链接类似，支持行内与引用两种方式。

行内图片#

行内图片语法：![替代文本](URL "标题")

标题可选。

代码：

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

预览：

Alt text

说明：

一个感叹号 !；
后接方括号，放置图片的替代文本；
再接圆括号，内含图片 URL/路径，及可选的标题（引号包裹）。

引用式图片#

引用式图片语法：![替代文本][id]

代码：

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

预览：

Alt text

删除线#

HTML 标签：<del>

这是扩展语法。

GFM 增加了删除线语法。

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

杂项#

自动链接#

Markdown 支持一种便捷写法来创建“自动链接”（URL 与邮箱地址）：只需用尖括号将其包住即可。

代码：

1
<http://example.com/>
2

3
<address@example.com>

预览：

http://example.com/

address@example.com

GFM 会自动识别标准 URL 并转换为链接。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许使用反斜杠来转义那些本用于 Markdown 语法的特殊字符，使其按字面显示。

代码：

1
\*literal asterisks\*

预览：

*literal asterisks*

以下字符可通过反斜杠转义以按字面量输出：

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark

内联 HTML#

对于 Markdown 语法未覆盖的标记，直接使用原生 HTML 即可。无需特别声明从 Markdown 切换到 HTML，直接写标签就行。

代码：

1
This is a regular paragraph.
2

3
<table>
4
    <tr>
5
        <td>Foo</td>
6
    </tr>
7
</table>
8

9
This is another regular paragraph.

预览：

This is a regular paragraph.

Foo

This is another regular paragraph.

请注意：在块级 HTML 标签内不会处理 Markdown 语法。

与块级标签不同，在行内级标签内会处理 Markdown 语法。

代码：

1
<span>**Work**</span>
2

3
<div>
4
    **No Work**
5
</div>

预览：

Work

**No Work**

***

在文章中嵌入视频

Thu, 01 Jan 1970 00:00:00 GMT

只需从 YouTube 或其他平台复制嵌入代码，然后将其粘贴到 markdown 文件中。

1
---
2
title: 在文章中嵌入视频
3
published: 2023-10-19
4
// ...
5
---
6

7
<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allowfullscreen></iframe>