清风博客

OpenCode —— 用 AI Agent 重塑开发范式

Tue, 28 Apr 2026 00:00:00 GMT

一、OpenCode 是什么#

OpenCode 是一款 100% 开源的 AI 编程代理（AI Coding Agent），专为终端环境设计，被誉为”为终端而生的 AI 编程助手”。它由 Anomaly Innovations 公司开发，采用 MIT 开源协议，在短短数月内在 GitHub 斩获 95,000+ Star，月活跃用户超过 650,000。

与传统 IDE 插件（如 GitHub Copilot、Cursor）不同，OpenCode 是一款”生长”在终端里的 AI 编程工具。它不仅能补全代码，更能深度理解整个项目上下文、执行复杂重构任务、自动编写文档——本质上是一个具备自主行动力的智能编程伙伴。

OpenCode 提供三种使用形态：

形态	说明
CLI 终端版	通过命令行启动 TUI（终端用户界面），核心使用方式
桌面应用	提供独立 GUI 窗口，适合不习惯终端的用户
IDE 插件	支持 VS Code、Cursor 等主流编辑器

本文主要介绍 OpenCode 的终端版，其他形态的使用方法请参考官方文档。

二、核心特性与优势#

1. 独创的 Plan/Build 双模式#

OpenCode 最大的创新在于将编程任务分解为”规划”与”构建”两个阶段：

Plan 模式（架构师视角）：只分析不修改，扫描代码库、分析依赖关系，输出详细的实施计划
Build 模式（工程师视角）：基于确认的计划执行具体代码编写、文件修改、测试运行

这种”先想后做”的工作流，完美契合高级工程师的思维模式，避免了 AI 盲目改代码导致的问题。

2. 多模型自由切换#

支持 75+ 种大语言模型，包括但不限于：

OpenAI 系列：GPT-4o、o3-mini 等
Anthropic 系列：Claude 3.5 Sonnet、Claude 3.7 Sonnet 等
Google 系列：Gemini 2.0 Pro、Gemini 2.5 Flash 等
国产模型：DeepSeek-V4、GLM-5.1、MiniMax M2.7 等
本地模型：通过 Ollama、LM Studio 运行本地模型

3. 内置免费模型#

OpenCode 提供官方精选的 Zen 模型集合，包含多个免费模型，无需 API Key 即可直接使用，真正做到零成本上手。

Tip

内置的免费模型效果一般，建议在生产环境中使用付费模型API。

4. 上下文感知能力#

通过 /init 命令自动分析项目结构，生成 AGENTS.md 文件，让 AI 深入理解项目架构、编码规范和依赖关系。

5. 内置 LSP 支持#

深度集成 Language Server Protocol（语言服务器协议，LSP ），提供实时诊断、代码跳转、悬停提示、多语言智能支持，让 AI 不仅”读”文本，更能”理解”代码的语法结构。

6. MCP 服务器支持#

支持 Model Context Protocol，可连接外部数据源和工具（如数据库、文档检索、搜索等），无限扩展能力边界。

三、安装 OpenCode#

3.1 前置要求#

Node.js：确保已安装 Node.js（建议 18+ 版本）
npm：Node.js 包管理器，用于安装 OpenCode
Git：用于项目版本控制

3.2 安装方法#

安装 Node.js#

前往Node.js 官方下载页面 https://nodejs.org/en/download/ 下载并安装 Node.js（包管理器选择npm）。

对于Linux 用户，建议使用以下命令安装 Node.js：

Terminal window

1
sudo apt install node npm  # Debian系
2
paru -S node npm           # Fedora系
3
paru -S node npm           # Arch Linux

安装 OpenCode#

Terminal window

1
npm install -g opencode-ai

验证安装#

Terminal window

1
opencode --version

若输出版本号（如 1.1.19），表示安装成功。

四、首次配置与启动#

4.1 启动 OpenCode#

打开终端，输入以下命令启动 OpenCode：

Terminal window

1
opencode

看到如下界面，说明 OpenCode 已成功启动：

OpenCode

4.2 配置 AI 模型#

使用免费模型（无需配置）#

启动后输入以下命令查看免费模型：

1
/models

选择带有 Free 标识的模型即可零成本使用。

配置付费模型 API Key#

如需使用 OpenAI、Claude 等付费模型：

方法一：命令行配置

Terminal window

1
opencode auth login

方法二：TUI 内配置

1
/connect

按提示选择提供商、粘贴 API Key 即可。

配置第三方模型提供商#

在项目根目录创建 opencode.json 配置文件：

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "provider": {
4
    "myprovider": {
5
      "npm": "@ai-sdk/openai-compatible",
6
      "name": "Custom Provider",
7
      "options": {
8
        "baseURL": "https://api.example.com/v1",
9
        "headers": {
10
          "Authorization": "Bearer your_api_key"
11
        }
12
      },
13
      "models": {
14
        "model-name": {
15
          "name": "alias-name"
16
        }
17
      }
18
    }
19
  }
20
}

显示更多显示更少

4.3 项目初始化#

在项目目录内运行：

1
/init

OpenCode 将：

扫描当前目录的代码结构
创建 .opencode/ 配置目录
生成 AGENTS.md 文件（记录项目信息、编码规范、架构说明）

建议：将 AGENTS.md 提交到 Git 仓库，帮助团队成员共享 AI 上下文。

五、核心使用方式#

5.1 Plan 模式与 Build 模式#

OpenCode 通过 Tab 键 在两种模式间切换，右下角会显示当前模式指示器。

模式	功能	适用场景
Plan	只读分析，生成实施计划，不修改代码	需求分析、技术方案设计、代码审查
Build	全权限执行，实际编写和修改代码	功能开发、Bug 修复、代码重构

使用流程：

按 Tab 切换到 Plan 模式
描述你的需求，获取详细实施计划
审阅计划，补充细节或调整方向
按 Tab 切换回 Build 模式
让 OpenCode 执行代码变更

5.2 常用交互命令#

在 TUI 界面中，以 / 开头的斜杠命令是主要交互方式：

核心命令#

命令	说明	快捷键
`/init`	扫描项目，生成 `AGENTS.md` 文件	`Ctrl+X i`
`/plan`	进入规划模式（只读）	-
`/build`	进入构建模式（可编辑）	-

对话管理#

命令	说明	快捷键
`/new` / `/clear`	开始新对话	`Ctrl+X n`
`/sessions` / `/resume`	列出历史会话	`Ctrl+X l`
`/compact` / `/summarize`	压缩对话，节省 Token	`Ctrl+X c`
`/export`	导出对话为 Markdown	`Ctrl+X x`
`/share`	生成公开分享链接	`Ctrl+X s`

编辑与撤销#

命令	说明	快捷键
`/undo`	撤销 AI 上一次的修改	`Ctrl+X u`
`/redo`	重做被撤销的操作	`Ctrl+X r`

实用工具#

命令	说明	快捷键
`/models`	切换 AI 模型	`Ctrl+X m`
`/themes`	切换终端主题	`Ctrl+X t`
`/help`	显示帮助信息	`Ctrl+X h`
`/exit` / `/quit`	退出 OpenCode	`Ctrl+X q`

5.3 内置工具集#

OpenCode 的 AI Agent 通过以下工具操作代码库：

工具	功能说明
`bash`	执行 Shell 命令（如 `git status`、`npm test`）
`write`	创建新文件
`edit`	修改现有文件
`patch`	对文件打补丁
`read`	读取文件内容（支持指定行范围）
`grep`	在项目中搜索文本
`glob`	按模式匹配文件
`list`	列出目录内容（尊重 `.gitignore`）
`webfetch`	抓取网页内容（查文档）
`lsp`	代码跳转、悬停提示（实验性）
`question`	向用户提问确认
`todo`	维护任务清单

