1
2

    
    
      实现 SSH 免密登录以及别名
使用以下命令
1
ssh-copy-id -i '替换成你的公钥目录' 用户名@ip地址
使用命令之后需要输入密码，输入成功后就可以实现免密登录。
实现 SSH 别名
1
2
3
4
5
6
## 以下是 ~/.ssh/config 文件的内容
Host myserver  # 自定义别名（如：dev/prod等）
    HostName 192.168.1.100  # 服务器IP或域名
    User root               # 登录用户名
    Port 22                 # 非默认端口时需指定
    IdentityFile ~/.ssh/id_rsa  # 私钥路径
结合免密就可以实现快速登录远程主机。
]]>
    
    https://sunshinechen.cn/2025/10/28/%E5%AE%9E%E7%8E%B0%20SSH%20%E5%85%8D%E5%AF%86%E7%99%BB%E5%BD%95%E5%92%8C%20SSH%20%E5%88%AB%E5%90%8D/
    
    2025-10-28T06:34:37.000Z
    
首页摘要
    
    2026-10-28T09:18:36.438Z
  
  
    
      jianhao
    
    
    
    
      在终端下执行以下命令：
1
gsettings set org.gnome.desktop.interface clock-show-seconds true
]]>
    
    https://sunshinechen.cn/2025/10/28/Ubuntu%2022.04%20%E7%B3%BB%E7%BB%9F%E4%BF%AE%E6%94%B9%E9%A1%B6%E9%83%A8%E6%97%B6%E9%97%B4%E6%A0%BC%E5%BC%8F%E4%B8%BA%E7%A7%92/
    
    2025-10-28T06:32:01.000Z
    
看在Ubuntu系统中，如何将顶部时间格式修改为秒
    
    2026-10-28T09:18:36.438Z
  
  
    
      jianhao
    
    
    
    
      什么是 ldflags ？
