在使用 C++ 写命令行工具的时候，需要解析输入的参数，该库就是为这一解析工作提供一个方便快捷的方案。

2.0 使用

该项目仅包含一个头文件 include "cmdline.h"

以下是一个简单示例

#include <iostream>
#include "cmdline/cmdline.h"

int main(int argc, char *argv[]){
    /* 创建一个命令解析器 */
    cmdline::parser options;

    /*  1op -> 长名称
     *  2op -> 短名称 / 如果没有短名写 '\0'
     *  3op -> 解释
     *  4op -> 是否必填
     *  5op -> 默认值，仅在 4op 为 false 的时候生效
     */
    options.add<std::string>(
        "host",
        'h',
        "host name",
        true,
        "");

    // range -> 可以用于限制输入值范围
    options.add<int>(
        "port",
        'p',
        "port number",
        false,
        80,
        cmdline::range(1, 65535));

    // oneof 限制参数的可选值
    options.add<std::string>(
        "type",
        't',
        "protocol type",
        false,
        "http",
        cmdline::oneof<std::string>("http", "https", "ssh", "ftp"));

    // 可以定义 bool 值
    options.add("gzip", '\0', "gzip when transfer");

    /* 执行解析器 */
    options.parse_check(argc, argv);

    std::cout << "input type -> " << options.get<std::string>("type") << std::endl;
    std::cout << "input host -> " << options.get<std::string>("host") << std::endl;
    std::cout << "input port -> " << options.get<int>("port") << std::endl;

    // bool 值仅能通过 exist() 方法判断
    if (options.exist("gzip")){
        std::cout << "gzip enable" << std::endl;
    }else{
        std::cout << "gzip disable" << std::endl;
    }


    return 0;
}

传入定义好的参数即可看到效果

可以输出帮助消息

END 参考与引用

[参考文章]

• 【C++】cmdline —— 轻量级的C++命令行解析库

Markdown是一种轻量级的标记语言，可用于在纯文本中添加格式化元素。Markdown由John Gruber于2004年创建，如今是世界上最受欢迎的标记语言之一。

2.0 专注于文字内容。

纯文本，易于书写，可以方便的纳入版本控制。
语法简单，学习成本低。
Markdown与Word类编辑器不同。在Word之类的应用程序中，通过点击按钮设置相关的语法和格式，并且更改立即可见。而Markdown与此不同，创建了Markdown格式的文件，在文本中添加Markdown语法，用于指示哪些单词和短语看起来有所不同。

3.0 Markdown 的优势

Markdown无处不在，主流的代码托管平台：Github、GitLab、Gitee等均支持Markdown语法，很多开源项目的README、开发文档、帮助文档、Wiki等都是用Markdown写作。
Markdown是纯文本，可移植的，几乎可以使用任何文本编辑器打开Markdown文件。
Markdown是独立于平台的，任何操作系统和设备上均可以使用Markdown格式的文本。
Markdown创建的文件读取，不会受到软件、系统更新的迭代影响，即使你无法读取Markdown的格式，依然可以通过阅读纯文本的方式获取Markdown中的信息。

4.0 Markdown 的作用

Markdown 是做笔记、为网站创建内容、生成可打印文档的快速，简便的方法。
学习Markdown语法并不需要很长时间，一旦你学会了使用方法，就可以在几乎任何地方使用。

5.0 语法速查表

5.1 基本语法

5.2 拓展语法

以下的元素为 Markdown 的拓展语法，并非所有 Markdown 解释器都支持这些元素。

END 参考与引用

• Markdown 官方教程

在介绍 RAID 的历史之前，先一句话描述一下什么是 RAID 存储：独立磁盘冗余阵列（RAID）是一种存储技术，通过将复数个存储设备，例如硬盘驱动器（HDD）或固态硬盘（SSD）合并成一个协调的存储单元或阵列，从而获得一些单块存储介质无法轻易达到的优势。

1.1 RAID 的历史

1988 年，美国加州大学伯克利分校的 D.A.Patterson 教授等首次在论文中提出了 RAID 的概念；廉价冗余磁盘阵列 (Redundant Array of Indexpensive Disks) 由于当时大容量存储设备价格比较昂贵，RAID 的思想就是用多个容量较小、相对廉价的存储设备进行组合，从而得到昂贵大容量存储设备相同的容量、性能等。

随着时代的发展存储设备早已不再昂贵，因此 RIAD 也在发展中变为了用于为现代存储设备提供冗余的一种解决方案，即独立磁盘冗余阵列。