工具权限可在 opencode.json 中设置为 allow（允许）、deny（拒绝）或 ask（询问确认）。

六、实战示例#

6.1 创建项目并生成代码#

场景：快速创建一个 Express.js API 服务

Terminal window

1
# 步骤 1：创建项目目录
2
mkdir my-api && cd my-api
3
npm init -y
4

5
# 步骤 2：启动 OpenCode
6
opencode
7

8
# 步骤 3：初始化项目（生成 AGENTS.md 文件）
9
/init
10

11
# 步骤 4：描述需求
12
创建一个 Express.js 服务，支持 /hello 路由返回 JSON { message: 'Hello World' }，并添加 README 文档。

OpenCode 将自动：

安装 Express 依赖
创建 index.js 服务器代码
配置路由处理
生成项目 README

脚本化执行：

Terminal window

1
opencode -p "创建一个 React + TypeScript 项目，配置 Tailwind CSS"

6.2 解释与分析现有代码#

场景：理解复杂代码逻辑

1
# 引用文件并提问
2
文件 @src/auth.js 包含哪些功能？请解释其中的认证逻辑。
3

4
# 询问多个文件的关系
5
@src/services 目录下的各个模块是如何协作的？

使用 @ 符号引用项目中的文件或目录路径，OpenCode 会自动读取并分析。

6.3 代码重构与优化#

场景：重构登录模块

1
# 步骤 1：按 Tab 进入 Plan 模式
2

3
# 步骤 2：描述重构需求
4
重构 src/components/Login.tsx 组件：
5
1. 将表单逻辑提取为自定义 Hook
6
2. 添加更完善的错误处理
7
3. 优化性能，减少不必要的重渲染
8

9
# 步骤 3：审阅生成的计划
10

11
# 步骤 4：按 Tab 切换到 Build 模式，确认执行
12
听起来不错！请继续进行更改。

七、进阶功能#

自定义命令#

在 ~/.config/opencode/commands/ 目录创建 Markdown 文件：

Terminal window

1
mkdir -p ~/.config/opencode/commands/
2
cat > ~/.config/opencode/commands/prime-context.md << 'EOF'
3
请在每次回复前：
4
1. 检查项目的 coding style
5
2. 确保所有修改都有对应的测试覆盖
6
3. 遵循 TypeScript 严格模式
7
EOF

MCP 服务器配置#

通过 MCP 连接外部工具，在 opencode.json 中添加：

1
{
2
  "mcpServers": {
3
    "github": {
4
      "command": "npx",
5
      "args": ["-y", "@modelcontextprotocol/server-github"],
6
      "env": {
7
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token"
8
      }
9
    }
10
  }
11
}

多会话协作#

同时开启多个 Agent 处理不同任务：

1
/sessions          # 查看所有会话
2
/resume <id>       # 切换到指定会话

IDE 集成#

在 VS Code 中搜索安装 OpenCode 扩展，即可获得与终端版一致的 AI 辅助体验。

oh-my-opencode 扩展#

oh-my-opencode 是一个强大的多智能体扩展：

Sisyphus 主智能体：持续执行复杂任务直至完成
专业子智能体：Oracle（分析）、Librarian（文档）、Frontend Engineer（前端）等
多模型调度：自动分配任务给最适合的模型
关键词触发：在提示中加入 ultrawork 激活完整自动化模式

八、最佳实践与注意事项#

1. 给 AI 充足的上下文#

像指导团队中的初级开发者一样，提供：

清晰的需求描述
相关的代码示例
期望的输入/输出
约束条件和边界情况

2. 善用 Plan 模式做复杂任务#

对于涉及多文件修改的复杂需求，务必先使用 Plan 模式生成方案，确认后再切换到 Build 模式执行。这能大幅降低出错概率。

3. 定期压缩对话#

长对话会消耗大量 Token，定期使用 /compact 压缩历史，保持高效且低成本。

4. 版本控制敏感配置#

Terminal window

1
# 将 API Key 配置文件加入 .gitignore
2
echo "opencode.json" >> .gitignore
3

4
# AGENTS.md 可以提交到 Git
5
git add AGENTS.md
6
git commit -m "docs: add AI assistant context guide"

5. 保持 OpenCode 更新#

Terminal window

1
npm update -g opencode-ai

6. 图片输入#

OpenCode 支持将图片拖放到终端中作为输入，可用于：

参考 UI 设计稿生成代码
分析错误截图
解释流程图或架构图

九、常见问题排查#

问题	解决方案
安装后命令找不到	检查 Node.js 全局安装路径是否在 PATH 环境变量中
API Key 未生效	确认 `opencode.json` 格式正确，重启 OpenCode
本地模型连接失败	确认 Ollama 服务已启动，模型已下载
权限不足	Linux/macOS 尝试 `sudo opencode` 或检查目录权限
TUI 显示异常	升级终端模拟器到最新版本，推荐 WezTerm 或 Alacritty
Token 消耗过快	使用 `/compact` 压缩对话，或切换到免费模型
MCP 服务器报错	检查 MCP 配置格式，部分服务器会消耗大量 Token

十、总结#

OpenCode 代表了 AI 编程工具从”付费订阅”到”开源自主”的范式转移。它不仅提供了媲美商业工具（如 Claude Code）的强大能力，更赋予了开发者完全的控制权和自由度：

零成本起步：内置免费模型，无需信用卡
模型自由：75+ 模型随心切换，告别供应商锁定
开源可定制：MIT 协议，可自由修改和扩展
专业工作流：Plan/Build 双模式，“先规划后执行”

无论你是终端极客、全栈工程师，还是架构师，OpenCode 都能成为你提升开发效率的得力伙伴。

快速开始清单#

Terminal window显示更多显示更少

1
# 1. 安装
2
npm install -g opencode-ai
3

4
# 2. 验证
5
opencode --version
6

7
# 3. 进入项目目录
8
cd your-project
9

10
# 4. 启动
11
opencode
12

13
# 5. 初始化项目（生成 AGENTS.md 文件）
14
/init
15

16
# 6. 开始对话！

显示更多显示更少

参考资源#

官方网站：opencode.ai
中文文档：opencodecn.com/docs
GitHub 仓库：搜索 opencode-ai
下载页面：opencode.ai/download
oh-my-opencode：搜索 code-yeongyu/oh-my-opencode

本文基于 OpenCode 版本 1.14.25 编写，功能可能随版本迭代有所变化，建议参考官方文档获取最新信息。

深度优先搜索与广度优先搜索

Thu, 02 Apr 2026 00:00:00 GMT

什么是深度优先搜索与广度优先搜索#

深度优先搜索与广度优先搜索是经典的图遍历算法，用于在图中遍历或搜索节点。广泛应用于寻路算法、连通性分析、网页搜索/爬虫、图的遍历等场景。通常使用递归或者栈来实现深度优先搜索，使用队列来实现广度优先搜索。

深度优先搜索#

深度优先搜索（Depth-First Search，简称 DFS）是一种回溯思想的搜索算法，核心是：不撞南墙不回头，一条路走到黑，走不通再回溯换路。

核心步骤#

1
1. 从起点出发
2
2. 选择一个相邻且**未访问**节点，深入走下去
3
3. 直到无法继续前进（无路可走、到达目标、越界）
4
4. 立即回溯到上一个节点，尝试另一条未走的分支
5
5. 重复直到所有节点遍历完毕 / 找到目标

示例#

假设我们有一个无向图 G，如下图所示。

无向图G

假设我们从起点1开始，按号数较小优先的方法使用深度优先搜索遍历该图。

