编程与工具 on ICCI

Git 协作工作流最佳实践

Wed, 18 Feb 2026 00:00:00 +0000

分支策略#

我们团队采用 Trunk-Based Development 的变体：

分支	用途	生命周期
`main`	生产环境	永久
`develop`	开发集成分支	永久
`feature/*`	功能开发	1-3 天
`hotfix/*`	紧急修复	几小时
`release/*`	发布准备	1 周

Commit 规范#

采用 Conventional Commits：

<type>(<scope>): <subject>

<body>

常用 type：

feat — 新功能
fix — 修复 Bug
docs — 文档变更
refactor — 重构
test — 测试用例
chore — 构建/工具

示例#

feat(auth): 添加 JWT 登录验证

使用 jsonwebtoken 库实现无状态认证，
Token 有效期 24 小时，支持 refresh 机制。

Pull Request 流程#

fork — 从 develop 创建 feature 分支
commit — 小步提交，保持 commit 原子性
rebase — git rebase develop 保持历史整洁
push — 推送并创建 PR
review — 至少一人 Code Review
squash merge — 合并到 develop

Code Review 清单#

代码逻辑是否正确？
是否有边界情况未处理？
命名是否清晰？
是否有必要的测试？
是否引入性能问题？

小结#

好的 Git 习惯能让团队协作效率翻倍。核心是 小步提交 + 清晰的 commit message + 及时的 Code Review。

Verilog 实例demo

Sun, 11 May 2025 00:00:00 +0000

用一个简单的例子来介绍verilog的用法

TOC {:toc}

verilog概述#

Verilog能够在多种抽象级别对数字逻辑系统进行描述，Verilog的设计初衷是成为一种基本语法与C语言相近的硬件描述语言。当前广泛使用的硬件描述语言包括VHDL以及Verilog HDL（VHSIC Hardware Description Language）；同时verilog还衍生出了一些变种语言如System Verilog、Verilog-AMS等等，丰富了Verilog语言的应用场景。

不同语言在芯片设计上的主流场景

verilog语言和VHDL语言功能基本相同，在目前的项目上可以支持混用，但是VHDL的语法上更加严格一些，verilog语言更倾向于C语言，如果是入门学习，作者个人认为学习verilog语言就足够了，学完了Verilog语言基本就能看懂VHDL程序的意思。

实例#

话不多说，先看看verilog程序整什么样： Verilog程序一般分为程序和测试程序（一般习惯叫Testbench），测试程序会依据程序的功能尽可能的覆盖多的场景。

verilog程序实例#

// and2x模块：实现两个输入信号的与逻辑
module and2x(
 input a, // 输入信号a
 input b, // 输入信号b
 output r // 输出信号r，等于a和b的与逻辑结果
);
 // 由于a和b已经定义为input，这里不需要再次定义wire
 // wire a, b, r; 这行代码是多余的，应该删除

 // assign语句将a和b的与逻辑结果赋值给输出r
 assign r = a & b;
endmodule

verilog testbench程序实例#

再看看verilog程序的测试程序长什么样子