根据存储设备组成方式和性能的不同，RAID 分为很多类别：RAID0、RAID1、RAID5 等。从实现角度来看 RAID 主要分为软 RAID 和 硬 RAID 以及软硬混合 RAID 三种；顾名思义，软 RAID 所有功能均有操作系统和 CPU 来完成，没有独立的 RAID 控制 / 处理芯片和 I/O 处理芯片，效率自然最低。硬 RAID 配备了专门的 RAID 控制 / 处理芯片和 I/O 处理芯片以及阵列缓冲，不占用 CPU 资源，但成本很高。软硬混合 RAID 具备 RAID 控制 / 处理芯片，但缺乏 I/O 处理芯片，需要 CPU 和驱动程序来完成，性能和成本 在软 RAID 和硬 RAID 之间。

2.0 RAID 0

[原理]

RAID 0使用数据条带化（striping）的方式将数据分散存储在多个磁盘驱动器上，而不进行冗余备份。数据被分成固定大小的块，并依次存储在每个磁盘上。例如，如果有两个驱动器（驱动器A和驱动器B），一块数据的第一个部分存储在驱动器A上，第二个部分存储在驱动器B上，以此类推。这种条带化的方式可以同时从多个驱动器读取或写入数据，从而提高系统的性能。

[适用场景&优缺点]

RAID 0 具有高性能，即通过数据条带化和并行读写操作，使得 RAID0 可以提供更快的数据传输速度并且成本低廉，因为 RAID0 并不需要像其余 RAID 方式一样需要空间进行冗余备份，所有的空间均可以用于存储相同成本下可用存储空间相对较多；但是如上文所言由于数据条带化和没有冗余存储空间，导致了 RAID0 最为致命的问题就是一旦任意存储设备损坏则阵列上的所有数据都将受到影响。

因此 RAID0 针对视频编辑&处理等对数据传输速度要求并且不关心数据冗余的场景中适合适用。

3.0 RAID 1

[原理]

[适用场景&优缺点]

END 参考与引用

• 完全图解RAID存储技术：RAID 0、1、5、6、10、50、60
• RAID技术全解图解-RAID0、RAID1、RAID5、RAID100

本文使用环境为 Debian12&GNOM43.9 故可以使用 apt 安装。

$ sudo apt install minicom

2.0 快速使用

通过 minicom -D <port_device> -b <baud_rate> 即可快速连接至串口。

按下键盘会直接发送数据（默认不显示输入的内容）

按下 ctrl + A 后按下 X 退出程序。

使用 ls /dev/tty* 即可查询可用串口。

3.0 常用命令&参数

在使用过程中 ctrl + A Z 打开帮助。

常用的命令如下 ctrl + A +

• X：退出程序。
• W：开启&关闭自动换行。
• E：开启&关闭输入现实。
• C：清屏。

在调用 minicom 时可以传入一下参数调整程序运行效果。

• -D：指定串口设备
• -b：设置波特率，默认 115200
• -w：启用自动换行
• -H：使用 HEX 方式显示接收到的数据
• -s：设置 minicom

END 参考 & 声明

[参考]

• CSDN:Linux笔记：串口通讯工具minicom基础使用

1.1 何为分布式版本管理？

在探讨什么是分布式版本管理前，我们先了解什么是版本管理系统：版本管理系统（Version Control System，VCS）是一种帮助软件开发者管理代码变更的工具。它记录了项目文档或源代码文件的所有修改历史，允许团队成员查看项目的任何版本、恢复到以前的状态，或者在不同版本之间进行比较。这有助于提高开发效率，确保即使在多人协作时也能保持工作的组织性和可追踪性。

而在了解了何为版本管理系统之后，现在主流的版本管理系统大致可以分为两类：集中式和分布式。

集中式版本控制系统（Centralized Version Control Systems, CVCS）如Subversion (SVN)，有一个单一的服务器存放所有的版本数据，客户端从这个中心仓库拉取最新代码，并提交更新回服务器。它的优点是简单直接，但缺点是一旦服务器出现问题，可能会导致无法访问历史版本。

分布式版本控制系统（Distributed Version Control Systems, DVCS）如Git，没有单一的中心仓库；相反，每个用户的工作副本也是一个完整的仓库，包含了全部的历史版本信息。这意味着即使没有网络连接，开发者也可以提交更改、查看历史记录等。DVCS提供了更高的灵活性和可靠性，因为数据分布在多个节点上，减少了单点故障的风险。