从起点1出发，首先访问1。
和1相邻的节点有2、3和4，选择2。
和2相邻的节点只有6，选择6。
和6相邻的节点有5和7，选择5。
由于5没有未访问的相邻节点，立即回溯到上一个节点6并继续访问6的另一个相邻节点7。
访问7的相邻节点3。
节点3没有未被访问的相邻节点，一直回溯到1，起点1还有一个相邻节点4，选择4。

由此，深度优先搜索的遍历顺序为：1 -> 2 -> 6 -> 5 -> 7 -> 3 -> 4。

算法实现#

C语言数组、指针与函数传参

Sat, 20 Dec 2025 00:00:00 GMT

前情提要#

1. 数组与二维数组#

数组是什么#

数组是一种数据结构，用于存储相同类型的多个元素。每个元素都有一个唯一的索引，用于访问和操作该元素。数组可以是一维的，也可以是二维的。数组中的数据在内存中是连续存储的，每个元素占用相同大小的内存空间。

二维数组#

二维数组是一种特殊的数组，它的每个元素都有两个索引（行和列），用于访问和操作该元素。二维数组可以看作是一个表格，每个元素都有一个行索引和一个列索引。二维数组中的数据在内存中也是连续存储的，每个元素占用相同大小的内存空间。

当然，也可以这样理解二维数组：二维数组是一个数组的数组，每个元素都是一个一维数组。每个一维数组都有自己的索引，用于访问和操作该数组中的元素。二维数组中的数据在内存中是连续存储的，每个元素占用相同大小的内存空间。

2. C语言函数的单个参数传递#

C语言函数的单个参数传递是按值传递的，即函数接收的是参数的值（右值），而不是参数本身（左值）。在定义函数时，参数的类型可以是基本数据类型（如int、float等），也可以是指针类型，称为形参（formal parameter）。在调用函数时，需要传递与形参形式相同的参数，称为实参（actual parameter）。

基本语法示例如下：

1
int func(int a, int *b) // 函数的定义，包含两个形式参数a和b
2
{
3
    return a + *b; // 注意：b是一个指针，需要使用解引用运算符*来访问它指向的值
4
}
5

6
int main()
7
{
8
    int a = 1, b = 2;
9
    int c = func(a, &b); // 调用函数func，将a和b的地址作为参数传递
10
    // ······
11
    return 0;
12
}

思考：那么数组作为数据的集合，在函数传参时，是否也按照按值传递的方式进行？

数组与指针#

数组名与指针#

数组名再部分场景可以看作是一个指向数组第一个元素的指针常量。假设我们定义了一个数组num[5], 那么num这个名字就可以看作是一个指向数组第一个元素的指针，即num == &num[0]。这种在表达式中数组名表示数组首元素的情况被称为数组的退化（decay）。

当然在一些场景中并不会退化，例如：

作为sizeof的操作数：sizeof(num)计算的是整个数组的字节大小（如int num[5]的sizeof(num)是5*4=20），而如果是指针int *p = num，sizeof(p)只是指针本身的大小（32 位系统 4 字节，64 位系统 8 字节）。
作为&取地址符的操作数：&num的类型是指向整个数组的指针（如int (*)[5]），而非指向首元素的指针（int *）。虽然&num和num的数值地址相同，但类型和步长完全不同（(&num)++会直接跳过整个数组）。
作为_Alignof（C11 起）的操作数：类似sizeof，针对整个数组的对齐属性。
字符串字面量初始化字符数组时：如char str[] = “hello”，这里的”hello”是数组初始化器，而非指针。

使用指针的方式读取数组元素#

对于一个指针p而言，对p自增 p++，可以使指针指向下一个相同大小的内存空间，即指向数组的下一个元素。前面提到，数组名相当于一个指向数组第一个元素的指针。因此，我们可以使用指针的方式来读取数组元素。

例如，假设我们定义了一个数组num[5], 那么我们可以使用指针p来读取数组元素，如下所示：

1
int num[5] = {1, 2, 3, 4, 5};
2
int *p = num; // 指针p指向数组num的第一个元素
3
printf("%d\n", *p); // 输出1
4
p++; // 指针p指向数组num的第二个元素
5
printf("%d\n", *p); // 输出2

换句话说，num[i] 可以看作是 *(num + i)，即指针num加上偏移量i，再解引用得到的结果。

但请注意，虽然C语言允许使用指针的方式来读取数组元素，但是不建议这样做，在实际编程中尽量使用数组下标来访问数组元素。因为使用指针来访问数组元素可能会导致指针越界访问，从而导致程序崩溃或安全问题。这里这样讲只是为了后文理解数组的函数传参问题。

二维数组与指针#

前面提到，二维数组是一个数组的数组，每个元素都是一个一维数组。那么，对于二维数组来说，它的名字也可以看作是一个指向数组第一个元素（即第一个一维数组）的指针（行指针）。以下内容提到的二维数组以 int num[3][4]为例。num 相当于 &num[0]。类型为 int (*)[4]，即指向一个包含4个int元素的数组的指针。

注意，前面提到一维数组名可以看作是一个指向数组第一个元素的指针，可能有一下误解：二维数组名也可以看作是一个指向第一个一维数组的第一个元素指针的指针，即 int **。这种理解并不正确，二者是完全不同的类型。int (*)[4]一般用于表示二维数组的行指针,int **则可以用来表示指向一个指针数组中某元素的指针（对int类型取两次地址 int a; int *p = &a; int **dp = &p也可以得到 int **类型的二级指针，但对其进行逻运算会导致未定义行为）。

二者在使用上的确很相似，例如解两次指针解引用都可以访问到二维数组的元素，解一次引用都能得到int *类型的指针。但是，对 int (*)[4]解引用的理解应该是解一次引用首先得到的是一个一维数组，但在表达式中一维数组退化为指向首元素的指针，即 int *。但试图把二维数组行指针（int (*)[4]）赋值给一个指向指针的指针（二级指针）（int **）是错误的。

1
int num[3][4] = {{1, 2, 3, 4}, {5, 6, 7, 8}, {9, 10, 11, 12}};
2
int (*p)[4] = num;
3
int **q = p; // 错误：类型不兼容

它们的最明显的不同之处在于指针进行逻辑运算时操作的步长不同。例如对 int (*)[4]类型的指针进行自增操作是，得到的是二维数组下一行的指针。int ** 可以用来指向一个一维指针数组的某个元素的地址，其自增操作是指向该指针数组的下一个元素的地址。可以结合以下代码来理解：

1
int num[3][4] = {{1, 2, 3, 4}, {5, 6, 7, 8}, {9, 10, 11, 12}};
2
int (*p)[4] = num; // 指针p指向二维数组num的第一个元素（即第一个一维数组）
3
printf("%d\n", *(*p + 1)); // 输出2
4
p++; // 指针p指向二维数组num的第二个元素（即第二个一维数组）
5
printf("%d\n", *(*p + 2)); // 输出7
6

7
int num2[6] = {1, 1, 4, 5, 1, 4};
8
int *ptr[6] = {num2, num2 + 1, num2 + 2, num2 + 3, num2 + 4, num2 + 5};
9
int **q = ptr;
10
printf("%d\n", *(*q + 1)); // 输出1
11
q++
12
printf("%d\n", *(*q + 2)); // 输出5

前半部分
- 二维数组在内存里是连续的 “数组的数组”，行指针（int (*p)[4]）指向二维数组的某一行，步长是一整行（4 个 int）。
- *(*p + 1)：先解引用行指针得到第一行的起始地址，地址加 1 指向第一行第二个元素，解引用就得到值 2。
- p++ 让行指针跳到第二行，*(*p + 2) 就是第二行起始地址加 2，指向第二行第三个元素，解引用得 7。
后半部分
- 指针数组（int *ptr[6]）的每个元素都是指向普通 int 数组的指针，二级指针（int **q）指向指针数组的元素，步长是一个指针的大小。
- *(*q + 1)：解引用二级指针得到指针数组第一个元素（指向普通数组第一个元素），地址加 1 指向普通数组第二个元素，解引用得 1。
- q++ 让二级指针跳到指针数组第二个元素，*(*q + 2) 就是从普通数组第二个元素的地址再跳 2 步，指向普通数组第四个元素，解引用得 5。