`timescale 1ns / 1ps

module tb_and2x;

 // 定义信号
 reg a;
 reg b;
 wire r;

 // 实例化 and2x 模块
 and2x uut (
 .a(a),
 .b(b),
 .r(r)
 );

 // 测试过程
 initial begin
 // 初始化输入
 a = 0;
 b = 0;
 #10; // 等待 10ns

 // 测试第一个条件
 a = 1;
 b = 0;
 #10; // 等待 10ns

 // 测试第二个条件
 a = 0;
 b = 1;
 #10; // 等待 10ns

 // 测试第三个条件
 a = 1;
 b = 1;
 #10; // 等待 10ns

 // 测试结束
 $finish;
 end

 // 监控输出
//end 
 initial begin
 $dumpfile("out.vcd");
 // This will dump all signal, which may not be useful
 //$dumpvars;
 // dumping only this module
 //$dumpvars(1, testbench);
 // dumping only these variable
 // the first number (level) is actually useless
 $dumpvars(0, testbench);
end 

endmodule

verilog有什么用#

数字芯片设计流程

Verilog 语法篇

Sun, 11 May 2025 00:00:00 +0000

verilog语法的基本认识

TOC {:toc}

前言#

verilog的语法入门篇

数据类型#

reg（寄存器）：
用于存储逻辑电路中的状态变量，可以通过赋值操作进行更新。其用法类似于其他编程语言中的变量，但不同的是，在 Verilog 中，reg类型的变量可以不仅可以存储数字和布尔值，还可以存储多位二进制数（也可以存储 ASCII 字符）。
integer（整数）：
用于存储整数类型的变量，可以进行加减乘除等基本算术运算。其范围为 -2^31 到 2^31 - 1。
real（实数）：
用于存储浮点数类型的变量，可以进行基本的算术运算和一些特殊的数学函数运算。其精度和范围可能因实现而异。
time（时间）：
用于存储时间类型的变量，可以表示电路中的时间间隔，通常以纳秒为单位。在仿真过程中，时间变量可以用于控制模拟过程的进行。
event（事件）：
用于在电路中表示事件，可以通过事件触发器（Event Trigger）来控制模块的行为。
parameter（参数）：
用于在模块内部定义常量，其值在模块实例化时被确定。在模块中，参数可以用于配置模块的行为。

除了上述的变量类型之外，Verilog 中还有其他一些变量类型，如bit、byte、logic等，它们的具体用法和特点可能略有不同。在实际设计中，可以根据需要选择和使用适当的变量类型来实现设计。

数值表示#

verilog是面向数字电路的编程语言，数值的表示更侧重于二进制的方式，和C语言会有一些区别。

数据种类#

Verilog HDL 有下列四种基本的值来表示硬件电路中的电平逻辑：

0：逻辑 0 或 “假”
1：逻辑 1 或 “真”
x 或 X：未知
z 或 Z：高阻

x 意味着信号数值的不确定，即在实际电路里，信号可能为 1，也可能为 0。
z 意味着信号处于高阻状态，常见于信号（input, reg）没有驱动时的逻辑结果。例如一个 pad 的 input 呈现高阻状态时，其逻辑值和上下拉的状态有关系。上拉则逻辑值为 1，下拉则为 0 。

数字声明时，合法的基数格式有 4 中，包括：十进制(’d 或 ‘D)，十六进制(‘h 或 ‘H)，二进制（‘b 或 ‘B），八进制（‘o 或 ‘O）。数值可指明位宽，也可不指明位宽。

C 语言介绍

Sun, 09 Mar 2025 00:00:00 +0000

Hello World！

前言#

C语言是一门十分流行的编程语言，由美国贝尔实验室的 Dennis Ritchie 在 20 世纪 70 年代开发。C语言也是我学编程梦开始的地方，我写的第一句程序就是hello world！在看过各种代码后发现编程语言其实都差不多，重要的是编程的思想。但这篇文章还是会尽可能详细地介绍C语言的基本语法。

例程#

先上例程（注意，在编程的时候尽量使用英文的键盘输入）

#include <stdio.h>
 
int main()
{
 /* 我的第一个 C 程序 */
 printf("Hello, World! \n");
 
 return 0;
}

所有的 C 语言程序都需要包含 main() 函数。代码从 main() 函数开始执行。

/* … */ 用于注释说明。
printf() 用于格式化输出到屏幕。printf() 函数在 “stdio.h” 头文件中声明。
stdio.h 是一个头文件 (标准输入输出头文件) , #include 是一个预处理命令，用来引入头文件。当编译器遇到 printf() 函数时，如果没有找到 stdio.h 头文件，会发生编译错误。
return 0; 语句用于表示退出程序。 (摘自菜鸟编程)
从上面的例程，可以看出C语言的基本框架，C语言程序架构上基本上就是这个样子，除了语法上的万般变化

C 语言的特点#

C语言具有以下几个显著的特点：

高效性：C语言是一门高效的编程语言，可以生成高效的机器码，使得C语言编写的程序运行速度快。
可移植性：C语言的代码可以跨平台移植，因为 C语言的语法规则和库函数是标准化的，所以在不同的计算机系统上，只需要对底层的系统函数进行一些调整就可以了。
简单性：C语言的语法简单，易于学习，代码量相对较小，因此很多初学者都会选择学习 C语言。
灵活性：C语言提供了多种编程风格和编程范式，例如面向过程、面向对象、泛型编程等，因此可以应用于不同的编程场景。
可扩展性：C语言提供了丰富的库函数和预处理指令，使得程序员可以方便地扩展和定制自己的程序。

参考资料#

菜鸟教程

linux 笔记

Sat, 22 Feb 2025 00:00:00 +0000

linux 简单上手

Linux 英文解释为 Linux is not Unix,Linux在计算机界的地位就不必多说了，这篇文章是一篇简单入门篇，看Linux的需求是什么，选择性的学习相关的Linux知识，安装Linux的知识先不折腾了，手头上暂时没有相关的机器，也没有精力去折腾，这里直接展示怎么驾驭Linux，下面直接上正文！

Linux 指令#

首先是linux终端，什么是Linux的终端，我刚接触Linux的时候也是云里雾里的，不知所云，Linux终端就是一个窗口（支持输入命令的窗口），如图

你可以在Linux的这个终端界面输入各种指令，然后他会返回指令的运行结果。

看了上面的图片，应该会对Linux的操作方式有个大概的了解，还是不清楚也没关系，下面开始介绍一些具体操作，有条件的朋友可以拿起键盘跟着敲试试看。

文件指令#

从文件管理到文件的路径开始操作

pwd

在这个位置新建一个名字为test的文件夹

mkdir test

3. 进入test文件夹
~~~Shell
cd test

在test文件夹里新建text.txt文件

touch text.txt

打开text.txt文件
在text.txt文件输入12345
保存text.txt文件
关闭text.txt文件

echo 12345 >>text.txt

上面三个操作这一个命令就可以完成 9. 打开文件夹，检查test文件夹以及text.txt文件内容

关于Linux的命令很多，这个不需要去刻意的背诵记忆，常用的指令就那么几个，用多了自然就会了，冷门的指令有个印象，知道有这种命令操作就行了，等要用的时候再网上查一下就可以了。文末附录了两个速查的链接可以点击进去看看 tips： 在终端界面，按下tab键可以查看所有可用的命令，在命令输入一半的时候，按下Tab键可以自动补齐命令，在命令太长或者记忆混乱的时候可以按下此键找点灵感。

linux 命令速查#

文件管理
文档编辑
磁盘管理
磁盘维护
网络通讯
系统管理
系统备份
备份压缩
设备管理
其他命令

参考链接#

linux中国
 linux官方
 linux命令速查
 linux命令速查-菜鸟编程

makefike 笔记

Fri, 21 Feb 2025 00:00:00 +0000

makefike 学习笔记

makefike可以把一大串Linux 指令封装成独立的命令执行，在需要处理复杂任务时，可以把命令编辑到makefile文件里，然后简单的命令就可以执行复杂的操作了，化繁为简，大大提高code效率。

makefile 使用方法#

makefile在linux中直接以makefile形式存在，在使用时，直接在终端输入命令

make <command>

例如：下面是一段markdowm文件的源代码

test:
 @echo "hello test"

要执行这个makefile的需要在终端下的操作如下：

[user]$ make test

输入这段命令后，终端会打印出hello test字样，此时的终端将会变成

[user]$ make test
hello test

这就是makefile文件的使用方法，接下来介绍一下makefile文件格式

makefile 文件格式#

Makefile基本格式如下:

target ... : prerequisites ...
 command
 ...
 ...

其中,

target - 目标文件, 可以是 Object File, 也可以是可执行文件
prerequisites - 生成 target 所需要的文件或者目标
command - make需要执行的命令 (任意的shell命令), Makefile中的命令必须以 [tab] 开头

显示规则 :: 说明如何生成一个或多个目标文件(包括生成的文件, 文件的依赖文件, 生成的命令)
隐晦规则 :: make的自动推导功能所执行的规则
变量定义 :: Makefile中定义的变量
文件指示 :: Makefile中引用其他Makefile; 指定Makefile中有效部分; 定义一个多行命令
注释 :: Makefile只有行注释 “#”, 如果要使用或者输出"#“字符, 需要进行转义, “#”

vi 编辑器

Sat, 15 Feb 2025 00:00:00 +0000

vi编辑器学习笔记

Vi 快捷键#

文件相关命令	说明
`:w`	将编辑的数据写入硬盘档案中，:w!表强制写入（常用）
`:w`	将编辑的数据写入硬盘档案中，:w!表强制写入（常用）
`:q`	离开 vi ，:q!强制离开（常用）
`:wq`	储存后离开，:wq! 为强制储存后离开（常用）
`ZZ`	保存当前文件，然后退出（如果修改过）
`ZQ`	不保存，强制退出。效果等同于 :q!。
`:w [filename]`	将编辑的数据储存成另一个档案（类似另存新档）
`:r [filename]`	在编辑的数据中，读入另一个档案的数据到游标所在行后面
`:n1,n2 w [filename]`	将 n1 到 n2 的内容储存成 filename 这个档案。
`:set nu`	显示行号，设定之后，会在每一行的前缀显示该行的行号
`:set nonu`	与 set nu 相反，为取消行号！
编辑相关快捷键	说明
`i`	进入编辑模式，相同功能的还有a、o，大小写都可，功能差异在插入的位置上
`r，R`	进入取代模式，相当与Insert，r只取代字符一次，R一直取代直到Esc
搜索替换相关快捷键	说明
`/word`	向光标之下寻找一个名为 word 的字符串。例如，搜索 vbird 则输入 /vbird。（常用）
`?word`	向光标之上寻找一个名为 word 的字符串。
`n`	重复前一个搜索动作。如果是向下搜索，则继续向下搜索；如果是向上搜索，则继续向上搜索。（常用）
`N`	与 `n` 相反，执行反向的搜索动作。如果之前是向下搜索，则向上搜索；如果之前是向上搜索，则向下搜索。（常用）
`:n1,n2s/word1/word2/g`	在第 n1 行到第 n2 行之间寻找 word1 并将其替换为 word2。（常用）
`:1,$s/word1/word2/g` 或 `:%s/word1/word2/g`	从第一行到最后一行寻找 word1 并将其替换为 word2。（常用）
`:1,$s/word1/word2/gc` 或 `:%s/word1/word2/gc`	从第一行到最后一行寻找 word1 并将其替换为 word2，并在替换前显示提示，让用户确认是否需要替换。（常用）
粘贴、删除相关快捷键	说明
`nx`	n 为数字，连续向后删除 n 个字符
`dd`	剪切游标所在的那一整行(常用)，用 p/P 可以粘贴
`ndd`	n 为数字。剪切光标所在的向下 n 行(常用)，用 p/P 可以粘贴
`d1G`	删除游标所在到第一行的所有数据
`dG`	删除游标所在到最后一行的所有数据
`d$`	删除游标所在处到该行的最后一个字符
`d0`	删除游标所在处到该行的最前面一个字符
`yy`	复制游标所在的那一行(常用)
`nyy`	n 为数字。复制光标所在的向下 n 行(常用)
`y1G`	复制游标所在行到第一行的所有数据
`yG`	复制游标所在行到最后一行的所有数据
`y0`	复制游标所在的那个字符到该行行首的所有数据
`y$`	复制游标所在的那个字符到该行行尾的所有数据
`p, P`	p 将已复制的数据在光标下一行贴上，P 则贴在游标上一行(常用)
`J`	将光标所在行与下一行的数据结合成同一行
`c`	重复删除多个数据，例如向下删除 10 行，[ 10cj ]
`u`	复原前一个动作。(常用)
`[Ctrl]+r`	重做上一个动作。(常用)
`.`	(按下小数点)重复前一个动作。(常用)

为什么是vi编辑器#

Vi 是 1976 年由 Bill Joy 开发的一款文本编辑器，最初是为 Unix 系统设计的。Vi 以其简洁、高效的操作方式而闻名，成为 Unix 和类 Unix 系统上的标准编辑器。Vim（Vi Improved）是 Vi 编辑器的改进版本，使用方法和Vi 编辑器相识相通。这里只Vi 编辑器这个编辑器几乎不用下载，在各各电脑平台几乎都支持，由于其简洁稳定，功能强大，且支持插件等功能，熟练的Vi 编辑器操作工人可以在无鼠标的环境下正常操作。

git 学习笔记

Mon, 10 Feb 2025 00:00:00 +0000

git 的一些零零碎碎

网上关于git的教程数不胜数，但我问什么还要写呢？我这水平写出来的博客肯定比不上互联网的大神总结的。我写这个主要是写一些常见的git命令速查表，梳理我在学习git上面踩过的坑

TOC {:toc}

git 常用命令#

命令	说明
git init	初始化仓库
git clone	克隆仓库
git pull	从远端拉取仓库-同步
git push origin main –tags	上传分支及标签
git branch	查看所有分支
git switch -c	切换到 branch 分支
git merge	将 branch 合并到当前分支
git tag	打 tag
git status	查看未添加到 git 的文件
git log	查看历史命令
git commit -m –commend	添加 commit 提示

git 能做什么#

从github，gieet这类代码托管平台下载上传代码
查看项目的上传下载日志
创立项目分支，协作开发互不干扰
查看项目与上次上传相比更改了那些内容
合并项目分支，创建项目分支
tag打包项目，整个项目打包成压缩包
撤回上一步的操作

这是一些具象化的操作，笼统来讲git就是非常nice的项目管理工具

markdowm 语法速查

Tue, 04 Feb 2025 00:00:00 +0000

markdown语言的语法参考，此篇笔记的所有语法在此博客中均已支持

常用markdown语法#

功能	语法	备注
标题	# 标题名称	行首位置使用“井号+空格+标题文本”；井号数量表示标题层级，依次为H1~H6
块引用	>文字块	行首位置使用右箭号，中间可有可无空格
斜体	文字块	前后使用1个星号，为一组
粗体	文字块	前后使用2个星号，为一组
删除线	~~文字块~~	前后使用2个波浪线，为一组
下划线	––	使用3个减号后，按回车键
无序列表	- 条目	行首位置使用“减号+空格+条目”后，按回车键
有序列表	数字. 条目	行首位置使用“数字序号+句点+空格+条目”后，按回车键
任务列表	- [x]	[ ]内加x表示完成，不加表示方框
超链接	[alt](url)	alt（可选）为url的替换文本，url（必选）为超链接地址
图像	![alt](url)	类似超链接，只是多了一个感叹号
代码	`源代码`	前后使用1个反引号；底色长度等于源代码长度
代码块	~~~java 源代码~~~	前后使用3个波浪线，波浪线后跟回车键；后面接着选择语言
代码块	```java 源代码```	前后使用3个`，波浪线后跟回车键；后面接着选择语言

TOC {:toc}

补充#

换行#

在行后面按两下空格表示换行。（此方法在实操的过程种无法查看到空格，有缺陷）还有一种方法，在行尾添加“结尾空格”或 HTML 的 <br> 标签来实现换行，这种方法只需要正常换行即可

转义字符语法#

要显示原本用于格式化 Markdown 文档的字符，请在字符前面添加反斜杠字符 \ 。