ldflags 是 Go 编译命令 go build 中的一个选项，用来船底给链接器额外的参数。通过调整这些参数，我们可以控制 Go 程序生成的二进制文件的大小、调试信息、符号表信息、动态注入变量等行为。
常见的go build命令示例：
1
go build -ldflags "-s -w"
常见的-ldflags 参数详解
-s：移除符号表
作用：掉符号表（symbol table）。符号表包括函数和变量的名字信息，主要用于调试和分析生成的二进制文件。删除符号表可以显著减少文件大小。
适用场景：如果程序不需要调试符号信息，可以使用这个选项减小二进制文件体积。
影响：调试时无法获取函数和变量名。
1
go build -ldflags "-s"
-w：移除DWARF调试信息
作用：移除 DWARF 格式的调试信息。DWARF 是一种用于调试的标准，它包含关于程序的调试信息（例如变量类型、堆栈跟踪等）。
适用场景：当你不需要保留调试信息时，删除这些信息可以进一步缩小二进制文件。
影响：会影响程序的调试、堆栈跟踪和性能剖析等功能。
1
go build -ldflags "-w"
-X 'importpath.name=vlaue'：动态注入变量
作用：允许在编译时向 Go 程序中的全局字符串变量注入值。常用于在构建时设置应用的版本号、编译时间等。
适用场景：在生成的二进制文件中注入动态信息，而无需硬编码在源码中。
示例：假设代码中有一个 var version string 变量，使用以下命令可以将 version 变量设置为 1.0.0：
1
go build -ldflars "-X 'main.version=1.0.0'"
-trimpath：移除编译路径信息
作用：在默认情况下，Go 编译器会将源码的绝对路径包含在生成的二进制文件中。-trimpath 用于移除这些路径信息，以防止敏感路径信息泄露，并使二进制文件更具可移植性。
适用场景：当需要生成独立于编译环境的二进制文件，或避免泄露源码路径时，可以使用此选项。
1
go build -ldflags "-trimpath"
-compressdwarf：压缩DWARF调试信息
作用：压缩保留的 DWARF 调试信息。这个选项不会移除调试信息，但通过压缩减少它们占用的空间。
适用场景：当你需要保留调试信息，但希望尽量减少二进制文件大小时，可以使用此选项。
支持版本：Go 1.15 及以上版本支持。
1
go build -ldflags="-compressdwarf"
-linkmode 'mode'：指定链接模式
作用：-linkmode 参数用于指定链接器的工作模式。Go 提供三种链接模式：
internal：使用 Go 内置的链接器（默认）。
external：使用系统链接器（如 gcc）。
auto：Go 编译器自动选择合适的链接模式。
适用场景：在特定的嵌入式环境或系统环境中，你可能需要指定使用外部链接器来处理特定的库或符号。
1
go build -ldflags "-linkmode external"
buildid 'id：自定义构建ID
作用：Go 编译器默认会生成一个唯一的 build id，用于标识每个二进制文件。-buildid 选项允许开发者自定义这个 build id，以便在多个构建版本之间进行标识。
适用场景：用于版本管理或者标记不同的构建版本。
1
go build -ldflags "-buildid=customid"
extld 'path'：指定外部链接器
作用：配合 -linkmode external 使用，指定外部链接器（如 gcc）的路径。通常用于嵌入式开发或对链接器有特殊要求的场景。
示例：指定使用 /usr/bin/gcc 作为外部链接器：
1
go build -ldflags "extld=/usr/bin/gcc"
-ldflags 参数组合示例
最小化二进制文件大小
如果目标是生成尽量小的二进制文件，可以使用 -s 和 -w 组合，移除所有符号表和调试信息：
1
go build -ldflags "-s -w"
在编译时注入版本信息和构建时间
在实际项目中，我们经常需要在运行时查看应用的版本号或构建时间。可以通过 -X 动态注入这些信息：
1
go build -ldflags "-X 'main.version=1.2.3' -X 'main.buildTime=$(date)'"
假设在代码中有对应的 version 和 buildTime 字符串变量，编译时会注入相应的值。
保留调试信息但压缩文件
如果你需要保留 DWARF 调试信息以便调试，但希望减少其大小，可以使用 -compressdwarf：
`
1
go build -ldflags "-compressdwarf"
结尾
Go 编译选项中的 -ldflags 是一个强大且灵活的工具，它允许开发者根据项目需求进行定制化的编译优化。在生成生产环境二进制文件时，通过移除调试信息、注入动态变量等方式，可以显著减少文件体积、提高程序的安全性和便携性。
根据项目的实际需求，合理使用 -ldflags 参数，可以为你的 Go 项目提供更高的灵活性和优化能力。无论是减少二进制文件大小、动态注入版本信息，还是自定义链接器行为，-ldflags 都能帮助你更好地掌控编译过程。
]]>
    
    https://sunshinechen.cn/2025/10/28/Go%E7%9A%84%E7%BC%96%E8%AF%91%E5%8F%82%E6%95%B0/
    
    2025-10-28T06:14:50.000Z
    
在 Go 开发中，编译生成的二进制文件往往是程序性能和可移植性的关键。在某些场景下，我们需要对编译的输出进行优化，比如减少二进制文件大小、注入版本信息、控制调试信息等。而 -ldflags 是 Go 编译器提供的一个功能强大的选项，允许开发者向链接器传递额外的参数来控制生成文件的行为和结构。在本文中，我们将深入解析 Go 中的 -ldflags 及其常用参数，帮助开发者根据具体需求进行高效优化和自定义。
    
    2026-10-28T09:18:36.382Z
  
  
    
      jianhao
    
    
    
    
    
      程序库例子
go-blueprint
go-blueprint是一个快速生成Go项目文件夹的项目，提供项目名称、RESTFul框架、数据库驱动、git等多种技术栈选择，由bubbletea TUI文本框架来提供数据的录入。
]]>
    
    https://sunshinechen.cn/2025/04/16/%E5%BA%93%E4%BE%8B%E5%AD%90/
    
    2025-04-16T06:17:13.000Z
    

      程序库例子

    
    
      在日常使用 Linux 系统时，不管是通过 SSH 远程登录设备，还是直接打开本地终端，当我们需要执行一些系统维护操作（比如更新软件包）时，都会遇到这样的情况：使用  sudo  命令后，系统会要求我们输入密码。
虽然这个设计出发点是安全考虑，但在个人使用场景下，频繁输入密码确实会影响工作效率。其实我们可以通过一个更优雅的方式来解决这个问题：在  sudoers.d  目录下创建独立的用户权限规则文件，而不是直接修改系统的默认配置。
只需要执行下面这条命令：
1
echo "`whoami` ALL=(ALL) NOPASSWD:ALL" | sudo tee "/etc/sudoers.d/dont-prompt-$USER-for-sudo-password"
]]>
    
    https://sunshinechen.cn/2025/02/11/%E6%89%A7%E8%A1%8C%E7%89%B9%E6%9D%83%E5%91%BD%E4%BB%A4%E6%97%B6%E4%B8%8D%E7%94%A8%E9%87%8D%E5%A4%8D%E8%BE%93%E5%85%A5%E5%AF%86%E7%A0%81/
    
    2025-02-11T07:13:55.000Z
    

      在日常使用 Linux 系统时，不管是通过 SSH 远程登录设备，还是直接打开本地终端，当我们需要执行一些系统维护操作（比如更新软件包）时，都会遇到这样的情况：使用  sudo  命令后，系统会要求我们输入密码。

虽然这个设计出发点是]]>
    
    
    2026-10-28T09:18:36.438Z
  
  
    
      jianhao
    
    
    
    
      获取当前脚本的目录
1
dir=$(cd $(dirname $0);pwd)
让输出有颜色
1
2
3
BOLD_RED='\033[1;31m'
RESET='\033[0m'
echo -e "${BOLD_RED}ERROR${RESET}: ./calculate_average_$fork.sh does not exist." >&2
以上代码会让 ERROR 以红色字样输出，但后面的还是默认颜色的白色颜色。
执行命令之前先打印命令本身
我希望用户能够准确理解脚本在每个步骤中的作用。为了实现这一点，我实现了一个函数，在执行每个命令之前打印它：
1
2
3
4
5
6
7
function print_and_execute() {
  echo "+ $@" >&2
  "$@"
}

## 调用时:
print_and_execute git add .
获取当前时分
1
date +"%H:%M"
将实际爱你保存到变量中：
1
2
current_time=$(date +"%H:%M")
echo "当前时间是 $current_time"
其他常见时间格式：
1
2
date +"%I:%M %p"  # 12 小时制 + AM/PM 标记（例如 02:30 PM）
date +"%H%M"      # 紧凑格式（例如 1430）
指定时区：
1
TZ='Asia/Shanghai' date +"%H:%M"  # 获取上海时区的当前时间
]]>
    
    https://sunshinechen.cn/2024/11/13/%E7%BC%96%E5%86%99Shell%E8%84%9A%E6%9C%AC%E6%97%B6%E7%9A%84%E6%8A%80%E5%B7%A7/
    
    2024-11-13T02:13:02.000Z
    

      获取当前脚本的目录

    
    
    2026-10-28T09:18:36.290Z
  
  
    
      jianhao
    
    
    
    
      工具库
Lancet
github
全面的 Go 语言工具函数库。这是一个高效且全面的 Go 语言工具函数库，包含 600 多个函数，涵盖字符串处理、切片操作、网络编程、并发、加解密、文件处理、时间/日期、流处理、迭代器等功能。
gopsutil
github
用于系统监控的 go 库，可以监控 cpu、内存、硬盘、网络、进程、主机信息、docker 相关信息。
fsm
github
有限状态机在 Go 中的实现库
fxjson
github wiki
FxJSON 是一个专为 Go 语言设计的高性能 JSON 解析库，它让 JSON 处理变得快速、安全、简单。可以把它想象成标准 JSON 库的超级版本！
Retry
github 使用指南
Retry 是一个轻量纯 Go 实现的重试库，有丰富的重试策略、灵活的终止条件，贴合 Go 生态的设计，是 Go 语言中重试机制的首选库。
]]>
    
    https://sunshinechen.cn/2024/09/03/%E5%A5%BD%E7%94%A8%E7%9A%84%E4%B8%89%E6%96%B9%E5%BA%93/
    
    2024-09-03T09:42:34.000Z
    

      工具库
<]]>
    

    
    2026-10-28T09:18:36.414Z
  
  
    
      jianhao
    
    
    
      Systemd 入门教程：命令篇
Systemd 是 Linux 系统工具，用来启动守护进程，已成为大多数发行版的标准配置。
本文介绍它的基本用法，分为上下两篇。今天介绍它的主要命令，下一篇介绍如何用于实战。
一、由来
历史上，Linux 的启动一直采用init进程。
下面的命令用来启动服务。
1
2
3
$ sudo /etc/init.d/apache2 start
# 或者
$ service apache2 start
这种方法有两个缺点。
一是启动时间长。init进程是串行启动，只有前一个进程启动完，才会启动下一个进程。
二是启动脚本复杂。init进程只是执行启动脚本，不管其他事情。脚本需要自己处理各种情况，这往往使得脚本变得很长。
二、Systemd 概述
Systemd 就是为了解决这些问题而诞生的。它的设计目标是，为系统的启动和管理提供一套完整的解决方案。
根据 Linux 惯例，字母d是守护进程（daemon）的缩写。 Systemd 这个名字的含义，就是它要守护整个系统。
（上图为 Systemd 作者 Lennart Poettering）
使用了 Systemd，就不需要再用init了。Systemd 取代了initd，成为系统的第一个进程（PID 等于 1），其他进程都是它的子进程。
1
$ systemctl --version
上面的命令查看 Systemd 的版本。
Systemd 的优点是功能强大，使用方便，缺点是系统庞大，非常复杂。事实上，现在还有很多人反对使用 Systemd，理由就是它过于复杂，与操作系统的其他部分强耦合，违反“keep simple, keep stupid”的Unix 哲学。
（上图为 Systemd 架构图）
三、系统管理
Systemd 并不是一个命令，而是一组命令，涉及到系统管理的方方面面。
3.1 systemctl
systemctl是 Systemd 的主命令，用于管理系统。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 重启系统
$ sudo systemctl reboot

# 关闭系统，切断电源
$ sudo systemctl poweroff

# CPU停止工作
$ sudo systemctl halt

# 暂停系统
$ sudo systemctl suspend

# 让系统进入冬眠状态
$ sudo systemctl hibernate

# 让系统进入交互式休眠状态
$ sudo systemctl hybrid-sleep

# 启动进入救援状态（单用户状态）
$ sudo systemctl rescue
3.2 systemd-analyze
systemd-analyze命令用于查看启动耗时。
1
2
3
4
5
6
7
8
9
10
11
# 查看启动耗时
$ systemd-analyze                                                                                       

# 查看每个服务的启动耗时
$ systemd-analyze blame

# 显示瀑布状的启动过程流
$ systemd-analyze critical-chain

# 显示指定服务的启动流
$ systemd-analyze critical-chain atd.service
3.3 hostnamectl
hostnamectl命令用于查看当前主机的信息。
1
2
3
4
5
# 显示当前主机的信息
$ hostnamectl

# 设置主机名。
$ sudo hostnamectl set-hostname rhel7
3.4 localectl
localectl命令用于查看本地化设置。
1
2
3
4
5
6
# 查看本地化设置
$ localectl

# 设置本地化参数。
$ sudo localectl set-locale LANG=en_GB.utf8
$ sudo localectl set-keymap en_GB
3.5 timedatectl
timedatectl命令用于查看当前时区设置。
1
2
3
4
5
6
7
8
9
10
# 查看当前时区设置
$ timedatectl

# 显示所有可用的时区
$ timedatectl list-timezones                                                                                   

# 设置当前时区
$ sudo timedatectl set-timezone America/New_York
$ sudo timedatectl set-time YYYY-MM-DD
$ sudo timedatectl set-time HH:MM:SS
3.6 loginctl
loginctl命令用于查看当前登录的用户。
1
2
3
4
5
6
7
8
# 列出当前session
$ loginctl list-sessions

# 列出当前登录用户
$ loginctl list-users

# 列出显示指定用户的信息
$ loginctl show-user ruanyf
四、Unit
4.1 含义
Systemd 可以管理所有系统资源。不同的资源统称为 Unit（单位）。
Unit 一共分成12种。
1
2
3
4
5
6
7
8
9
10
11
12
- Service unit：系统服务
- Target unit：多个 Unit 构成的一个组
- Device Unit：硬件设备
- Mount Unit：文件系统的挂载点
- Automount Unit：自动挂载点
- Path Unit：文件或路径
- Scope Unit：不是由 Systemd 启动的外部进程
- Slice Unit：进程组
- Snapshot Unit：Systemd 快照，可以切回某个快照
- Socket Unit：进程间通信的 socket
- Swap Unit：swap 文件
- Timer Unit：定时器
systemctl list-units命令可以查看当前系统的所有 Unit 。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 列出正在运行的 Unit
$ systemctl list-units

# 列出所有Unit，包括没有找到配置文件的或者启动失败的
$ systemctl list-units --all

# 列出所有没有运行的 Unit
$ systemctl list-units --all --state=inactive

# 列出所有加载失败的 Unit
$ systemctl list-units --failed

# 列出所有正在运行的、类型为 service 的 Unit
$ systemctl list-units --type=service
4.2 Unit 的状态
systemctl status命令用于查看系统状态和单个 Unit 的状态。
1
2
3
4
5
6
7
8
# 显示系统状态
$ systemctl status

# 显示单个 Unit 的状态
$ sysystemctl status bluetooth.service

# 显示远程主机的某个 Unit 的状态
$ systemctl -H root@rhel7.example.com status httpd.service
除了status命令，systemctl还提供了三个查询状态的简单方法，主要供脚本内部的判断语句使用。
1
2
3
4
5
6
7
8
# 显示某个 Unit 是否正在运行
$ systemctl is-active application.service

# 显示某个 Unit 是否处于启动失败状态
$ systemctl is-failed application.service

# 显示某个 Unit 服务是否建立了启动链接
$ systemctl is-enabled application.service
4.3 Unit 管理
对于用户来说，最常用的是下面这些命令，用于启动和停止 Unit（主要是 service）。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 立即启动一个服务
$ sudo systemctl start apache.service

# 立即停止一个服务
$ sudo systemctl stop apache.service

# 重启一个服务
$ sudo systemctl restart apache.service

# 杀死一个服务的所有子进程
$ sudo systemctl kill apache.service

# 重新加载一个服务的配置文件
$ sudo systemctl reload apache.service

# 重载所有修改过的配置文件
$ sudo systemctl daemon-reload

# 显示某个 Unit 的所有底层参数
$ systemctl show httpd.service

# 显示某个 Unit 的指定属性的值
$ systemctl show -p CPUShares httpd.service

# 设置某个 Unit 的指定属性
$ sudo systemctl set-property httpd.service CPUShares=500
4.4 依赖关系
Unit 之间存在依赖关系：A 依赖于 B，就意味着 Systemd 在启动 A 的时候，同时会去启动 B。
systemctl list-dependencies命令列出一个 Unit 的所有依赖。
1
$ systemctl list-dependencies nginx.service
上面命令的输出结果之中，有些依赖是 Target 类型（详见下文），默认不会展开显示。如果要展开 Target，就需要使用--all参数。
1
$ systemctl list-dependencies --all nginx.service
五、Unit 的配置文件
5.1 概述
每一个 Unit 都有一个配置文件，告诉 Systemd 怎么启动这个 Unit 。
Systemd 默认从目录/etc/systemd/system/读取配置文件。但是，里面存放的大部分文件都是符号链接，指向目录/usr/lib/systemd/system/，真正的配置文件存放在那个目录。
systemctl enable命令用于在上面两个目录之间，建立符号链接关系。
1
2
3
$ sudo systemctl enable clamd@scan.service
# 等同于
$ sudo ln -s '/usr/lib/systemd/system/clamd@scan.service' '/etc/systemd/system/multi-user.target.wants/clamd@scan.service'
如果配置文件里面设置了开机启动，systemctl enable命令相当于激活开机启动。
与之对应的，systemctl disable命令用于在两个目录之间，撤销符号链接关系，相当于撤销开机启动。
1
$ sudo systemctl disable clamd@scan.service
配置文件的后缀名，就是该 Unit 的种类，比如sshd.socket。如果省略，Systemd 默认后缀名为.service，所以sshd会被理解成sshd.service。
5.2 配置文件的状态
systemctl list-unit-files命令用于列出所有配置文件。
1
2
3
4
5
# 列出所有配置文件
$ systemctl list-unit-files

# 列出指定类型的配置文件
$ systemctl list-unit-files --type=service
这个命令会输出一个列表。
1
2
3
4
5
6
$ systemctl list-unit-files

UNIT FILE              STATE
chronyd.service        enabled
clamd@.service         static
clamd@scan.service     disabled
这个列表显示每个配置文件的状态，一共有四种。
1
2
3
4
- enabled：已建立启动链接
- disabled：没建立启动链接
- static：该配置文件没有`[Install]`部分（无法执行），只能作为其他配置文件的依赖
- masked：该配置文件被禁止建立启动链接
注意，从配置文件的状态无法看出，该 Unit 是否正在运行。这必须执行前面提到的systemctl status命令。
1
$ systemctl status bluetooth.service
一旦修改配置文件，就要让 SystemD 重新加载配置文件，然后重新启动，否则修改不会生效。
1
2
$ sudo systemctl daemon-reload
$ sudo systemctl restart httpd.service
5.3 配置文件的格式
配置文件就是普通的文本文件，可以用文本编辑器打开。
systemctl cat命令可以查看配置文件的内容。
1
2
3
4
5
6
7
8
9
10
11
$ systemctl cat atd.service

[Unit]
Description=ATD daemon

[Service]
Type=forking
ExecStart=/usr/bin/atd

[Install]
WantedBy=multi-user.target
从上面的输出可以看到，配置文件分成几个区块。每个区块的第一行，是用方括号表示的区别名，比如[Unit]。注意，配置文件的区块名和字段名，都是大小写敏感的。
每个区块内部是一些等号连接的键值对。
1
2
3
4
5
[Section]
Directive1=value
Directive2=value

. . .
注意，键值对的等号两侧不能有空格。
5.4 配置文件的区块
[Unit]区块通常是配置文件的第一个区块，用来定义 Unit 的元数据，以及配置与其他 Unit 的关系。它的主要字段如下。
1
2
3
4
5
6
7
8
9
10
- Description：简短描述
- Documentation：文档地址
- Requires：当前 Unit 依赖的其他 Unit，如果它们没有运行，当前 Unit 会启动失败
- Wants：与当前 Unit 配合的其他 Unit，如果它们没有运行，当前 Unit 不会启动失败
- BindsTo：与`Requires`类似，它指定的 Unit 如果退出，会导致当前 Unit 停止运行
- Before：如果该字段指定的 Unit 也要启动，那么必须在当前 Unit 之后启动
- After：如果该字段指定的 Unit 也要启动，那么必须在当前 Unit 之前启动
- Conflicts：这里指定的 Unit 不能与当前 Unit 同时运行
- Condition...：当前 Unit 运行必须满足的条件，否则不会运行
- Assert...：当前 Unit 运行必须满足的条件，否则会报启动失败
[Install]通常是配置文件的最后一个区块，用来定义如何启动，以及是否开机启动。它的主要字段如下。
1
2
3
4
- WantedBy：它的值是一个或多个 Target，当前 Unit 激活时（enable）符号链接会放入`/etc/systemd/system`目录下面以 Target 名 + `.wants`后缀构成的子目录中
- RequiredBy：它的值是一个或多个 Target，当前 Unit 激活时，符号链接会放入`/etc/systemd/system`目录下面以 Target 名 + `.required`后缀构成的子目录中
- Alias：当前 Unit 可用于启动的别名
- Also：当前 Unit 激活（enable）时，会被同时激活的其他 Unit
[Service]区块用来 Service 的配置，只有 Service 类型的 Unit 才有这个区块。它的主要字段如下。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
- Type：定义启动时的进程行为。它有以下几种值。
- simple：默认值，执行ExecStart指定的命令，启动主进程
- forking：以 fork 方式从父进程创建子进程，创建后父进程会立即退出
- oneshot：一次性进程，Systemd 会等当前服务退出，再继续往下执行
- dbus：当前服务通过D-Bus启动
- notify：当前服务启动完毕，会通知Systemd，再继续往下执行
- idle：若有其他任务执行完毕，当前服务才会运行
- ExecStart：启动当前服务的命令
- ExecStartPre：启动当前服务之前执行的命令
- ExecStartPost：启动当前服务之后执行的命令
- ExecReload：重启当前服务时执行的命令
- ExecStop：停止当前服务时执行的命令
- ExecStopPost：停止当其服务之后执行的命令
- RestartSec：自动重启当前服务间隔的秒数
- Restart：定义何种情况 Systemd 会自动重启当前服务，可能的值包括always（总是重启）、on-success、on-failure、on-abnormal、on-abort、on-watchdog
- TimeoutSec：定义 Systemd 停止当前服务之前等待的秒数
- Environment：指定环境变量
Unit 配置文件的完整字段清单，请参考官方文档。
六、Target
简单说，Target 就是一个 Unit 组，包含许多相关的 Unit 。启动某个 Target 的时候，Systemd 就会启动里面所有的 Unit。从这个意义上说，Target 这个概念类似于“状态点”，启动某个 Target 就好比启动到某种状态。
传统的init启动模式里面，有 RunLevel 的概念，跟 Target 的作用很类似。不同的是，RunLevel 是互斥的，不可能多个 RunLevel 同时启动，但是多个 Target 可以同时启动。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 查看当前系统的所有 Target
$ systemctl list-unit-files --type=target

# 查看一个 Target 包含的所有 Unit
$ systemctl list-dependencies multi-user.target

# 查看启动时的默认 Target
$ systemctl get-default

# 设置启动时的默认 Target
$ sudo systemctl set-default multi-user.target

# 切换 Target 时，默认不关闭前一个 Target 启动的进程，
# systemctl isolate 命令改变这种行为，
# 关闭前一个 Target 里面所有不属于后一个 Target 的进程
$ sudo systemctl isolate multi-user.target
Target 与 传统 RunLevel 的对应关系如下。
1
2
3
4
5
6
7
8
9
Traditional runlevel      New target name     Symbolically linked to...

Runlevel 0           |    runlevel0.target -> poweroff.target
Runlevel 1           |    runlevel1.target -> rescue.target
Runlevel 2           |    runlevel2.target -> multi-user.target
Runlevel 3           |    runlevel3.target -> multi-user.target
Runlevel 4           |    runlevel4.target -> multi-user.target
Runlevel 5           |    runlevel5.target -> graphical.target
Runlevel 6           |    runlevel6.target -> reboot.target
它与init进程的主要差别如下。
（1）默认的 RunLevel（在/etc/inittab文件设置）现在被默认的 Target 取代，位置是/etc/systemd/system/default.target，通常符号链接到graphical.target（图形界面）或者multi-user.target（多用户命令行）。
（2）启动脚本的位置，以前是/etc/init.d目录，符号链接到不同的 RunLevel 目录 （比如/etc/rc3.d、/etc/rc5.d等），现在则存放在/lib/systemd/system和/etc/systemd/system目录。
（3）配置文件的位置，以前init进程的配置文件是/etc/inittab，各种服务的配置文件存放在/etc/sysconfig目录。现在的配置文件主要存放在/lib/systemd目录，在/etc/systemd目录里面的修改可以覆盖原始设置。
七、日志管理
Systemd 统一管理所有 Unit 的启动日志。带来的好处就是，可以只用journalctl一个命令，查看所有日志（内核日志和应用日志）。日志的配置文件是/etc/systemd/journald.conf。
journalctl功能强大，用法非常多。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# 查看所有日志（默认情况下 ，只保存本次启动的日志）
$ sudo journalctl

# 查看内核日志（不显示应用日志）
$ sudo journalctl -k

# 查看系统本次启动的日志
$ sudo journalctl -b
$ sudo journalctl -b -0

# 查看上一次启动的日志（需更改设置）
$ sudo journalctl -b -1

# 查看指定时间的日志
$ sudo journalctl --since="2012-10-30 18:17:16"
$ sudo journalctl --since "20 min ago"
$ sudo journalctl --since yesterday
$ sudo journalctl --since "2015-01-10" --until "2015-01-11 03:00"
$ sudo journalctl --since 09:00 --until "1 hour ago"

# 显示尾部的最新10行日志
$ sudo journalctl -n

# 显示尾部指定行数的日志
$ sudo journalctl -n 20

# 实时滚动显示最新日志
$ sudo journalctl -f

# 查看指定服务的日志
$ sudo journalctl /usr/lib/systemd/systemd

# 查看指定进程的日志
$ sudo journalctl _PID=1

# 查看某个路径的脚本的日志
$ sudo journalctl /usr/bin/bash

# 查看指定用户的日志
$ sudo journalctl _UID=33 --since today

# 查看某个 Unit 的日志
$ sudo journalctl -u nginx.service
$ sudo journalctl -u nginx.service --since today

# 实时滚动显示某个 Unit 的最新日志
$ sudo journalctl -u nginx.service -f

# 合并显示多个 Unit 的日志
$ journalctl -u nginx.service -u php-fpm.service --since today

# 查看指定优先级（及其以上级别）的日志，共有8级
# 0: emerg
# 1: alert
# 2: crit
# 3: err
# 4: warning
# 5: notice
# 6: info
# 7: debug
$ sudo journalctl -p err -b

# 日志默认分页输出，--no-pager 改为正常的标准输出
$ sudo journalctl --no-pager

# 以 JSON 格式（单行）输出
$ sudo journalctl -b -u nginx.service -o json

# 以 JSON 格式（多行）输出，可读性更好
$ sudo journalctl -b -u nginx.serviceqq
 -o json-pretty

# 显示日志占据的硬盘空间
$ sudo journalctl --disk-usage

# 指定日志文件占据的最大空间
$ sudo journalctl --vacuum-size=1G

# 指定日志文件保存多久
$ sudo journalctl --vacuum-time=1years
（完）
如何编写 Unit 的配置文件
What is an init system?
systemd: Converting sysvinit scripts
systemd: Unit dependencies and order
Systemd
Packaging:Systemd
Writing systemd service files
How to write startup script for systemd
]]>
    
    https://sunshinechen.cn/2024/08/21/Systemd%E8%AF%A6%E8%A7%A3%EF%BC%881%EF%BC%89/
    
    2024-08-21T09:07:35.000Z
    

      Systemd 入门教程：命令篇
Systemd 是 Linu]]>
    
    
    2026-10-28T09:18:36.270Z
  
  
    
      jianhao
    
    
    
      Systemd 入门教程：实战篇
上一篇文章，我介绍了 Systemd 的主要命令，今天介绍如何使用它完成一些基本的任务。
一、开机启动
对于那些支持 Systemd 的软件，安装的时候，会自动在/usr/lib/systemd/system目录添加一个配置文件。
如果你想让该软件开机启动，就执行下面的命令（以httpd.service为例）。
1
$ sudo systemctl enable httpd
上面的命令相当于在/etc/systemd/system目录添加一个符号链接，指向/usr/lib/systemd/system里面的httpd.service文件。
这是因为开机时，Systemd只执行/etc/systemd/system目录里面的配置文件。这也意味着，如果把修改后的配置文件放在该目录，就可以达到覆盖原始配置的效果。
二、启动服务
设置开机启动以后，软件并不会立即启动，必须等到下一次开机。如果想现在就运行该软件，那么要执行systemctl start命令。
1
$ sudo systemctl start httpd
执行上面的命令以后，有可能启动失败，因此要用systemctl statuc命令查看一下该服务的状态。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
$ sudo systemctl status httpd

httpd.service - The Apache HTTP Server
   Loaded: loaded (/usr/lib/systemd/system/httpd.service; enabled)
   Active: active (running) since 金 2014-12-05 12:18:22 JST; 7min ago
 Main PID: 4349 (httpd)
   Status: "Total requests: 1; Current requests/sec: 0; Current traffic:   0 B/sec"
   CGroup: /system.slice/httpd.service
           ├─4349 /usr/sbin/httpd -DFOREGROUND
           ├─4350 /usr/sbin/httpd -DFOREGROUND
           ├─4351 /usr/sbin/httpd -DFOREGROUND
           ├─4352 /usr/sbin/httpd -DFOREGROUND
           ├─4353 /usr/sbin/httpd -DFOREGROUND
           └─4354 /usr/sbin/httpd -DFOREGROUND

12月 05 12:18:22 localhost.localdomain systemd[1]: Starting The Apache HTTP Server...
12月 05 12:18:22 localhost.localdomain systemd[1]: Started The Apache HTTP Server.
12月 05 12:22:40 localhost.localdomain systemd[1]: Started The Apache HTTP Server.
上面的输出结果含义如下。
Loaded行：配置文件的位置，是否设为开机启动
Active行：表示正在运行
Main PID行：主进程ID
Status行：由应用本身（这里是 httpd ）提供的软件当前状态
CGroup块：应用的所有子进程
日志块：应用的日志
三、停止服务
终止正在运行的服务，需要执行systemctl stop命令。
1
$ sudo systemctl stop httpd.service
有时候，该命令可能没有响应，服务停不下来。这时候就不得不“杀进程”了，向正在运行的进程发出kill信号。
1
$ sudo systemctl kill httpd.service
此外，重启服务要执行systemctl restart命令。
1
$ sudo systemctl restart httpd.service
四、读懂配置文件
一个服务怎么启动，完全由它的配置文件决定。下面就来看，配置文件有些什么内容。
前面说过，配置文件主要放在/usr/lib/systemd/system目录，也可能在/usr/lib/systemd/system目录。找到配置文件以后，使用文本编辑器打开即可。
systemctl cat命令可以用来查看配置文件，下面以sshd.service文件为例，它的作用是启动一个 SSH 服务器，供其他用户以 SSH 方式登录。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
$ systemctl cat sshd.service

[Unit]
Description=OpenSSH server daemon
Documentation=man:sshd(8) man:sshd_config(5)
After=network.target sshd-keygen.service
Wants=sshd-keygen.service

[Service]
EnvironmentFile=/etc/sysconfig/sshd
ExecStart=/usr/sbin/sshd -D $OPTIONS
ExecReload=/bin/kill -HUP $MAINPID
Type=simple
KillMode=process
Restart=on-failure
RestartSec=42s

[Install]
WantedBy=multi-user.target
可以看到，配置文件分成几个区块，每个区块包含若干条键值对。
下面依次解释每个区块的内容。
五、 [Unit] 区块：启动顺序与依赖关系。
Unit区块的Description给出当前服务的简单描述，Documentation字段给出文档位置。
接下来的设置是启动顺序和依赖关系，这个比较重要。
After字段：表示如果network.target或sshd-keygen.service需要启动，那么sshd.service应该在它们之后启动。
相应地，还有一个Before字段，定义sshd.service应该在哪些服务之前启动。
注意，After和Before字段只涉及启动顺序，不涉及依赖关系。
举例来说，某 Web 应用需要 postgresql 数据库储存数据。在配置文件中，它只定义要在 postgresql 之后启动，而没有定义依赖 postgresql 。上线后，由于某种原因，postgresql 需要重新启动，在停止服务期间，该 Web 应用就会无法建立数据库连接。
设置依赖关系，需要使用Wants字段和Requires字段。
Wants字段：表示sshd.service与sshd-keygen.service之间存在“弱依赖”关系，即如果“sshd-keygen.service”启动失败或停止运行，不影响sshd.service继续执行。
Requires字段则表示“强依赖”关系，即如果该服务启动失败或异常退出，那么sshd.service也必须退出。
注意，Wants字段与Requires字段只涉及依赖关系，与启动顺序无关，默认情况下是同时启动的。
六、[Service] 区块：启动行为
Service区块定义如何启动当前服务。
6.1 启动命令
许多软件都有自己的环境参数文件，该文件可以用EnvironmentFile字段读取。
EnvironmentFile字段：指定当前服务的环境参数文件。该文件内部的key=value键值对，可以用$key的形式，在当前配置文件中获取。
上面的例子中，sshd 的环境参数文件是/etc/sysconfig/sshd。
配置文件里面最重要的字段是ExecStart。
ExecStart字段：定义启动进程时执行的命令。
上面的例子中，启动sshd，执行的命令是/usr/sbin/sshd -D $OPTIONS，其中的变量$OPTIONS就来自EnvironmentFile字段指定的环境参数文件。
与之作用相似的，还有如下这些字段。
ExecReload字段：重启服务时执行的命令
ExecStop字段：停止服务时执行的命令
ExecStartPre字段：启动服务之前执行的命令
ExecStartPost字段：启动服务之后执行的命令
ExecStopPost字段：停止服务之后执行的命令
请看下面的例子。
1
2
3
4
5
6
[Service]
ExecStart=/bin/echo execstart1
ExecStart=
ExecStart=/bin/echo execstart2
ExecStartPost=/bin/echo post1
ExecStartPost=/bin/echo post2
上面这个配置文件，第二行ExecStart设为空值，等于取消了第一行的设置，运行结果如下。
1
2
3
execstart2
post1
post2
所有的启动设置之前，都可以加上一个连词号（-），表示“抑制错误”，即发生错误的时候，不影响其他命令的执行。比如，EnvironmentFile=-/etc/sysconfig/sshd（注意等号后面的那个连词号），就表示即使/etc/sysconfig/sshd文件不存在，也不会抛出错误。
6.2 启动类型
Type字段定义启动类型。它可以设置的值如下。
simple（默认值）：ExecStart字段启动的进程为主进程
forking：ExecStart字段将以fork()方式启动，此时父进程将会退出，子进程将成为主进程
oneshot：类似于simple，但只执行一次，Systemd 会等它执行完，才启动其他服务
dbus：类似于simple，但会等待 D-Bus 信号后启动
notify：类似于simple，启动结束后会发出通知信号，然后 Systemd 再启动其他服务
idle：类似于simple，但是要等到其他任务都执行完，才会启动该服务。一种使用场合是为让该服务的输出，不与其他服务的输出相混合
下面是一个oneshot的例子，笔记本电脑启动时，要把触摸板关掉，配置文件可以这样写。
1
2
3
4
5
6
7
8
9
[Unit]
Description=Switch-off Touchpad

[Service]
Type=oneshot
ExecStart=/usr/bin/touchpad-off

[Install]
WantedBy=multi-user.target
上面的配置文件，启动类型设为oneshot，就表明这个服务只要运行一次就够了，不需要长期运行。
如果关闭以后，将来某个时候还想打开，配置文件修改如下。
1
2
3
4
5
6
7
8
9
10
11
[Unit]
Description=Switch-off Touchpad

[Service]
Type=oneshot
ExecStart=/usr/bin/touchpad-off start
ExecStop=/usr/bin/touchpad-off stop
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target
上面配置文件中，RemainAfterExit字段设为yes，表示进程退出以后，服务仍然保持执行。这样的话，一旦使用systemctl stop命令停止服务，ExecStop指定的命令就会执行，从而重新开启触摸板。
6.3 重启行为
Service区块有一些字段，定义了重启行为。
KillMode字段：定义 Systemd 如何停止 sshd 服务。
上面这个例子中，将KillMode设为process，表示只停止主进程，不停止任何sshd 子进程，即子进程打开的 SSH session 仍然保持连接。这个设置不太常见，但对 sshd 很重要，否则你停止服务的时候，会连自己打开的 SSH session 一起杀掉。
KillMode字段可以设置的值如下。
control-group（默认值）：当前控制组里面的所有子进程，都会被杀掉
process：只杀主进程
mixed：主进程将收到 SIGTERM 信号，子进程收到 SIGKILL 信号
none：没有进程会被杀掉，只是执行服务的 stop 命令。
接下来是Restart字段。
Restart字段：定义了 sshd 退出后，Systemd 的重启方式。
上面的例子中，Restart设为on-failure，表示任何意外的失败，就将重启sshd。如果 sshd 正常停止（比如执行systemctl stop命令），它就不会重启。
Restart字段可以设置的值如下。
no（默认值）：退出后不会重启
on-success：只有正常退出时（退出状态码为0），才会重启
on-failure：非正常退出时（退出状态码非0），包括被信号终止和超时，才会重启
on-abnormal：只有被信号终止和超时，才会重启
on-abort：只有在收到没有捕捉到的信号终止时，才会重启
on-watchdog：超时退出，才会重启
always：不管是什么退出原因，总是重启
对于守护进程，推荐设为on-failure。对于那些允许发生错误退出的服务，可以设为on-abnormal。
最后是RestartSec字段。
RestartSec字段：表示 Systemd 重启服务之前，需要等待的秒数。上面的例子设为等待42秒。
七、[Install] 区块
Install区块，定义如何安装这个配置文件，即怎样做到开机启动。
WantedBy字段：表示该服务所在的 Target。
Target的含义是服务组，表示一组服务。WantedBy=multi-user.target指的是，sshd 所在的 Target 是multi-user.target。
这个设置非常重要，因为执行systemctl enable sshd.service命令时，sshd.service的一个符号链接，就会放在/etc/systemd/system目录下面的multi-user.target.wants子目录之中。
Systemd 有默认的启动 Target。
1
2
$ systemctl get-default
multi-user.target
上面的结果表示，默认的启动 Target 是multi-user.target。在这个组里的所有服务，都将开机启动。这就是为什么systemctl enable命令能设置开机启动的原因。
使用 Target 的时候，systemctl list-dependencies命令和systemctl isolate命令也很有用。
1
2
3
4
5
6
# 查看 multi-user.target 包含的所有服务
$ systemctl list-dependencies multi-user.target

# 切换到另一个 target
# shutdown.target 就是关机状态
$ sudo systemctl isolate shutdown.target
一般来说，常用的 Target 有两个：一个是multi-user.target，表示多用户命令行状态；另一个是graphical.target，表示图形用户状态，它依赖于multi-user.target。
八、Target 的配置文件
Target 也有自己的配置文件。
1
2
3
4
5
6
7
8
9
$ systemctl cat multi-user.target

[Unit]
Description=Multi-User System
Documentation=man:systemd.special(7)
Requires=basic.target
Conflicts=rescue.service rescue.target
After=basic.target rescue.service rescue.target
AllowIsolate=yes
注意，Target 配置文件里面没有启动命令。
上面输出结果中，主要字段含义如下。
Requires字段：要求basic.target一起运行。
Conflicts字段：冲突字段。如果rescue.service或rescue.target正在运行，multi-user.target就不能运行，反之亦然。
After：表示multi-user.target在basic.target 、 rescue.service、 rescue.target之后启动，如果它们有启动的话。
AllowIsolate：允许使用systemctl isolate命令切换到multi-user.target。
九、修改配置文件后重启
修改配置文件以后，需要重新加载配置文件，然后重新启动相关服务。
1
2
3
4
5
# 重新加载配置文件
$ sudo systemctl daemon-reload

# 重启相关服务
$ sudo systemctl restart foobar
（完）
]]>
    
    https://sunshinechen.cn/2024/08/21/Systemd%E8%AF%A6%E8%A7%A3%EF%BC%882%EF%BC%89/
    
    2024-08-21T09:07:35.000Z
    

      Systemd 入门教程：实战篇
上一篇文章，我介绍了 Sys]]>
    
    
    2026-10-28T09:18:36.274Z
  
  
    
      jianhao
    
    
    
    
      在 Go 中借助标准库 runtime.debug 这个包的ReadBuildInfo函数去获取编译程序的各种信息，这个信息结构体如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
type BuildInfo struct {
// GoVersion is the version of the Go toolchain that built the binary
// (for example, "go1.19.2").
GoVersion string

// Path is the package path of the main package for the binary
// (for example, "golang.org/x/tools/cmd/stringer").
Path string

// Main describes the module that contains the main package for the binary.
Main Module

// Deps describes all the dependency modules, both direct and indirect,
// that contributed packages to the build of this binary.
Deps []*Module

// Settings describes the build settings used to build the binary.
Settings []BuildSetting
}
上面的结构体就可以获取到 go 的版本信息、路径等信息，其中Settings字段就包含了 git 相关的编译时间、提交 hash 等数据，BuildSetting 类型结构体如下：
1
2
3
4
5
6
type BuildSetting struct {
// Key and Value describe the build setting.
// Key must not contain an equals sign, space, tab, or newline.
// Value must not contain newlines ('\n').
Key, Value string
}
其中 Key 的的取值如下：
-buildmode: the buildmode flag used (typically “exe”)
-compiler: the compiler toolchain flag used (typically “gc”)
CGO_ENABLED: the effective CGO_ENABLED environment variable
CGO_CFLAGS: the effective CGO_CFLAGS environment variable
CGO_CPPFLAGS: the effective CGO_CPPFLAGS environment variable
CGO_CXXFLAGS: the effective CGO_CXXFLAGS environment variable
CGO_LDFLAGS: the effective CGO_LDFLAGS environment variable
GOARCH: the architecture target
GOAMD64/GOARM/GO386/etc: the architecture feature level for GOARCH
GOOS: the operating system target
vcs: the version control system for the source tree where the build ran
vcs.revision: the revision identifier for the current commit or checkout
vcs.time: the modification time associated with vcs.revision, in RFC3339 format
vcs.modified: true or false indicating whether the source tree had local modifications
从上述描述信息可以得知，BuildSetting 这个结构体以Key/Value的方式去存储各种编译信息，包含了 CGO,GOOS、GOARCH、VCS等各类信息，下面写一个程序来获取：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// buildInfo 输出编译信息中的修订版本和构建时间。
// 该函数尝试从debug.BuildInfo中提取VCS修订版本和构建时间，并打印出来。
func buildInfo() {
    // 尝试读取编译信息，如果成功则继续处理。
if buildInfo, ok := debug.ReadBuildInfo(); ok {
        // 在编译信息的设置中查找VCS修订版本。
revision, ok := lo.Find(buildInfo.Settings, func(setting debug.BuildSetting) bool {
return setting.Key == "vcs.revision"
})
if ok {
            // 如果找到了修订版本，打印出来。
fmt.Println(revision.Value)
}

        // 在编译信息的设置中查找VCS构建时间。
buildTime, ok := lo.Find(buildInfo.Settings, func(setting debug.BuildSetting) bool {
return setting.Key == "vcs.time"
})
if ok {
            // 如果找到了构建时间，解析并打印出来。
            // 时间格式化为"2006-01-02 15:04:05 -0700 MST"。
parse, _ := time.Parse(time.RFC3339, buildTime.Value)
fmt.Println(parse.Format(time.DateTime))
}
}
}

该 Go 函数 buildInfo()旨在从程序的编译元数据中提取并展示两个关键信息：版本控制系统的最新修订编号（Revision）以及构建发生的具体时间。下面是该函数执行步骤的详细分解：
读取构建信息:
首先调用 debug.ReadBuildInfo()尝试获取当前程序的构建元数据。此函数返回一个debug.BuildInfo结构体，其中包含了编译时的各种信息，如依赖关系、编译选项等。
查找 VCS 修订号:
使用 lo.Find()函数（假设 lo 包已导入，这是一个辅助库提供列表处理功能），遍历 buildInfo.Settings 切片来查找键为”vcs.revision”的条目。这是为了提取版本控制系统中的最后一次提交的修订标识。
如果找到匹配的设置项，则通过 revision.Value 打印出该修订号。
查找并格式化构建时间:
同样利用 lo.Find()方法，在设置中寻找键为”vcs.time”的条目，该条目通常包含最后一次 VCS 提交的时间戳。
发现时间戳后，尝试使用 time.Parse()函数按照 RFC3339 格式解析该时间字符串到 time.Time 类型。此步骤假设时间数据是符合 RFC3339 标准的字符串。
]]>
    
    https://sunshinechen.cn/2024/06/19/Go%E5%AE%9E%E7%8E%B0%E8%8E%B7%E5%8F%96%E7%BC%96%E8%AF%91%E7%A8%8B%E5%BA%8F%E7%9A%84git%E7%BC%96%E8%AF%91%E6%97%B6%E9%97%B4%E3%80%81%E6%8F%90%E4%BA%A4%E6%97%B6%E9%97%B4%E7%AD%89%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F/
    
    2024-06-19T07:12:04.000Z
    

      在 Go 中借助标准库 runtime.debug 这个包的ReadBuildInfo函数去获取编译程序的各种信息，这个信息结构体如下：


    
    
    2026-10-28T09:18:36.406Z
  
  
    
      jianhao
    
    
    
    
      简介
gcache是一个使用Go语言实现的内存缓存库，在github上有2.5k个star，支持LFU、LRU、ARC等多种缓存驱逐策略，可有利于对相对应思想的实现。
但该库最近的一次更新已经是2021年的，所以该库不推荐用于实际生产，仅作为源码学习使用。
根据KHWL图标来列举出一些知识点以及我想要学习的地方，如下图：
快速使用
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
package main

import (
  "github.com/bluele/gcache"
  "fmt"
)

func main() {
  gc := gcache.New(20).
    LRU().
    Build()
  gc.Set("key", "ok")
  value, err := gc.Get("key")
  if err != nil {
    panic(err)
  }
  fmt.Println("Get:", value)
}
运行结果：
1
Get: ok
我们调用了gcache库的New方法，传入一个int值，然后采用链式调用的方法，调用LRU方法，最后调用Build方法来初始化一个对象。然后使用该对象设置键值对，最后获取并打印。
在上面代码中可以看出，初始化对象时该库使用了建造者模式，只有一个必传参数也就是New方法的size参数，该参数代表内存中可存储的最大键值对数量，其他参数都可通过链式方法进行调用。
说明
在Go中，除了这种建造者模式，还可以通过闭包来实现函数式传参。
获取对象之后，就像其他内存库一样，调用Set和Get方法即可设置和获取键值对。
缓存过期时间
在使用该库去设置键值对的时候，默认是不会过期的，除非你显示的调用SetWithExpire方法并传入time.Duration参数，这样才会有指定的时间将缓存删除掉。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
package main

import (
  "github.com/bluele/gcache"
  "fmt"
  "time"
)

func main() {
  gc := gcache.New(20).
    LRU().
    Build()
  gc.SetWithExpire("key", "ok", time.Second*10)
  value, _ := gc.Get("key")
  fmt.Println("Get:", value)

  // Wait for value to expire
  time.Sleep(time.Second*10)

  value, err := gc.Get("key")
  if err != nil {
    panic(err)
  }
  fmt.Println("Get:", value)
}
输出：
1
2
3
Get: ok
// 10 seconds later, new attempt:
panic: ErrKeyNotFound
可以看出在设置key同时指定了一个过期时间，在等待了指定时间后再去获取，该key已经从内存中删除了。
当指定数据不存在时自动获取
当获取一个不存在的key时，支持自动的去设置该key的value。为了实现这个效果，gcache暴露了一个LoaderFunc类型，在初始化缓存对象时通过链式调用进行传入，这是它的定义：
1
2
3
4
type (  
    LoaderFunc       func(interface{}) (interface{}, error)  
// 其他类型
)
这是一个函数类型，参数是对应不存在值的key，返回一个数据和error，下面是使用方式：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
package main

import (
  "github.com/bluele/gcache"
  "fmt"
)

func main() {
  gc := gcache.New(20).
    LRU().
    LoaderFunc(func(key interface{}) (interface{}, error) {
      return "ok", nil
    }).
    Build()
  value, err := gc.Get("key")
  if err != nil {
    panic(err)
  }
  fmt.Println("Get:", value)
}
从上面代码可以看出，在创建缓存对象时传入了一个LoaderFunc匿名函数，始终返回ok字符串和空错误，所以在获取key这个对象时，会直接返回ok。
1
Get: ok
在此基础上，同样支持对指定key和value的expire过期时间，使用方式就是将上面的LoaderFunc方法替换成LoaderExpireFunc方法，该方法会多添加一个返回值，就是该key的过期时间。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
package main

import (
  "fmt"
  "time"

  "github.com/bluele/gcache"
)

func main() {
  var evictCounter, loaderCounter, purgeCounter int
  gc := gcache.New(20).
    LRU().
    LoaderExpireFunc(func(key interface{}) (interface{}, *time.Duration, error) {
      expire := 1 * time.Second
      return "ok", &expire, nil
    }).
    Build()
  value, err := gc.Get("key")
  if err != nil {
    panic(err)
  }
  fmt.Println("Get:", value)
  time.Sleep(1 * time.Second)
  value, err = gc.Get("key")
  if err != nil {
    panic(err)
  }
  fmt.Println("Get:", value)
}
输出：
1
2
Get: ok
Get: ok
内存缓存的一些通用操作它都有，比如删除、所有key、获取缓存中的key的数量、删除所有key、判断一个key是否在缓存中等等。
源码实现
CacheBuilder
首先从库的包级函数New入手，该函数返回CacheBuilder结构体，用于构建Cache对象，对象字段如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
type CacheBuilder struct {  
    clock            Clock  
    tp               string  
    size             int  
    loaderExpireFunc LoaderExpireFunc  
    evictedFunc      EvictedFunc  
    purgeVisitorFunc PurgeVisitorFunc  
    addedFunc        AddedFunc  
    expiration       *time.Duration  
    deserializeFunc  DeserializeFunc  
    serializeFunc    SerializeFunc  
}  
  
func New(size int) *CacheBuilder {  
    return &CacheBuilder{  
       clock: NewRealClock(),  
       tp:    TYPE_SIMPLE,  
       size:  size,  
    }  
}
对应链式调用函数就将该对象的字段设置成入参，然后返回该对象指针，例如：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
func (cb *CacheBuilder) Simple() *CacheBuilder {  
    return cb.EvictType(TYPE_SIMPLE)  
}  
  
func (cb *CacheBuilder) LRU() *CacheBuilder {  
    return cb.EvictType(TYPE_LRU)  
}  
  
func (cb *CacheBuilder) LFU() *CacheBuilder {  
    return cb.EvictType(TYPE_LFU)  
}  
  
func (cb *CacheBuilder) ARC() *CacheBuilder {  
    return cb.EvictType(TYPE_ARC)  
}
上述代码设置该缓存对象的过期对象驱逐策略，将EvictType设置成对应的常量，然后调用Build方法开始构建：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
func (cb *CacheBuilder) Build() Cache {  
// 参数校验
    if cb.size <= 0 && cb.tp != TYPE_SIMPLE {  
       panic("gcache: Cache size <= 0")  
    }  
  
    return cb.build()  
}  

// Cache是一个接口，包含了对缓存的通用操作
func (cb *CacheBuilder) build() Cache {
// 根据驱逐策略选择的不同去实例化不同对象
    switch cb.tp {  
    case TYPE_SIMPLE:  
       return newSimpleCache(cb)  
    case TYPE_LRU:  
       return newLRUCache(cb)  
    case TYPE_LFU:  
       return newLFUCache(cb)  
    case TYPE_ARC:  
       return newARC(cb)  
    default:  
       panic("gcache: Unknown type " + cb.tp)  
    }  
}
如果不选择驱逐策略，那么就是默认的TYPE_SIMPLE类型，则不驱逐缓存。
Cache
在gcache中定义了一个接口Cache，一个驱逐策略就对应一个结构体，实现该接口，以下是接口的定义：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
type Cache interface {  
    // Set inserts or updates the specified key-value pair.    
    Set(key, value interface{}) error  
    // SetWithExpire inserts or updates the specified key-value pair with an expiration time.    
    SetWithExpire(key, value interface{}, expiration time.Duration) error  
    // Get returns the value for the specified key if it is present in the cache.    // If the key is not present in the cache and the cache has LoaderFunc,  
    // invoke the `LoaderFunc` function and inserts the key-value pair in the cache.    // If the key is not present in the cache and the cache does not have a LoaderFunc,  
    // return KeyNotFoundError.  
    Get(key interface{}) (interface{}, error)  
    // GetIFPresent returns the value for the specified key if it is present in the cache.    
    // Return KeyNotFoundError if the key is not present.    
    GetIFPresent(key interface{}) (interface{}, error)  
    
    // GetAll returns a map containing all key-value pairs in the cache.  
    GetALL(checkExpired bool) map[interface{}]interface{}  
    get(key interface{}, onLoad bool) (interface{}, error)  
    // Remove removes the specified key from the cache if the key is present.    
    // Returns true if the key was present and the key has been deleted.    
    Remove(key interface{}) bool  
    // Purge removes all key-value pairs from the cache.    
    Purge()  
    // Keys returns a slice containing all keys in the cache.    
    Keys(checkExpired bool) []interface{}  
    // Len returns the number of items in the cache.    
    Len(checkExpired bool) int  
    // Has returns true if the key exists in the cache.    
    Has(key interface{}) bool  
}
定义了内存库中的一些常规操作。
SimpleCache
在初始化缓存对象时如果指定具体的内存驱逐策略，则使用SimpleCache结构来作为默认的缓存对象，这个对象结构比较简单，处理在建造者模式中获取到的其他数据之外，还有一个map类型的变量items来存放对应的键值对，value是一个包装后的simpleItem结构体。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
type baseCache struct {  
    clock            Clock  
    size             int  
    loaderExpireFunc LoaderExpireFunc  
    evictedFunc      EvictedFunc  
    purgeVisitorFunc PurgeVisitorFunc  
    addedFunc        AddedFunc  
    deserializeFunc  DeserializeFunc  
    serializeFunc    SerializeFunc  
    expiration       *time.Duration  
    mu               sync.RWMutex  
    loadGroup        Group  
    *stats  
}

type simpleItem struct {  
    clock      Clock  
    value      interface{}
    // 这个value的过期时间  
    expiration *time.Time  
}

// SimpleCache has no clear priority for evict cache. It depends on key-value map order.
type SimpleCache struct {  
    baseCache  
    items map[interface{}]*simpleItem  
}
SimpleCache对象实现了Cache接口，现在来看这个库设置key时是如何处理过期时间的，在调用Set()和SetWithExpirce()方法时，最终都会调用simpleCache.set()方法，只不过这两者的区别是SetWithExpirce方法会计算过期时间，并将时间设置到simpleItem对象的expiration字段。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
// Set a new key-value pair
func (c *SimpleCache) Set(key, value interface{}) error {  
    c.mu.Lock()  
    defer c.mu.Unlock()  
    _, err := c.set(key, value)  
    return err  
}

// Set a new key-value pair with an expiration time
func (c *SimpleCache) SetWithExpire(key, value interface{}, expiration time.Duration) error {  
    c.mu.Lock()  
    defer c.mu.Unlock()  
    item, err := c.set(key, value)  
    if err != nil {  
       return err  
    }  
// 计算这个key的过期时间，并将该时间设置到simpleItem的expiration字段
    t := c.clock.Now().Add(expiration)  
    item.(*simpleItem).expiration = &t  
    return nil  
}

// simpleCache的核心逻辑函数
func (c *SimpleCache) set(key, value interface{}) (interface{}, error) {  
    var err error
    // 查看这个缓存是否有设置自己的序列化函数，有的话就序列化，反之跳过  
    if c.serializeFunc != nil {  
       value, err = c.serializeFunc(key, value)  
       if err != nil {  
          return nil, err  
       }  
    }  
  
    // Check for existing item  
    item, ok := c.items[key]
    // 查看该key是否已经在缓存中，如果有则更新  
    if ok {  
       item.value = value  
    } else {
       // 没有的话则要判断当前缓存是否已经满了，满了的话则要驱逐
       if (len(c.items) >= c.size) && c.size > 0 {  
      // 驱逐一个缓存
          c.evict(1)  
       }  
       item = &simpleItem{  
          clock: c.clock,  
          value: value,  
       }  
       c.items[key] = item  
    }  

    if c.expiration != nil {  
       t := c.clock.Now().Add(*c.expiration)  
       item.expiration = &t  
    }  
  
    if c.addedFunc != nil {  
       c.addedFunc(key, value)  
    }  
  
    return item, nil  
}
上面的逻辑也很简单，先判断是否设置了序列化函数，如果有则先将值进行序列化。然后判断该key数据是否在缓存中存在，如果存在则替换，不存在的话判断当前缓存的数量是否已经满了，满了则驱逐一个，否则直接添加。
然后判断是否有自定义添加key的回调函数，有则调用。
那在SimpleCache是如何判断该key过期的呢，是在simpleItem结构体里定义了一个IsExpired方法，传入一个time.Time类型。
map中对应存储的value是一个simpleItem结构，并且存储了expiration字段作为该值的过期时间。调用time.Time的Before方法，来判断过期时间是否在传入时间之前，返回该布尔值，代码如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
// 外部应用调用的方法
func (c *SimpleCache) Get(key interface{}) (interface{}, error) {  
    v, err := c.get(key, false)  
    if err == KeyNotFoundError {  
       return c.getWithLoader(key, true)  
    }  
    return v, err  
}

func (c *SimpleCache) get(key interface{}, onLoad bool) (interface{}, error) {
// 获取key
    v, err := c.getValue(key, onLoad)  
    if err != nil {  
       return nil, err  
    }
    // 解码  
    if c.deserializeFunc != nil {  
       return c.deserializeFunc(key, v)  
    }  
    return v, nil  
}

func (c *SimpleCache) getValue(key interface{}, onLoad bool) (interface{}, error) {  
    c.mu.Lock()  
    item, ok := c.items[key]  
    if ok {
    // 判断  
       if !item.IsExpired(nil) {  
          v := item.value  
          c.mu.Unlock()  
          if !onLoad {  
             c.stats.IncrHitCount()  
          }  
          return v, nil  
       }  
       c.remove(key)  
    }  
    c.mu.Unlock()  
    if !onLoad {  
       c.stats.IncrMissCount()  
    }  
    return nil, KeyNotFoundError  
}

// IsExpired returns boolean value whether this item is expired or not.
func (si *simpleItem) IsExpired(now *time.Time) bool {  
    if si.expiration == nil {  
       return false  
    }  
    if now == nil {  
       t := si.clock.Now()  
       now = &t  
    }
    // 判断是否过期  
    return si.expiration.Before(*now)  
}
还有一个点，那就是simpleCache在键值对达到上限之后，是如何驱逐内存的。在上面的代码上可以看出，是调用了evict函数，实现如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
func (c *SimpleCache) evict(count int) {  
    now := c.clock.Now()  
    current := 0  
    for key, item := range c.items {  
       if current >= count {  
          return  
       }  
       if item.expiration == nil || now.After(*item.expiration) {  
          defer c.remove(key)  
          current++  
       }  
    }  
}
从代码中可以看出，就是遍历该map，然后将遍历到的第一个过期的value删除。
LFU
LFU（最少使用）算法会淘汰缓存中访问次数最少的数据。
其核心原则是，如果数据过去被访问多次，那么将来被访问的频率也会更高。
在 LFU 实现中，通常需要维护一个按照访问次数排序的队列，每次访问时，次数加1，队伍重新排序，淘汰时选择访问次数最少的即可。
在gcache中，选择是用list来存放访问频率，并且类似simpleCache一样，将存入的数据封装成一个对象，该对象也包含了该list节点的指针，这样被存放的对象和存放频率的list对象就能相互引用。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
type lfuItem struct {  
    clock       Clock  
    key         interface{}  
    value       interface{}
    // 这里的list是标准库实现包  
    freqElement *list.Element  
    expiration  *time.Time  
}

// 链表中实际存放的元素类型
type freqEntry struct {
// 代表访问频率
    freq  uint
    // 当前访问频率的元素  
    items map[*lfuItem]struct{}  
}

// 该方法会初始化LFU cache的时候调用
func (c *LFUCache) init() {  
    c.freqList = list.New()  
    c.items = make(map[interface{}]*lfuItem, c.size)  
    c.freqList.PushFront(&freqEntry{  
       freq:  0,  
       items: make(map[*lfuItem]struct{}),  
    })  
}

func (c *LFUCache) set(key, value interface{}) (interface{}, error) {  
// 精简掉一些不关主流程的代码
    // Check for existing item  
    item, ok := c.items[key]  
    if ok {  
       item.value = value  
    } else {  
       // 如果当前大小大于预先设定好的数量，则驱逐一个  
       if len(c.items) >= c.size {  
          c.evict(1)  
       }  
       item = &lfuItem{  
          clock:       c.clock,  
          key:         key,  
          value:       value,  
          freqElement: nil,  
       }  
       // 获取链表第一个节点
       el := c.freqList.Front()
       // 进行类型断言，获取到正确类型对象
       fe := el.Value.(*freqEntry)
       // 在当前访问频率的对象中将新增节点添加
       fe.items[item] = struct{}{}

   // 然后将代表访问频率的指针对象也赋值给value对象
       item.freqElement = el
       c.items[key] = item
    }
  
// 精简掉一些不关主流程的代码
    return item, nil  
}
从上面代码可以看出，在新增一个缓存对象时，将缓存对象包装成lfuItem类型，因为是新增，所以访问频率是1，从LFUCache类型对象里获取链表的第一个节点（即访问频率为0的节点），该链表节点实际存储的类型是freqEntry类型，使用一个map来存储当前访问频率的元素集合，将新增元素添加到map中。最后也将该链表节点的指针赋值给lfuItem。
为什么要将链表节点的指针赋值给lfuItem中呢？因为要在后面更新频率是用到。gcache是如何更新访问频率的呢？
访问一次缓存就会更新频率，源码如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
func (c *LFUCache) getValue(key interface{}, onLoad bool) (interface{}, error) {  
    c.mu.Lock()  
    item, ok := c.items[key]  
    if ok {
   // 缓存中存在这个key并且没有过期时才会更新频率  
       if !item.IsExpired(nil) {
          // 更新频率的实现函数  
          c.increment(item)  
          v := item.value  
          c.mu.Unlock()  
          // 精简其他代码  
          return v, nil  
       }
       // 缓存存在该key但过期了，那就删除该项  
       c.removeItem(item)  
    }
    // 精简其他代码  
    return nil, KeyNotFoundError  
}

// 实际更新频率的函数
func (c *LFUCache) increment(item *lfuItem) {
// 获取缓存对象所对应的链表节点
    currentFreqElement := item.freqElement
    // 将链表节点通过类型断言转换成freqEntry  
    currentFreqEntry := currentFreqElement.Value.(*freqEntry)
    // 访问频率加1  
    nextFreq := currentFreqEntry.freq + 1
    // 从链表节点的map中删除该缓存对象，因为它的访问频率已经加1了  
    delete(currentFreqEntry.items, item)  
  
    // a boolean whether reuse the empty current entry
    // 判断这个链表节点是否要被删除，判断条件是当前节点的freq不等于0并且该节点的map长度为0
    removable := isRemovableFreqEntry(currentFreqEntry)  
  
    // 获取当前节点的下一个节点  
    nextFreqElement := currentFreqElement.Next()  
    switch {  
    case nextFreqElement == nil || nextFreqElement.Value.(*freqEntry).freq > nextFreq:
       // 如果当前节点的下一个节点是nil的
       // 或者当前节点的下一个节点的频率大于预期频率
       if removable {
      // 当前节点的freq不为0并且该节点的map长度为0
      // 用预期频率替换掉当前节点的freq  
          currentFreqEntry.freq = nextFreq  
          nextFreqElement = currentFreqElement  
       } else {
          // 当前节点还有其他缓存所以不删除，在当前节点的后面新增一个节点
          nextFreqElement = c.freqList.InsertAfter(&freqEntry{  
             freq:  nextFreq,  
             items: make(map[*lfuItem]struct{}),  
          }, currentFreqElement)  
       }  
    case nextFreqElement.Value.(*freqEntry).freq == nextFreq:
       // 当前节点的下一个节点的freq正好是预期频率  
       if removable {  
          c.freqList.Remove(currentFreqElement)  
       }  
    default:  
       panic("unreachable")  
    }
    // 然后在链表节点里的map添加缓存对象
    nextFreqElement.Value.(*freqEntry).items[item] = struct{}{}  
    item.freqElement = nextFreqElement  
}

从上面代码可以看出，从缓存对象中获取链表节点指针，将指针通过类型断言转换成freqEntry类型，然后将缓存对象从freqEntry类型中的map中删除，把频率自增1并赋值给 nextFreq。
再获取当前链表节点的下一个节点，判断是否为nil 或者 下一个节点的 freq 值大于 nextFreq，再根据当前链表节点是否要删除再选择是要插入一个新节点还是在当前节点添加。
然后在更新下缓存对象和链表节点的双向指针引用，这样就完成了更新频率。
访问频率低的总会是在链表的第一个节点，所以在开始驱逐的时候，就从链表第一个节点开始删除，链表节点存放这一个map，代表当前频率的缓存对象，然后遍历这个map，将获取到的元素删除掉。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
func (c *LFUCache) evict(count int) {  
    entry := c.freqList.Front()  
    for i := 0; i < count; {  
       if entry == nil {  
          return  
       } else {  
          for item := range entry.Value.(*freqEntry).items {  
             if i >= count {  
                return  
             }  
             c.removeItem(item)  
             i++  
          }  
          entry = entry.Next()  
       }  
    }  
}

func (c *LFUCache) removeItem(item *lfuItem) {  
    entry := item.freqElement.Value.(*freqEntry)  
    delete(c.items, item.key)  
    delete(entry.items, item)  
    if isRemovableFreqEntry(entry) {  
       c.freqList.Remove(item.freqElement)  
    }  
    if c.evictedFunc != nil {  
       c.evictedFunc(item.key, item.value)  
    }  
}
LRU
LRU（最近最少使用）算法会在缓存写满的时候，会根据所有数据的访问记录，淘汰掉未来被访问几率最低的数据。
阅读源码时发现，其核心逻辑和LFU大体上一致，只不过LRU不用维护访问频率链表，转而维护一个存放缓存对象的双向链表。当获取缓存时，将代表缓存对象的链表对象移动到链表头部。后面开始删除缓存时，获取最后链表的最后一个元素删除即可。
LRU的列表定义：
1
2
3
4
5
6
7
8
// Discards the least recently used items first.  
type LRUCache struct {  
    baseCache
    // 存放key和value的对应关系
    items     map[interface{}]*list.Element
    // 存放所有value的链表  
    evictList *list.List  
}
设置缓存对象的调用逻辑和LFU差不多
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
func (c *LRUCache) set(key, value interface{}) (interface{}, error) {  
    var err error  
    // 精简代码
  
    // Check for existing item  
    var item *lruItem  
    if it, ok := c.items[key]; ok {
       // 该缓存存在，则将该缓存对应的链表对象，移动到链表的头部  
       c.evictList.MoveToFront(it)  
       item = it.Value.(*lruItem)  
       item.value = value  
    } else {  
       // Verify size not exceeded
       // 该缓存对象没有存在
       // 判断当前的缓存池是否已经满了，如果满了则驱逐一个  
       if c.evictList.Len() >= c.size {  
          c.evict(1)  
       }
       // 构造缓存对象  
       item = &lruItem{  
          clock: c.clock,  
          key:   key,  
          value: value,  
       }
       // 将该缓存对象移动到头部，然后设置到map中
       // 设置时也代表着该缓存是活跃的，所以会移动到头部。  
       c.items[key] = c.evictList.PushFront(item)  
    }  
// 精简代码
    return item, nil  
}
那驱逐时是怎么驱逐的？这里很简单，直接获取到链表的尾部元素，直接驱逐即可。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// evict removes the oldest item from the cache.func (c *LRUCache) evict(count int) {  
    for i := 0; i < count; i++ {  
       ent := c.evictList.Back()  
       if ent == nil {  
          return  
       } else {  
          c.removeElement(ent)  
       }  
    }  
}

func (c *LRUCache) removeElement(e *list.Element) {  
    c.evictList.Remove(e)  
    entry := e.Value.(*lruItem)  
    delete(c.items, entry.key)  
    if c.evictedFunc != nil {  
       entry := e.Value.(*lruItem)  
       c.evictedFunc(entry.key, entry.value)  
    }  
}
获取缓存对象
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
func (c *LRUCache) getValue(key interface{}, onLoad bool) (interface{}, error) {  
    c.mu.Lock()  
    item, ok := c.items[key]
    // 判断该缓存对象是否已经存在  
    if ok {  
       it := item.Value.(*lruItem)
       // 判断该缓存对象是否已经到期  
       if !it.IsExpired(nil) {
      // 没有到期则将链表节点移动到头部并返回  
          c.evictList.MoveToFront(item)  
          v := it.value  
          c.mu.Unlock()  
          if !onLoad {  
             c.stats.IncrHitCount()  
          }  
          return v, nil  
       }
       // 该缓存已经过期，删除  
       c.removeElement(item)  
    }  
    c.mu.Unlock()  
    if !onLoad {  
       c.stats.IncrMissCount()  
    }
    // 走到这就意味着缓存已经过期，所以返回该key找不到的错误  
    return nil, KeyNotFoundError  
}
缓存过期时间的实现
缓存过期时间的实现比较简单，在生成缓存对象的时候会生成过期时间的Time对象，然后在获取缓存的时候，判断该缓存对象的Time对象是否已经过期，过期了就删除该对象并且返回KeyNotFoundErr错误，否则返回该对象。
从上面章节我们知道，gcache定义了一个缓存接口，包含了许多缓存操作方法，每种缓存驱逐策略都实现了这个接口，每种实现对于缓存过期时间，都是一种方法，所以我就贴出其中一种。下面是LRU的缓存过期时间实现
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
type lruItem struct {  
    clock      Clock  
    key        interface{}  
    value      interface{}  
    expiration *time.Time  
}  
  
// IsExpired returns boolean value whether this item is expired or not.func (it *lruItem) IsExpired(now *time.Time) bool {  
    if it.expiration == nil {  
       return false  
    }  
    if now == nil {  
       t := it.clock.Now()  
       now = &t  
    }  
    return it.expiration.Before(*now)  
}
]]>
    
    https://sunshinechen.cn/2024/03/13/gcache%EF%BC%8C%E4%B8%80%E4%B8%AA%E7%94%A8go%E5%AE%9E%E7%8E%B0%E7%9A%84%E5%86%85%E5%AD%98%E5%BA%93/
    
    2024-03-13T06:38:03.000Z
    

      简介
gcache是一个使用Go语言实现的内存缓存库，在github上有2.5k个star，支持LFU、LRU、ARC等]]>
    
    
    2026-10-28T09:18:36.414Z