小结#

数组名不完全等价于指针，只是在多数表达式中退化为指向首元素的指针；
二维数组名退化后是行指针（int (*)[n]），而非二级指针（int **）；
指针的步长由其类型决定。

数组与传参#

一维数组的传参#

前面已经提到，数组名在表达式中会退化为指向首元素的指针，因此一维数组名可以作为函数参数传递。其传递过去的实际上是指向首元素的指针。

1
void func(int *arr, int size)  // 写法上*arr与arr[]是等价的，都表示指向int的指针而非一个数组
2
{
3
    for (int i = 0; i < size; i++) {
4
        printf("%d\n", arr[i]);
5
    }
6
}
7

8
int main()
9
{
10
    int num[5] = {1, 2, 3, 4, 5};
11
    func(num, 5); // 传递数组名num，实际传递的是指向num[0]的指针
12
    return 0;
13
}

传参后的“数组”实际上是一个指向首元素的指针，只是在函数内部被当作数组来使用。因此，在函数内部可以使用数组下标来访问元素，相当于对指针进行了偏移。也就是说传参后，形参并不包含数组的长度信息，需要额外传递数组长度作为参数。sizeof(arr)实际打印的是一个int类型指针的大小。

二维数组的传参#

二维数组名退化后是行指针（int (*)[n]），因此可以作为函数参数传递。其传递过去的实际上是指向首行的指针。

1
void func(int (*arr)[4], int row, int col) // (*arr)[4] == arr[][4]
2
{
3
    for (int i = 0; i < row; i++) {
4
        for (int j = 0; j < col; j++) {
5
            printf("%d\n", arr[i][j]);
6
        }
7
    }
8

9
    //也可以使用指针法遍历
10
    int *p = *arr; // p指向首行首元素
11
    for (int i = 0; i < row * col; i++) {
12
        printf("%d\n", *p++);
13
    }
14
}
15

16
int main()
17
{
18
    int num[3][4] = {{1, 2, 3, 4}, {5, 6, 7, 8}, {9, 10, 11, 12}};
19
    func(num, 3, 4); // 传递数组名num，实际传递的是指向num[0]的指针
20
    return 0;
21
}

显示更多显示更少

由于数组的每个元素大小都应该是确定的，而二维数组又可以看作是一维数组的数组，也就是说，直接传入二维数组的名字，在形参中列信息（每个一维数组长度）必须是确定的。那么假如我们要传入一个未知列数的二维数组，该怎么办呢？

例如下面一条代码同一个函数同时可以实现 2*2和 3*3的矩阵求和

1
int sum(int *num, int row, int col)
2
{
3
    int s = 0;
4
    for(int i = 0; i < row * col; i++) {
5
        s += num[i]; // 对指针进行偏移，相当于访问二维数组的元素
6
        // 等价于 s += (*(num + i));
7
    }
8
    return s;
9
}
10

11
int main()
12
{
13
    int m, n;
14
    int matrix1[2][2] = {{1, 2}, {3, 4}};
15
    int matrix2[3][3] = {{1, 2, 3}, {4, 5, 6}, {7, 8, 9}};
16
    printf("%d\n", sum(&matrix1[0][0], 2, 2));
17
    printf("%d\n", sum(&matrix2[0][0], 3, 3));
18
    return 0;
19
}

显示更多显示更少

小结#

从上文的描述不难看出，使用数组名字（或指针）传参时，函数内对数组元素的值的修改会直接影响原始数组，例如

1
void func(int *arr, int size)
2
{
3
    for (int i = 0; i < size; i++) {
4
        arr[i] *= 2; // 对指针进行偏移，相当于访问数组的元素
5
    }
6
}
7

8
int main()
9
{
10
    int num[5] = {1, 2, 3, 4, 5};
11
    func(num, 5); // 传递数组名num，实际传递的是指向num[0]的指针
12
    for (int i = 0; i < 5; i++) {
13
        printf("%d\n", num[i]); // 输出2 4 6 8 10
14
    }
15
    return 0;
16
}

显示更多显示更少

总结#

传参的本质
- 数组作为函数参数传递时，传递的不是整个数组，而是指向其首元素的指针。
- 函数内对数组元素的修改会直接影响原始数组（共享内存）。
一维数组传参
- 形参 int arr[] 和 int *arr 完全等价，都是指针。
- 函数内无法用 sizeof(arr) 获取数组长度，必须额外传递长度参数。
二维数组传参
- 二维数组名是行指针，类型为 int (*)[列数]，不是二级指针 int **。
- 形参必须指定列数（如 int arr[][4]），因为编译器需要知道每行的步长。
- 处理动态行列的二维数组时，可传入首元素地址（&arr[0][0]）并按一维数组计算偏移。
关键注意事项
- 数组名的退化：在多数表达式中，数组名退化为指针，但作为 sizeof 或 & 的操作数时代表整个数组。
- 指针步长由类型决定：int * 步长是一个 int，int (*)[4] 步长是一行（4个 int），int ** 步长是一个指针。
- 避免指针与数组的误用：理解类型差异，防止越界访问和类型不匹配的错误。

JetBrains IDEs 调参高手都在用的配置！

Fri, 19 Dec 2025 00:00:00 GMT

CLion部分转载自https://segmentfault.com/a/1190000047360502 PyCharm部分转载自https://segmentfault.com/a/1190000047360595 可能有小的修改

CLion 调参#

🏆🏆为什么别人的 CLion 运行 C/C++ 项目丝滑流畅，而你的却频繁卡顿、编译转圈？#

✅秘密就藏在这个 `clion.vmoptions`文件里！#

作为 IDEA/PyCharm/WebStorm/GoLand 调优系列的续集⏬#

🏅我把我压箱底的 CLion 性能调优参数表分享出来——包含 JVM 堆内存优化、垃圾回收策略、CMake 构建加速等关键设置;
💎还附上每项参数的详细注释（比如为什么 C/C++ 项目要调大堆内存？为什么优化编译线程？）。
🎉这套配置是我实测优化和见证了 10+ 个 C/C++ 小项目（含嵌入式/Linux 内核开发）的经验总结，尤其适合大型多文件工程、高频调试、跨平台构建的开发者。
🥇这是我的JetBrains全家桶调参系列最后一篇,其他PHP,Rust等参数你们自己去拓展;
⚠️ 重要提醒：修改前请备份原文件（路径在文末），避免配置冲突导致 IDE 闪退！下面直接上干货～

⏩路径说明->正常版本的在bin目录下 202x.x.x\bin 魔法型的大多数应该在C盘路径自己去找,这里不说明要不然被河蟹了💫 最后一行我就不贴了,魔法型的注意不要把你原来的那行路径替换了,要不然找不到路径别怪我没提醒你😁

根据电脑配置调整 → 内存大小、处理器核数、并发线程数需适配你的硬件。#

参数注释超详细，直接抄作业就能起飞～#

🔧 CLion 性能调优核心参数表（附简易注释）#

基础内存分配#