1.2 在项目中引入版本管理的好处

通常在开发项目的时候，事由团队若干人配合完成的，而团队内不同开发者之间的项目版本不一，在统一开发进度和成员互相交流之间都是一件麻烦的事情，版本管理系统提供了若干功能，极大的提升了协作开发效率：

• 历史记录和回滚：版本控制系统记录了每一次变更的详细信息，包括谁做了更改、何时做的更改以及为什么做这些更改（通过提交消息）。如果最新代码出现了问题，可以方便地回滚到之前的稳定版本。
• 分支管理：开发者可以在不影响主线（主分支）的情况下创建新的分支进行功能开发、实验或错误修复。这使得多个开发者可以同时在一个项目上工作而不会相互干扰，并且在完成工作后可以将分支合并回主线。
• 协同工作：允许多个开发者同时处理同一项目的不同部分，并且能够有效地合并各自的工作。这样大大提高了团队合作的效率，减少了由于代码覆盖或丢失所造成的风险。
• 版本控制和发布管理：帮助团队更好地组织软件的开发周期，明确区分哪些功能属于哪个版本，便于规划发布计划。同时，在需要时可以快速定位并恢复特定版本的代码。
• 提高代码质量：通过代码审查（Code Review）等实践，鼓励团队成员之间互相检查代码，有助于发现潜在的问题，提高整体代码质量。
• 备份和恢复：版本控制系统本身也是一种形式的备份机制。即使本地环境出现问题，也可以从远程仓库中恢复项目的所有历史版本。

2.0 Git 配置

在正式使用 Git 进行版本控制之前，需要先对其进行配置；Git 提供了一个命令 git config 其可以用来配置和读取对应的工作环境变量，这些环境变量决定了 Git 在各个环节的具体工作方式和行为。

2.1 用户信息

配置用户名称和电子邮件地址，方便在每次提交代码时记录提交者的信息。

git config --global user.name "JRNitre"
git config --global user.email "email@email.com"

使用该 config 命令即可配置用户名和电子邮件地址，其中通过增加 --global 命令可以使当前配置作用于全局，反之配置则会仅对当前 Git 仓库生效。

2.2 文本编辑器

Git 默认使用的文本编辑器是 Vi 或者 Vim，可以通过如下命令进行配置。

git config --global core.editor "code --wait"

2.3 差异分析工具

此部分复制于 菜鸟教程

还有一个比较常用的是，在解决合并冲突时使用哪种差异分析工具。比如要改用 vimdiff 的话：

git config --global merge.tool vimdiff

Git 可以理解 kdiff3，tkdiff，meld，xxdiff，emerge，vimdiff，gvimdiff，ecmerge，和 opendiff 等合并工具的输出信息。

当然，你也可以指定使用自己开发的工具。

2.4 查看配置信息

使用 git config --list 命令查询：

2.5 生成 SSH 密钥

如果你需要通过 SSH 对远程进行 Git 操作，可是生成 SSH 密钥并添加到你的 Git 托管服务中。

ssh-keygen -t rsa -b 4096 -C "email@email.com"

3.0 创建 Git 仓库

3.1 git init 初始化

Git 的大部分命令需要在 Git 仓库中进行，在想要创建仓库的目录内使用 git init 命令初始化一个仓库。

或者指定需要创建仓库的目录 git init neorepo。

初始化后，目标目录下会出现一个名为 .git 的目录（默认系统状态不显示），Git 的所有资源和数据都存储在这个目录中。

3.2 git clone 从现有的仓库中拷贝

git clone <repo>

这里的目录也可以是远程仓库目录：

git clone git://github.com/xxx/xxx.git

如果需要克隆至指定的目录 <directory>

git clone <repo> <directory>

4.0 Git 的提交与修改

4.1 git add 将文件纳入版本控制系统

通过 git add 指定需要的文件，即可将文件纳入版本控制系统中，此时 Git 会追踪这些文件的变化。

git add *.c
git add README.md

git add 命令可以一次提交多个文件到暂存区中：

git add file1 file2

或者添加指定目录到暂存区：

git add [dir]

或者直接将当前目录下所有文件添加到暂存区中：

git add .

4.2 git commit 提交暂存区文件到本地仓库

在添加需要纳入版本控制系统的文件后，使用 git commit 命令即可提交到仓库中。

git commit -m [message]

这里的 [message] 可以是一些信息。

在 Linux 中提交信息使用单引号，Windows 中使用双引号。

还可以指定文件进行提交：

git commit [file1] [file2] -m [message]