参数	值	作用说明	适用场景提示
`-Xms1024m`	初始堆内存 1GB	JVM 启动时预分配的初始堆内存，避免运行时频繁申请内存导致卡顿	轻量级项目（如小型 C/C++ 程序）可设 512m；中大型项目建议 ≥1GB
`-Xmx4096m`	最大堆内存 4GB	JVM 可使用的最大堆内存，直接影响 CLion 处理大型项目的编译/运行速度	物理内存 ≥8GB 的机器可设 4~6GB；4GB 内存机器建议 ≤3GB
`-XX:ReservedCodeCacheSize=1024m`	代码缓存 1GB	存储 JIT 编译后的热点代码，避免重复编译开销	代码量大/频繁热部署项目建议 ≥1G；小项目 512m 可满足
`-XX:+UseG1GC`	使用 G1 垃圾回收器	低延迟垃圾回收，平衡吞吐量与停顿时间，适合 CLion 频繁响应的场景	比传统 GC 更适合 IDE，减少卡顿感

垃圾回收与并行#

参数	值	作用说明	适用场景提示
`-XX:MaxGCPauseMillis=200`	最大 GC 停顿时间 200ms	控制垃圾回收时最大暂停时间，提升交互响应流畅度	值越低交互越流畅，但可能增加 GC 频率（200ms 是平衡点）
`-XX:ParallelGCThreads=8`	并行 GC 线程数 8	垃圾回收时使用的并行线程数（建议为 CPU 物理核心数的 1~1.5 倍）	4 核 CPU 可设 46；8 核及以上建议 810
`-XX:ConcGCThreads=4`	并发 GC 线程数 4	G1 垃圾回收的并发阶段线程数	通常设为 ParallelGCThreads 的一半（如 8 核对应 4）
`-XX:InitiatingHeapOccupancyPercent=45`	堆占用触发 GC 百分比 45%	当堆内存使用率达到 45% 时启动 GC，避免内存耗尽	默认值可能过高，调低可提前触发 GC，减少卡顿

调试与内存保护#

参数	值	作用说明	适用场景提示
`-XX:+HeapDumpOnOutOfMemoryError`	OOM 时生成堆转储文件	内存爆炸时自动保存快照，方便排查崩溃原因	必开！遇到卡死/崩溃时通过日志定位问题
`-XX:HeapDumpPath=$USER_HOME/clion_error.hprof`	堆转储文件路径	OOM 快照保存位置（用户目录下，避免覆盖其他 IDE 的 dump 文件）	自定义路径便于管理多个 IDE 的崩溃日志
`-XX:+AlwaysPreTouch`	启动时预分配内存	启动时预先分配所有堆内存，避免运行时动态分配卡顿	适合物理内存充足的机器（如 16GB+），提升启动稳定性
`-XX:-OmitStackTraceInFastThrow`	禁用快速抛异常优化	避免 JVM 对重复异常（如空指针）省略堆栈信息，方便排查报错根源	开发阶段必开！否则部分报错可能只有简单提示，难以定位

编译与性能优化#

参数	值	作用说明	适用场景提示
`-XX:TieredStopAtLevel=1`	编译优化层级 1	限制 JIT 编译优化层级，加快代码启动速度（牺牲部分峰值性能）	适合开发阶段频繁修改代码的场景，减少编译等待时间
`-XX:CICompilerCount=8`	JIT 编译器线程数 8	负责将热点代码编译为机器码的线程数，加速代码执行效率	多核机器（如 8 核以上）可适当调高（默认 2~4），提升编译速度
`-XX:SoftRefLRUPolicyMSPerMB=100`	软引用缓存策略 100ms/MB	控制软引用对象（如缓存）的存活时间（每 MB 堆内存保留 100ms）	提高常用代码/数据的缓存命中率，减少重复加载

编码与渲染#

参数	值	作用说明	适用场景提示
`-Dfile.encoding=UTF-8`	文件编码 UTF-8	确保读写代码文件时用 UTF-8，避免中文/特殊字符乱码（必开！）	处理多语言项目（如中英文混合代码）时必须开启
`-Dsun.jnu.encoding=UTF-8`	系统路径编码 UTF-8	解决 Windows 下中文目录（如 `D:\项目\CLion代码`）显示/操作乱码问题	中文系统用户建议开启
`-Dsun.io.useCanonCaches=false`	禁用规范路径缓存	避免文件路径解析缓存导致的异常（如网络映射盘符变动）	使用网络存储（如 NAS/SMB）或虚拟机共享目录时建议关闭
`-Djdk.attach.allowAttachSelf=true`	允许 JVM 自身附加	支持 IDE 内部工具（如热部署插件）动态附加到当前 JVM 进程	某些调试/热更新插件依赖此功能
`-Djdk.module.illegalAccess.silent=true`	静默模块非法访问	兼容旧版库（如非模块化 jar 包）的反射调用，避免因 Java 模块化限制报错	使用旧版依赖（如传统工具包）时建议开启

图形渲染#

参数	值	作用说明	适用场景提示
`-Dsun.java2d.d3d=true`	启用 Direct3D 渲染	使用 Direct3D 加速图形绘制（适合 Windows 显卡支持的场景）	Windows 用户若显卡支持 Direct3D，可开启提升界面流畅度
`-Dsun.java2d.opengl=false`	禁用 OpenGL 渲染	避免 OpenGL 渲染导致的兼容性问题（如部分显卡驱动异常）	若遇到 OpenGL 渲染故障（如界面闪烁），建议关闭
`-Dsun.java2d.renderer=sun.java2d.marlin.MarlinRenderingEngine`	Marlin 渲染引擎	替换默认渲染引擎，优化高分辨率屏幕的图形绘制性能	高分辨率显示器（如 4K 屏）建议开启

模块访问（兼容性）#

参数	值	作用说明	适用场景提示
`--add-opens=java.base/java.lang=ALL-UNNAMED`	开放 java.lang 包访问	允许插件反射访问 JDK 核心类库（如 java.lang.reflect），解决“非法访问”报错	若遇到插件（如代码分析工具）不生效，检查是否缺少此参数
`--add-opens=java.base/sun.nio.fs=ALL-UNNAMED`	开放 sun.nio.fs 包访问	支持插件对文件系统操作的反射调用（如处理符号链接/网络路径），提升兼容性	某些文件操作相关的插件（如远程开发工具）可能需要此权限

💥💥友情提醒,真正的.vmoptions参数内容最好不要带注释,容易芭比Q,必须纯净干净;
C和C++偏底层语言,内存设置相比之前几个可以减半,为什么减半,因为会跟抢系统资源;
XX=1 平时学习设置1,跑项目设置4,日常学习直接原地起飞🎉🎉非常重要! 以下是我的参数clion.vmoptions:

1
-Xms1024m
2
-Xmx4096m
3
-XX:ReservedCodeCacheSize=1024m
4
-XX:+UseG1GC
5

6
-XX:MaxGCPauseMillis=200
7
-XX:ParallelGCThreads=8
8
-XX:ConcGCThreads=4
9
-XX:InitiatingHeapOccupancyPercent=45
10

11
-XX:+HeapDumpOnOutOfMemoryError
12
-XX:HeapDumpPath=$USER_HOME/clion_error.hprof
13
-XX:+AlwaysPreTouch
14
-XX:-OmitStackTraceInFastThrow
15

16
-XX:TieredStopAtLevel=1
17
-XX:CICompilerCount=8
18
-XX:SoftRefLRUPolicyMSPerMB=100
19

20
-Dfile.encoding=UTF-8
21
-Dsun.jnu.encoding=UTF-8
22
-Dsun.io.useCanonCaches=false
23
-Djdk.attach.allowAttachSelf=true
24
-Djdk.module.illegalAccess.silent=true
25

26
-Dsun.java2d.d3d=true
27
-Dsun.java2d.opengl=false
28
-Dsun.java2d.renderer=sun.java2d.marlin.MarlinRenderingEngine
29

30
--add-opens=java.base/java.lang=ALL-UNNAMED
31
--add-opens=java.base/sun.nio.fs=ALL-UNNAMED
32
–这行应该是你的魔法型,正常的应该没有

显示更多显示更少

PyCharm 调参#

🏆为什么别人的 PyCharm 运行 TensorFlow 代码丝滑流畅，而你的却频繁卡顿、编译转圈？#

✅秘密就藏在这个 pycharm.vmoptions文件里！

今天我把压箱底的 Python 专用 IDE 性能调优参数表分享出来——✅#

🏅包含 9GB 堆内存、G1 垃圾回收器、6GB 堆外内存、OpenGL 加速渲染等关键设置，还附上每项参数的详细注释（比如为什么 Python 开发要调大堆内存？为什么禁用 Direct3D？）。#

🧤🧤这套配置是我实测优化了 20+ 个 Python 项目（含数据科学/机器学习场景）+IDEA的经验总结，尤其适合多库依赖、大型代码库、GPU 加速训练的开发者。
⚠️ 重要提醒：修改前请备份原配置！下面分享我的调优思路和完整参数表，帮你告别卡顿～”

路径说明->正常版本的在bin目录下 2024.1.4\bin 魔法型的大多数应该在C盘路径自己去找,这里不说明要不然被河蟹了💫💫 最后一行我就不贴了,魔法型的注意不要把你原来的那行路径替换了,要不然找不到路径别怪我没提醒你😁
pycharm参数相比IDEA简单一些->我自己日常天天都在用(速度超快)🚗🚗

🔧 PyCharm 性能调优核心参数表（附简易注释）#

参数	值	作用说明
`-Xms2048m`	初始堆内存 2GB	PyCharm 启动时预分配 2GB 内存，避免运行时频繁申请内存卡顿 (再高容易芭比Q,注意!!!)
`-Xmx9216m`	最大堆内存 9GB	PyCharm 最多使用 9GB 内存，适合大型 Python 项目（如深度学习/多库依赖）
`-XX:ReservedCodeCacheSize=2048m`	代码缓存 2GB	存储 JIT 编译后的热点代码，提升代码执行效率(再高容易芭比Q,注意!!!)
`-XX:MaxDirectMemorySize=6G`	直接内存上限 6GB	控制堆外内存（如科学计算库用的 Native 内存）最大值，避免系统资源耗尽
`-XX:+UseG2GC`	使用 G2 垃圾回收器	低延迟垃圾回收（JDK 9+ 默认），平衡吞吐量与卡顿，适合 PyCharm 长时间运行
`-XX:ParallelGCThreads=12`	并行 GC 线程数 12	垃圾回收时使用的并行线程数（建议为 CPU 核心数的 11.5 倍，如 8 核设 812）
`-XX:ConcGCThreads=6`	并发 GC 线程数 6	G2 垃圾回收的并发阶段线程数（通常为 ParallelGCThreads 的一半）
`-XX:+HeapDumpOnOutOfMemoryError`	OOM 时生成堆转储文件	内存爆炸时自动保存快照，方便排查崩溃原因
`-XX:HeapDumpPath=$USER_HOME/pycharm_error.hprof`	堆转储文件路径	OOM 时生成的内存快照保存位置（用户目录下，避免覆盖其他 IDE 的 dump 文件）
`-XX:ErrorFile=$USER_HOME/java_error_in_pycharm_%p.log`	JVM 错误日志路径	PyCharm 崩溃时的错误日志保存到用户目录（文件名含进程 ID，如 pycharm_1234.log）
`-Dfile.encoding=UTF-8`	文件编码 UTF-8	确保读写代码文件时用 UTF-8，避免中文/特殊字符乱码（必开！）
`-Dsun.jnu.encoding=UTF-8`	系统路径编码 UTF-8	解决 Windows 下中文目录（如 D:\项目\数据集）显示/操作乱码问题
`-Dsun.java2d.renderer=sun.java2d.marlin.MarlinRenderingEngine`	指定 Marlin 渲染引擎	优化高分辨率屏幕（如 4K 显示器）的图形绘制性能，替代默认渲染器
`-Dsun.java2d.marlin.doChecks=false`	关闭渲染额外检查	提升界面绘制速度（稳定版 PyCharm 可关，开发版若遇渲染问题可设为 true）
`-Dpython.console.encoding=UTF-8`	Python 控制台编码 UTF-8	确保 PyCharm 内置 Python 控制台（如运行 Jupyter Notebook）支持中文输出
模块访问权限（解决插件兼容问题）
`--add-opens=java.base/jdk.internal.org.objectweb.asm=ALL-UNNAMED`	开放 ASM 字节码包访问	允许插件（如 Lombok、科学计算工具链）反射访问 JDK 内部的 ASM 库（解决“非法访问”报错）
`--add-opens=java.base/jdk.internal.org.objectweb.asm.tree=ALL-UNNAMED`	开放 ASM 树结构包访问	支持插件对字节码树结构的反射操作（部分高级工具依赖此权限）

最终参数如下

1
-Xms2048m
2
-Xmx9216m
3
-XX:ReservedCodeCacheSize=2048m
4
-XX:MaxDirectMemorySize=6G
5
-XX:+UseG2GC
6
-XX:ParallelGCThreads=12
7
-XX:ConcGCThreads=6
8
-XX:+HeapDumpOnOutOfMemoryError
9
-XX:HeapDumpPath=\$USER_HOME/pycharm_error.hprof
10
-XX:ErrorFile=$USER_HOME/java_error_in_pycharm_%p.log
11
-Dfile.encoding=UTF-8
12
-Dsun.jnu.encoding=UTF-8
13
-Dsun.java2d.renderer=sun.java2d.marlin.MarlinRenderingEngine
14
-Dsun.java2d.marlin.doChecks=false
15
-Dpython.console.encoding=UTF-8
16
--add-opens=java.base/jdk.internal.org.objectweb.asm=ALL-UNNAMED
17
--add-opens=java.base/jdk.internal.org.objectweb.asm.tree=ALL-UNNAMED
18
--后两行应该是你的魔法型,正常的应该没有

显示更多显示更少

💥💥友情提醒,真正的.vmoptions参数内容最好不要带注释,容易芭比Q,必须纯净干净

💥💥再次提醒,根据自己的电脑配置适当调参增减,尤其内存大小,处理器核数,并发线程数
✅✅操作前记得备份原文件pycharm.vmoptions

链表数据结构

Thu, 18 Dec 2025 00:00:00 GMT

链表数据结构学习笔记#

1. 链表的基本概念#

链表是一种线性数据结构，由一系列节点（Node）组成，每个节点包含：
- 数据域 ：存储实际数据
- 指针域 ：存储指向下一个节点的引用
链表的特点：
- 动态数据结构，大小可灵活变化
- 内存非连续分配
- 插入/删除操作效率高（在已知位置时）
- 不支持随机访问

2. 链表与数组的对比#

特性	数组	链表
内存分配	连续内存块	非连续内存
大小	固定（静态）Ps. 例外：可变长数组（vector）	动态（可扩展）
访问方式	随机访问（O(1)）（下标）	顺序访问（O(n)）（顺着指针域的指向）
插入/删除	效率低（O(n)），需要挪动插入点后所有元素的位置	效率高（O(1)，已知位置），只需要指针的重新指向
内存效率	可能浪费或不足	按需分配，无浪费

3. 常见链表类型#

单链表：每个节点只有一个指向下一个节点的指针
双向链表：每个节点有两个指针，分别指向前一个节点和后一个节点
循环链表：最后一个节点的指针指向头节点，形成一个环

单链表的实现#

节点定义

1
struct ListNode {
2
    int val = 0;                // 数据域: 该节点要存储的值
3
    ListNode* next = nullptr;   // 指针域: 指向下一节点的指针
4
};