通过 -a 参数可以跳过 git add 直接提交修改：

git commit -a

4.3 git status 查看仓库状态

使用 git status 命令可以查看仓库状态，其可以查看到距离上次提交后是否有文件修改。

通过追加 -s 命令可以获得更简短的输出。

4.4 git reset 回退版本

如果当前版本的开发出现了问题等，需要回退到版本库中指定的版本时，可以使用 git reset 命令回退至指定的版本。

git reset [--soft&--mixed&--hard] [HEAD]

其中 --mixed 为默认参数可以不加，这类参数功能我们先按下不表，通常可以如下方法使用该命令：

# 回退到上一个版本
git reset HEAD^
# 回退指定文件到上一个版本
git reset HEAD^ hello.md
# 回退到指定版本
git reset 052e

其中默认的 --mixed 参数意为：用于重置暂存区的文件与上一次提交保持一致，工作区文件内容保持不便。

4.4.1 --soft 参数

而通过 --soft 命令可以回退到指定的提交版本，它仅对提交历史（commit）有影响、，不会影响当前工作区的文件；例如在从工作区向暂存区提交代码后，此时如果新增加了文件，并且发现了某一次 commit 的内容发现了错误需要修改则可以使用 --soft 命令：

如下，创建了 3 个文件并且提交三次：



此时如果增加了第四个文件并且发现第二次提交的文件有问题需要修改，此时可以使用 git reset --soft 进行版本回退：

git reset --soft [版本号]



此时提交状态便回到了第二次提交的状态中，对文件进行修改并再次提交：

--soft 的根本作用相当于告诉 HEAD 指针移动到指定的版本，并对其进行修改，后续的提交是基于此版本的新分支。

5.0 Git 分支管理

Git 的分支实际上是指向快照的指针，通过分支系统，可以在不干扰主线的同时进行开发。

5.1 git checkout 基本分支管理

5.1.1 切换分支

通过基本的 checkout 命令即可实现不同分支之间的切换：

git checkoout <branchName>

当切换了不同的分支后，git 会自动将工作目录替换为切换的分支最后提交的快照。

5.1.2 -b 创建分支

通过 -b 参数，可以创建一个分支：

git checkout -b <branchName>

5.2 git branch 查询分支

5.2.1 git branch 查询所有分支

通过基本的 branch 命令即可查询当前仓库的所有分支：

git branch

5.2.2 -r 查询远程分支

git branch -r

5.2.3 -a 查询所有本地分支和远程分支

git branch -a

5.3 git branch 删除分支

5.3.1 -d 删除本地分支

git branch -d <branchName>

5.3.2 -D 强制删除未合并的分支

git branch -D <branchName>

5.3.3 删除远程分支

git push origin -delete <branchName>

5.4 git merge 合并分支

将指定的分支合并至当前分支：

git merge <branchName>

解决合并冲突 [待编写]

6.0 Git 远程仓库操作

6.1 添加远程仓库

通过 remote 命令，可以指定一个简短的名字用于替代远程仓库地址。

git remote add [shortName] <url>

6.2 查看当前正在使用的远程仓库

git remote

加上 -v 命令可以查询到每个别名所对应的链接地址。

git remote -v

使用 remove 可以删除已有的远程仓库地址。

git remote remove <name>

6.3 提取远程仓库

6.3.1 git fetch 从远程仓库下载新分支与数据

git fetch

6.3.2 git merge 从远程仓库提取数据并尝试合并到当前分支

git merge

6.3.3 实际操作中两指令的用法

通常，想在已经配置好的远程仓库中获取数据，可以首先执行 git fetch 获取本地没有的资源，然后使用 git merge 将更新合并到当前分支。

6.4 git pull 推送远程分支

git pull [shortName] [branchLocel]:[branchServer]

上述命令可以将本地指定分支推送到远程指定分支。

X.0 Git 其他命令用法

END 声明

文章参考菜鸟教程 | Git

其他参考网址/附件下载

文章声明

• 文章部分内容采用 AI 辅助生成

在 Linux 下，通过 make 命令即可实现通过 Makefile 文件定义的规则自动化执行任意命令（包括编译）。

即通过一个命令一个文件即可实现预定义好的任意操作。

1.1 规则

Makefile 由若干条规则（Rule）构成，每条规则指出一个目标文件（Target），若干依赖文件（Prerequisites），以及生成目标文件的命令。

例如，如果需要生成文件 m.txt 其由 a.txt 和 b.txt 合并而来，则有如下规则：