需要一个头节点来存储链表的头指针

1
ListNode* head = nullptr;

初始化链表

1
head = new ListNode();

完整示例
- 题目：用一个单链表来实现学生信息的存储和管理
- 代码

1
// 链表示例：用一个单链表来实现学生信息的存储和管理
2
#include <iostream>
3

4
// 定义学生信息结构体
5
struct Student {
6
    int id = 0;
7
    std::string name = "";
8
    int age = 0;
9
};
10

11
// 定义链表节点
12
struct ListNode {
13
    // 构造函数
14
    ListNode(const Student& student) : val(student) {}
15

16
    // 输出函数
17
    void print() const {
18
        std::cout << "ID: " << val.id << ", Name: " << val.name << ", Age: " << val.age << std::endl;
19
    }
20

21
    Student val;
22
    ListNode* next = nullptr;  // 指针默认置空
23
};
24

25
// 添加节点函数
26
void addNode(ListNode* &head, const Student& student) {
27
    if (head == nullptr) {
28
        head = new ListNode(student);
29
        return;
30
    }
31
    ListNode* temp = head;
32
    while (temp->next != nullptr) {
33
        temp = temp->next;
34
    }
35
    temp->next = new ListNode(student);
36
}
37

38
// 删除节点函数
39
void deleteNode(ListNode* &head, const int &id) {
40
    if (head == nullptr) {
41
        return;
42
    }
43
    // 删除头节点
44
    if (head->val.id == id) {
45
        ListNode* temp = head;
46
        head = head->next;
47
        delete temp;
48
        return;
49
    }
50
    // 删除非头节点
51
    ListNode* temp = head;
52
    while (temp->next != nullptr) {
53
        if (temp->next->val.id == id) {  // 找到要删除的节点
54
            ListNode* del = temp->next;
55
            temp->next = del->next;      // 前一个节点的next指向要删除节点的next
56
            delete del;                  // 删除的节点
57
            return;
58
        }
59
        temp = temp->next;
60
    }
61
}
62

63
int main() {
64
    ListNode* head = nullptr;
65
    // 添加节点
66
    addNode(head, {1001, "张三", 20});
67
    addNode(head, {1002, "李四", 21});
68
    addNode(head, {1003, "王五", 22});
69

70
    // 遍历链表打印全部信息
71
    ListNode* temp = head;
72
    while (temp != nullptr) {
73
        temp->print();
74
        temp = temp->next;
75
    }
76

77
    // 删除节点
78
    deleteNode(head, 1002);
79

80
    // 再次遍历链表打印全部信息
81
    temp = head;
82
    while (temp != nullptr) {
83
        temp->print();
84
        temp = temp->next;
85
    }
86

87
    return 0;
88
}

显示更多显示更少

在已编辑的Stm32Cube工程中添加外设

Thu, 18 Dec 2025 00:00:00 GMT

本文转载自 GitHub - Xuanzheng0901 <br> 可能有一些小的修改

在STM32 Hal库开发中，我们往往会遇到工程编辑到某个点后，需要添加新的外设的情况。这时候，我们可以按照以下步骤添加新的外设:

（以添加ADC为例）

在CubeMX中新生成一个工程,添加对应的外设
将新工程的 Src和 Inc目录下的对应外设文件(例: adc.c adc.h )拷贝到现有工程的 Core/Src 和 Core/Inc 中

在 cmake/stm32cubemx/CMakeLists.txt 中添加对应外设的源文件:

1
set(MX_Application_Src  # 对应Core/Src目录中的源文件
2
    ...
3
    ${CMAKE_CURRENT_SOURCE_DIR}/../Core/Src/adc.c
4
    ...
5
)

在 Core/Inc/stm32f4xx_hal_conf.h 中取消预编译选项注释,声明对应外设

1
...
2
#define HAL_ADC_MODULE_ENABLED  // 取消注释以在编译时启用ADC
3
...

在 Core/Inc/main.h 中包含对应外设的头文件
```
1
#include "adc.h"  // 包含ADC头文件
```

在 Core/Src/main.c 中添加对应外设的初始化函数

1
int main(void)
2
{
3
    ...
4
    MX_ADC_Init();  // 调用ADC初始化函数
5
    ...
6
}

添加用户文件教程:#

头文件加入到 Core/Inc 目录下即可自动被编译

源文件需要在 CmakeLists.txt 中添加:

1
set(MY_SOURCE  # 对应Core/Src目录中的源文件
2
    ...
3
    "Core/Src/app_main.c"
4
    ...
5
)
6

7
target_sources(${CMAKE_PROJECT_NAME} PRIVATE
8
    ${MY_SOURCE}
9
) # 添加用户源文件

注意事项:#

以上示例在CLion中操作,其他使用CMake构建项目的IDE也同理
如果要删除文件,务必在CmakeLists中删除对应的文件路径,否则会编译报错
更多基础教程参考 B站视频

KaTeX 数学公式示例

Thu, 02 Jan 2025 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)#

CHX4+2 OX2→COX2+2 HX2O\ce{CH4 + 2O2 -> CO2 + 2H2O}CHX4+2OX2COX2+2HX2O

符号	代码	渲染结果
Alpha	`\alpha`	α\alphaα
Beta	`\beta`	β\betaβ
Gamma	`\Gamma`	Γ\GammaΓ
Pi	`\pi`	π\piπ
Infinity	`\infty`	∞\infty∞
Right Arrow	`\rightarrow`	→\rightarrow→
Partial	`\partial`	∂\partial∂

Markdown 扩展功能

Wed, 01 Jan 2025 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[被隐藏了 **哈哈**]！

Markdown Mermaid 图表

Wed, 01 Jan 2025 00:00:00 GMT

Markdown 中 Mermaid 图表完整指南#

本文演示如何在 Markdown 文档中使用 Mermaid 创建各种复杂图表，包括流程图、时序图、甘特图、类图和状态图。

流程图示例#

流程图非常适合表示流程或算法步骤。

graph TD A[开始] --> B{条件检查} B -->|是| C[处理步骤 1] B -->|否| D[处理步骤 2] C --> E[子过程] D --> E subgraph E [子过程详情] E1[子步骤 1] --> E2[子步骤 2] E2 --> E3[子步骤 3] end E --> F{另一个决策} F -->|选项 1| G[结果 1] F -->|选项 2| H[结果 2] F -->|选项 3| I[结果 3] G --> J[结束] H --> J I --> J

时序图示例#

时序图显示对象之间随时间的交互。

sequenceDiagram participant User as 用户 participant WebApp as 网页应用 participant Server as 服务器 participant Database as 数据库 User->>WebApp: 提交登录请求 WebApp->>Server: 发送认证请求 Server->>Database: 查询用户凭据 Database-->>Server: 返回用户数据 Server-->>WebApp: 返回认证结果 alt 认证成功 WebApp->>User: 显示欢迎页面 WebApp->>Server: 请求用户数据 Server->>Database: 获取用户偏好 Database-->>Server: 返回偏好设置 Server-->>WebApp: 返回用户数据 WebApp->>User: 加载个性化界面 else 认证失败 WebApp->>User: 显示错误消息 WebApp->>User: 提示重新输入 end

甘特图示例#

甘特图非常适合显示项目进度和时间线。

gantt title 网站开发项目时间线 dateFormat YYYY-MM-DD axisFormat %m/%d section 设计阶段需求分析 :a1, 2023-10-01, 7d UI设计 :a2, after a1, 10d 原型创建 :a3, after a2, 5d section 开发阶段前端开发 :b1, 2023-10-20, 15d 后端开发 :b2, after a2, 18d 数据库设计 :b3, after a1, 12d section 测试阶段单元测试 :c1, after b1, 8d 集成测试 :c2, after b2, 10d 用户验收测试 :c3, after c2, 7d section 部署生产环境部署 :d1, after c3, 3d 发布 :milestone, after d1, 0d

类图示例#

类图显示系统的静态结构，包括类、属性、方法及其关系。

classDiagram class User { +String username +String password +String email +Boolean active +login() +logout() +updateProfile() } class Article { +String title +String content +Date publishDate +Boolean published +publish() +edit() +delete() } class Comment { +String content +Date commentDate +addComment() +deleteComment() } class Category { +String name +String description +addArticle() +removeArticle() } User "1" -- "*" Article : 写作 User "1" -- "*" Comment : 发表 Article "1" -- "*" Comment : 拥有 Article "1" -- "*" Category : 属于

状态图示例#

状态图显示对象在其生命周期中经历的状态序列。

stateDiagram-v2 [*] --> 草稿草稿 --> 审核中 : 提交审核中 --> 草稿 : 拒绝审核中 --> 已批准 : 批准已批准 --> 已发布 : 发布已发布 --> 已归档 : 归档已发布 --> 草稿 : 撤回 state 已发布 { [*] --> 活跃活跃 --> 隐藏 : 临时隐藏隐藏 --> 活跃 : 恢复活跃 --> [*] 隐藏 --> [*] } 已归档 --> [*]

饼图示例#

饼图非常适合显示比例和百分比数据。

pie title 网站流量来源分析 "搜索引擎" : 45.6 "直接访问" : 30.1 "社交媒体" : 15.3 "推荐链接" : 6.4 "其他来源" : 2.6

总结#

Mermaid 是在 Markdown 文档中创建各种类型图表的强大工具。本文演示了如何使用流程图、时序图、甘特图、类图、状态图和饼图。这些图表可以帮助您更清晰地表达复杂的概念、流程和数据结构。

要使用 Mermaid，只需在代码块中指定 mermaid 语言，并使用简洁的文本语法描述图表。Mermaid 会自动将这些描述转换为美观的可视化图表。

尝试在您的下一篇技术博客文章或项目文档中使用 Mermaid 图表 - 它们将使您的内容更加专业且更易理解！

Markdown 教程

Wed, 01 Jan 2025 00:00:00 GMT

这是一个展示如何编写 Markdown 文件的示例。本文档汇总了核心语法与常见扩展（GFM）。

块级元素
- 段落与换行
- 标题
- 引用
- 列表
- 代码块
- 分割线
- 表格
内联元素
- 链接
- 强调
- 行内代码
- 图片
- 删除线
杂项
- 自动链接
- 反斜杠转义
内联 HTML

<a id="block-elements"></a>

块级元素#

<a id="paragraphs-and-line-breaks"></a>

段落与换行#

段落#

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.

<a id="headers"></a>

标题#

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#

<a id="blockquotes"></a>

引用#

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:
return shell_exec(“echo input∣input | input∣markdown_script”);

<a id="lists"></a>

列表#

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:

<code goes here>

嵌套列表#

代码：

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

预览：

A
- A1
- A2
B
C

<a id="code-blocks"></a>

代码块#

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
``   function test() {       console.log("notice the blank line before this function?");     }   ``

预览：

Here’s an example:

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

语法高亮#

在围栏代码块后添加可选的语言标识，即可启用语法高亮（参见支持语言列表）。

代码：

1
``ruby     require 'redcarpet'     markdown = Redcarpet.new("Hello World!")     puts markdown.to_html     ``

预览：

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

<a id="horizontal-rules"></a>

分割线（水平线）#

HTML 标签：<hr /> 一行中放置三个或以上的短横线 (-)、星号 (*) 或下划线 (_)。符号之间允许有空格。

代码：

1
* * *
2
***
3
*****

- - -
___

预览：

<a id="table"></a>

表格#

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

<a id="span-elements"></a>

内联元素#

<a id="links"></a>

链接#

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][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/](http://example.com/)  "Optional Title Here"

如果使用空的方括号，则链接文本本身会作为名称。

代码：

1
[Google][Google]: http://google.com/
2
[Google][Google]

预览：

Google

<a id="emphasis"></a>

强调#

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*

<a id="code"></a>

行内代码#

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`

<a id="images"></a>

图片#

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][img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

预览：

Alt text

<a id="strikethrough"></a>

删除线#

HTML 标签：<del>

这是扩展语法。

GFM 增加了删除线语法。

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

<a id="miscellaneous"></a>

杂项#

<a id="automatic-links"></a>

自动链接#

Markdown 支持一种便捷写法来创建“自动链接”（URL 与邮箱地址）：只需用尖括号将其包住即可。

代码：

1
[http://example.com/](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

<a id="backslash-escapes"></a>

反斜杠转义#

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

<a id="inline-html"></a>

内联 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**
2

3
`<div>`
4
    **No Work**
5
`</div>`

预览：

<span>Work

**No Work**

***

清风博客

OpenCode —— 用 AI Agent 重塑开发范式

一、OpenCode 是什么#

二、核心特性与优势#

1. 独创的 Plan/Build 双模式#

2. 多模型自由切换#

3. 内置免费模型#

4. 上下文感知能力#

5. 内置 LSP 支持#

6. MCP 服务器支持#

三、安装 OpenCode#

3.1 前置要求#

3.2 安装方法#

安装 Node.js#

安装 OpenCode#

验证安装#

四、首次配置与启动#

4.1 启动 OpenCode#

4.2 配置 AI 模型#

使用免费模型（无需配置）#

配置付费模型 API Key#

配置第三方模型提供商#

4.3 项目初始化#

五、核心使用方式#

5.1 Plan 模式与 Build 模式#

5.2 常用交互命令#

核心命令#

对话管理#

编辑与撤销#

实用工具#

5.3 内置工具集#

六、实战示例#

6.1 创建项目并生成代码#

6.2 解释与分析现有代码#

6.3 代码重构与优化#

七、进阶功能#

自定义命令#

MCP 服务器配置#

多会话协作#

IDE 集成#

oh-my-opencode 扩展#

八、最佳实践与注意事项#

1. 给 AI 充足的上下文#

2. 善用 Plan 模式做复杂任务#

3. 定期压缩对话#

4. 版本控制敏感配置#

5. 保持 OpenCode 更新#

6. 图片输入#

九、常见问题排查#

十、总结#

快速开始清单#

参考资源#

深度优先搜索与广度优先搜索

什么是深度优先搜索与广度优先搜索#

深度优先搜索#

核心步骤#

示例#

算法实现#

C语言数组、指针与函数传参

前情提要#

1. 数组与二维数组#

数组是什么#

二维数组#

2. C语言函数的单个参数传递#

数组与指针#

数组名与指针#

使用指针的方式读取数组元素#

二维数组与指针#

小结#

数组与传参#

一维数组的传参#

二维数组的传参#

小结#

总结#

JetBrains IDEs 调参高手都在用的配置！

CLion 调参#

🏆🏆为什么别人的 CLion 运行 C/C++ 项目丝滑流畅，而你的却频繁卡顿、编译转圈？#

✅秘密就藏在这个 clion.vmoptions文件里！#

作为 IDEA/PyCharm/WebStorm/GoLand 调优系列的续集⏬#

根据电脑配置调整 → 内存大小、处理器核数、并发线程数需适配你的硬件。#

✅秘密就藏在这个 `clion.vmoptions`文件里！#

今天我把压箱底的 Python 专用 IDE 性能调优参数表分享出来——✅#

🏅包含 9GB 堆内存、G1 垃圾回收器、6GB 堆外内存、OpenGL 加速渲染等关键设置，还附上每项参数的详细注释（比如为什么 Python 开发要调大堆内存？为什么禁用 Direct3D？）。#