# 目标文件：依赖文件 1 依赖文件 2
m.txt: a.txt b.txt
    cat a.txt b.txt > m.txt

第一行定义了一条规则，第二行通过tab规定了一条命令，使用 cat 合并两个文件，其中 # 开头的为注释 make命令会忽略。

在 makefile 中命令必须使用 tab 定义，空格定义的无效。

由于 make 执行时默认执行第一条规则，所以仿照上述的方法可以写出第二个规则：

x.txt: m.txt c.txt
    cat m.txt c.txt > x.txt

m.txt: a.txt b.txt
    cat a.txt b.txt > m.txt

此时在系统内某一文件夹创建 a.txt、b.txt、c.txt，输入一些内容执行 make：

make 默认执行第一条规则，在创建 x.txt 的时候发现 m.txt 不存在，因此先执行规则 m.txt 创建 m.txt 文件，再执行规则 x.txt 。

综上可见，Makefile 定义了一系列的规则，在每个规则满足目标的前提下执行命令，就能创建出一个目标文件。

在编写 Makefile 的时候把默认执行的规则放在第一条，其它的规则顺序无关紧要，因为 make 在执行的时候会自行判断依赖。

此外 make 会打印出每一条执行的命令，便于观察执行顺序。

在上述 make 命令执行完毕后再次执行 make 后，输出如下：

$ make
make: “x.txt”已是最新。

make 检测到 x.txt 为最新的版本，无需再次执行，因为 x.txt 的创建时间晚于它依赖文件的最后修改时间。

可见，make 使用文件的创建和修改时间来判断是否该更新一个目标文件。

如果修改任意依赖文件后，再次执行 make 命令即可触发 x.txt 的更新。

假设修改了 c.txt 文件，则执行 make 命令后会触发 x.txt 的更新，并不会触发 m.txt 的更新，因为 m.txt 的依赖文件并没有变化，所以，make 会根据 Makefile 执行必要的规则，并非无脑执行所有规则。

在编译大型程序时，完全编译一次往往需要几十分钟甚至数小时，若每次对文件修改后都要执行完全编译则太过于浪费时间，Makefile 的存在即可大幅节省编译时间。

当然，对于 Makefile 是否能高效的完成增量更新，取决于规则书写的是否正确，make 本身并不会检查规则逻辑是否正确。

1.2 伪目标

在上述的例子中，m.txt 和 x.txt 是自动生成的文件，所以可以安全地删除。

但是如果我们希望自动删除，则可以编写一个 clean 规则来删除它们：

clean:
    rm -f m.txt
    rm -f x.txt

clear 命令，与上面所用的命令不同，其没有依赖文件，因此需要执行 clean 命令时必须在命令行使用命令 make clean

值得注意的是，如果在执行 clean 的时候，目录下并没有 clean 文件，每次执行 make clean 命令时都会执行 Makefile 中这个规则的命令。

所以，如果目录下有一个名为 clean 的文件，则此时 Makefile 中的 clean 规则就不会执行了！

如果目录下既需要 clean 文件，还想正常使用 Makefile 文件的 clean 规则，则可以添加一个标识：

.PHONY: clean
clean:
    rm -f m.txt
    rm -f x.txt

此时的 clean 就不会被视为一个文件，而是伪目标（Phony Target）

在大型项目中约定俗成下将：clean、install 这些视为伪目标名称，方便用户快速执行对应的任务。

一般不会有人在目录下创建名为 clean 的文件，除非有人蓄意搞破坏。

1.3 执行多条命令

1.4 控制打印

1.5 控制错误

1.6 小结

编写 Makefile 就是编写一系列的规则，用来告诉 make 该如何执行这些规则，从而生成我们最终需要的文件。

本文所使用安装环境：Debian 12、Gnome

由于 apt 等包管理器自带的 neovim 版本较老，因此使用新版 neovim 需要自行安装。

2.0 安装

2.1 移除旧版 neovim （如有）

sudo remove neovim

2.2 下载新版安装包

前往 Github 下载最新版本安装包至本地（截止至本文日期最新版本为： 10.4）

sudo wget https://github.com/neovim/neovim/releases/download/v0.10.4/nvim-linux-x86_64.tar.gz

2.3 解压并移动

sudo tar -zxvf nvim-linux64.tar.gz

sudo mv nvim-linux64 /usr/local/win

2.4 创建软链接

sudo ln -s /usr/local/nvim/bin/nvim /usr/bin/nvim

3.0 检查安装版本

neovim -v