MinsonLee's Blog

Windows 和 Linux 下如何查看内存条硬件信息

Fri, 19 Sep 2025 00:00:00 +0000

Windows 查看内存条信息

通过命令 wmic 查看：xxx get /format:list 可以将列数据转为行显示
- 获取当前内存条的详细信息：wmic memorychip
- 如果只关心「当前有多少条内存条？给自多大字节？」 wmic memorychip get Tag,Capacity /format:list
- 当前电脑主板支持最大扩展到多大内存？wmic MEMPHYSICAL get /format:list

通过「任务管理器-taskmgr」查看：

Linux 查看内存条信息

通过 dmidecode -t memory 获取内存条硬件信息
通过 lsmem 或 free -h 命令可以获取当前计算机的总内存信息

简单的告警闪烁效果

Tue, 26 Aug 2025 00:00:00 +0000

后台一些功能，经常一些选项发生变更之后其联动数据需要产品二次确认。然后…没有确认，导致错误添加一些翻译任务数据，又来找开发进行手动数据处理。为防止这种“老花眼”现象…做了一个简单的告警闪烁。

效果如下：

后台非常老旧…所以用原生的 JS 进行了简单实现，记录一下：

// 闪烁函数
function flash(id, count, originalColor) {
    if (count <= 0) return; // 闪烁3次后停止
    console.log(count);

    document.getElementById(id).style.backgroundColor = '#ff0000';
    setTimeout(() => {
        // 恢复原始颜色
        document.getElementById(id).style.backgroundColor = originalColor;
        setTimeout(() => {
            flash(id, count-1, originalColor); // 递归调用
        }, 500); // 原始颜色持续500ms
    }, 500); // 红色持续500ms
}

// 调用案例：闪烁 3 次
flash("lang_str", 3, document.getElementById('lang_str').style.backgroundColor);

Windows 自带的电池健康检测

Tue, 17 Jun 2025 00:00:00 +0000

Win + R 输入 cmd
在 cmd 界面输入 powercfg /BATTERYREPORT，然后等待一会儿就会生成一份 HTML 版的电池使用时间报告
通过浏览器打开对应的文件即可查看

电池容量情况：

电池使用时长：

SEO：通过 IndexNow 向 Bing 推送站点链接

Tue, 17 Jun 2025 00:00:00 +0000

因为微软是 ChatGPT 的大投资人，AI 搜索虽然还没有非常好的一个模式，但是是一个必然趋势。但站点在 Bing 上的收录数据在 Bing Webmaster Tool 看到不是很乐观。因此想通过 IndexNow 接口提交一次链接，触发 Bing 重新抓取一次，看看能否提高站点内容再 Bing 搜索或 ChatGPT AI 搜索结果中的可见性，从而提高流量。

IndexNow

页面 [How to add IndexNow to your website Bing Webmaster Tools](https://www.bing.com/indexnow/getstarted) 中提到推荐使用 IndexNow 来向其推送站点的链接。

IndexNow.org 中提到 IndexNow 是一个面向搜索引擎的简单协议(Simple ping)，用于告知搜索引擎对应 URL 及其内容已被添加、更新或删除，从而帮助搜索引擎优先处理这些 URL，使对应搜索引擎能在其搜索结果中快速反映对应 URL 的结果。

因为如果不用 IndexNow，那么站点内容变更之后，就只能变更站点地图，然后去搜索引擎管理控制台删除重新提交一次站点地图。传统方式的弊端明显：「针对性不足、浪费抓取值」 - 搜索引擎只能被动全部爬取站点地图链接，及时 URL 对应的页面内容没有变化也会被重新的爬取检查…

理念确实是蛮好的，但是…发现只有 Bing/Naver/Seznam.cz/Yandex/Yep 寥寥几家搜索引擎组织接入了。Naver 是一个韩语搜索引擎（类似“百度”于中国而言），大头的搜索引擎就 Bing 一家，有些可惜。

对应搜索引擎的 IndexNow 接口地址，可以通过 https://www.indexnow.org/searchengines.json 地址获取。或查看文档：[Documentation for search engines IndexNow.org](https://www.indexnow.org/searchengines)。更多使用上的 FAQ 可以查看官方文档：[FAQ IndexNow.org](https://www.indexnow.org/faq)

Bing IndexNow 接入

去 https://www.bing.com/indexnow/getstarted 页面下载一个 IndexNow 密钥文件（随机的 32 位字符串），上传到站点项目根目录。验证 https://www.example.com/xxx.txt 能否访问
向对应 https://<searchengine>/indexnow 接口提交 URL
- Get 请求提交单条链接：https://<searchengine>/indexnow?url=<url>&key=xxxxx&keyLocation=https://www.example.com/xxx.txt
- POST 请求批量提交如下：https://<searchengine>/indexnow?key=xxxxx&keyLocation=https://www.example.com/xxx.txt
POST /indexnow HTTP/1.1 Content-Type: application/json; charset=utf-8 Host: { "host": "www.example.com", "key": "7b1f89baa1204612a933816dce46bcbf", "keyLocation": "https://www.example.com/myIndexNowKey63638.txt", "urlList": [ "https://www.example.com/url1", "https://www.example.com/folder/url2", "https://www.example.com/url3" ] }

注意事项

首次请求的时候，可能会报 403 错误，跟你配置没有任何关系，等一段时间，重新请求即可

{
    "code": "SiteVerificationNotCompleted",
    "message": "Site Verification is not completed. Please wait for some time for the verification to complete and try again.""
}

如果提交成功，indexnow 接口是通过 HTTP Code 是否为 200 来判断的。没有任何响应 body

HTTP/2 200 Cache-Control: no-cache Pragma: no-cache Expires: -1 X-AspNet-Version: 4.0.30319 X-Powered-By: ASP.NET X-Cache: CONFIG_NOCACHE Accept-CH: Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version X-MSEdge-Ref: Ref A: D4365A3C600C4724A380EDCD7DF5DD4B Ref B: HKBEDGE0912 Ref C: 2025-06-17T06:07:42Z Date: Tue, 17 Jun 2025 06:07:46 GMT Content-Length: 0
如何验证真的提交成功了呢？

提交后，等待一小会儿，登录 Bing Webmaster Tool（如果已经登录，记得刷新一下页面），切换对应站点。点击菜单栏中 IndexNow 即可看见今天提交的链接：

抓取测试结果

提交结果之后大约 1 分钟左右，Bing 确实是来站点进行了抓取，但 ChatGPT 抓取频率没有什么显著变化

Java 中如何告别面条式的 null 判断”

Thu, 03 Aug 2023 00:00:00 +0000

Java 中如何告别面条式的 null 判断

[TOC]

背景

最近在写 Java，其中 MongoDB 中存了某个文档数据，「如果存在」结构是如下这样：

{
    "localtion":{
        "pickup":{
            "region":{
                "region_en":"China"
            }
        }
    }
}

现在需要判断如果 region_en 有值就拿出来，在 PHP 中用 empty() 函数处理即可：

$regionEn = '';
if(!empty($carDetail['location']['pickup']['region']['rengion_en'])) {
    $regionEn = $carDetail['location']['pickup']['region']['rengion_en'];
}

由于刚开始写 Java 时没有留意，写 carDetail.getLocation().getPickup().getRegion().getRegionEn() 经常会报 NullPointExceptions（很多Java文章会称其为NPE）.

改为：

String regionEn = "";
if(
    carDetail != null 
    && carDetail.getLocation() != null 
    && carDetail.getLocation().getPickup() != null 
    && carDetail.getLocation().getPickup().getRegion().getRegionEn() != null
) {
    regionEn = carDetail.getLocation().getPickup().getRegion().getRegionEn();
}

或者有其他逻辑需要处理那么可能是此类嵌套判断 NPE 的情况：

String regionEn = "";
if(carDetail != null) {
    // 其他逻辑
    if(carDetail.getLocation() != null) {
        // 其他逻辑
        if(carDetail.getLocation().getPickup() != null) {
            // 其他逻辑
            regionEn = carDetail.getLocation().getPickup().getRegion().getRegionEn() != null 
                ? carDetail.getLocation().getPickup().getRegion().getRegionEn() 
                : "";
        }
    }
}

在 Java8 中引入 java.util.Optional 工具类可以相对简洁的处理这种「面条式“if-else if”」的 null 判断代码。

String regionEn = Optional.ofNullable(carDetail)
    .map(c -> c.getLocation())
    .map(l -> l.getPickup())
    .map(p -> p.getRegionEn())
    .orElse("else");

`Optional` 类源码简读

Optional 主要是用于避免空指针异常（NullPointerException）的一个工具类（可看做是类似一种“语法糖”），可以通过链式调用的方式进行管道处理数据。

通过 IDEA 简单的浏览一下源码的 Structure，该类比较简单：

@jdk.internal.ValueBased 标注了这是一个 value-based 类，即：基于值的类
- 什么是基于值的？只要“值”相同，这两个对象就应该被视为完全相同的对象
- 注意事项是什么？不应该使用引用相等（如：== 操作符）去判断基于值的对象是否相等，而是使用 equals() 方法
- https://matthung0807.blogspot.com/2019/05/java-value-based-classes.html
该类有两个私有属性
- 空 Optinal 类对象：private static final Optional<?> EMPTY = new Optional<>(null)
- 泛型 T 的 value 对象：private final T value
该类构造方法是私有的，不能直接实例化
注意：Optional 并非解决繁杂的 if-else if，而是为了避免用 if-else if 的进行 null 空指针异常判断而诞生的！！！

1、获取 `Optional` 对象

获取一定不为空的 Optional<T> 对象：Optional.of(T value)，表示 value 一定为非空的，如果为 null 会抛出 NullPointerException 异常
获取空的 Optional<T> 对象：Optional.empty()，返回 (Optional<T>) new Optional<>() 对象「这个空 Optional 对象的意义是什么呢？？」
获取可能不为空的 Optional<T> 对象：Optional.ofNullable(T value)，其实就是 return value == null ? Optional.empty() : Optional.of(value)

2、过滤、转换数据的方法

if (value != null) {
	// true 处理逻辑
} else {
	// false 处理逻辑
}

filter(Predicate<? super T> predicate) : 如果 value!=null 或者 predicate.test(value) 结果为 true 返回自身，否则返回 Optional.empty
ifPresent(Consumer<? super T> consumer)：基于值 null != null 的情况执行if 逻辑
ifPresentOrElse(Consumer<? super T> consumer) : Java 9 新增方法，基于值的 null 情况，处理 if-else 的情况
map(Function<? super T, ? extends U> mapper) : 如果当前对象的 value 值存在则将 mapper.apply() 方法的结果包装为一个 Optional 对象返回，即：「Optional<Optional>」对象
flatMap(Function<? super T, Optional> mapper) 当 value != null 时返回 mapper.apply() 结果「Optional」对象。否则返回 Optional.empty()
or(Supplier<? extends Optional<? extends T>> supplier) ： Java 9 新增方法，如果 value 为 null 则返回 (Optional<T>) supplier.get()
stream()：Java 9 新增方法，返回一个 Stream<T> 流对象

！！！注意：

Predicate、Consumer、Consumer、Function 都是函数式接口，其中只有 1 个方法，因此可以用 Lambda 表达式来匿名实现
这些过滤、转换方法，传入参数是 @FunctionalInterface 的匿名函数式接口实现，如果传 null 都会报异常
map、flatMap 两个方法是有差异的

3、获取 `Optional` 的值

get() : 获取 value 值，如果 value 为 null 则抛出 NoSuchElementException 异常，因此使用的时候需要确定对象的 value 是否确实有值
orElse(T other) : 如果 value 不为 null 则返回 value，否则返回 other「PHP 中的三元运算符 a ?: b，若 a true 则返回 a，否则返回 b」
orElseGet(Supplier<? extends T> other) : 如果 value 为 null 则调用实现了 Supplier Interface 的 other.get() 方法返回的默认内容
orElseThrow(Supplier<? extends X> exceptionSupplier) : 如果值为 null 则 throw exceptionSupplier.get() （自定义异常的 Message 信息）
toString() : 适合记录 log 的时候，返回字符串String.format("Optional[%s]", value) 或字符串 Optional.empty
hashCode() : 返回 value 值的 HashCode，如果值为 null 则返回 0
orElseThrow() : Java 10 新增的方法，如果值为 null 抛出 ` NoSuchElementException(“No value present”)` 异常（难道官方发现大家都抛出类似的信息，为了方便所以直接加了一个这样的方法？？）

4、`value` 判断方法

isPresent() : 判断 value != null 则返回 true
equals() : 判断两个Optional对象的值是否相等
isEmpty() : Java 11 添加的方法，用于判断 Value 是否为 null

疑问

1、为什么要有 `Optional.empty()` 返回一个空 Optional 对象??

看到很多示例对 Optional.empty() 的解释都是一笔带过，因为理论上我们应该不需要主动的获取一个空对象呀…很纳闷为啥要有这么一个空对象呢？什么场景会用到呢？

Optional.empty() 生成一个没有包含任何值的 Optional 对象，当期望某个方法可能不会返回结果时，你可以返回 Optional.empty()，而不是返回 null。这样的话，调用者可以使用 Optional 的方法（如 isPresent() 或 ifPresent()）来处理可能的空值，而不必进行显式的 null 检查。

例如，考虑一个方法，可能找不到期望的数据并返回 null：

public User findUserByName(String name) {
    // 如果找不到用户，返回 null
}

现在改用 Optional：

public Optional<User> findUserByName(String name) {
    // 如果找不到用户，返回 Optional.empty()
}

对于调用者来说，处理方法如下：

Optional<User> optionalUser = findUserByName("test");
if (optionalUser.isPresent()) {
    User user = optionalUser.get();
    // 执行其他操作
} else {
    // 用户不存在的情况下的处理
}

但是这种方法和直接使用 if( user != null) {} else {} 没有什么区别呀…

但如果配上 ifPresent() 更简洁的方式：

findUserByName("test").ifPresent(user -> {
    // 执行其他操作
});

似乎稍微有一些看头，让代码段可以更加集中于“逻辑的提现”，而避免了很多面条式的 if-else 堆积。

但上面的代码，else 的逻辑会丢失。因此在 Java 9 中新增了 ifPresentOrElse() 方法：

findUserByName("test").ifPresentOrElse(
    user -> {
        // 执行存在用户时的操作
    },
    () -> {
        // 执行用户不存在时的操作，else 的逻辑
    }
);

2、`map()` 和 `flatMap()` 的区别？

由于刚开始接触 Java，对泛型了解不多，因此被我忽略的点在于：map(Function<? super T, ? extends U> mapper) 和 flatMap(Function<? super T, Optional> mapper) 的参数 mapper 的类型。

两个函数的源码如下：

public<U> Optional<U> map(Function<? super T, ? extends U> mapper) {
    Objects.requireNonNull(mapper);
    if (!isPresent())
        return empty();
    else {
        // 此处对 mapper.apply(value) 的结果再次进行了 Optional.ofNullable 的包装
        return Optional.ofNullable(mapper.apply(value));
    }
}

public<U> Optional<U> flatMap(Function<? super T, Optional<U>> mapper) {
    Objects.requireNonNull(mapper);
    if (!isPresent())
        return empty();
    else {
        // 直接返回了 mapper.apply(value) 的结果，只要结果不是 null 即可，否则会抛 NPE
        return Objects.requireNonNull(mapper.apply(value));
    }
}

Function<? super T, ? extends U> mapper 表示 mapper 对象必须处理 T 类型，但接口是返回 U 类型
Function<? super T, Optional mapper 表示 mapper 对象必须处理 T 类型，但接口是返回 Optional 类型
map() 和 flatMap() 都是要接收一个「实现了 Fuction 函数式接口的对象」的形参

依然通过 CarDetail 写一个 Demo：

package optional;
import java.util.Optional;
public class DemoOptional {
    public static void main(String[] args) {
        CarDetail carDetail = null;
        String regionEn = Optional.ofNullable(carDetail)
            .flatMap(CarDetail::getLocation) // 此处用的是：flatMap()，`CarDetail.location` 是 `Optional<T>`
            // .map(x -> x.orElse(new Location()).getPickup()) // 如果 flatMap() 想用 map() 代替
            .map(Location::getPickup) // 此处用的是：`map()`，`Location.pickup` 是一个 `Region` 实体
            .map(Region::getRegionEn)
            .orElse("else");
        System.out.println(regionEn);
    }

    public static class CarDetail {
        private Optional<Location> location;
        public Optional<Location> getLocation() {return location;}
        public CarDetail setLocation(Location location) {this.location = Optional.ofNullable(location); return this;}
    }

    public static class Location {
        private Region pickup;
        public Region getPickup() {return pickup;}
        public Location setPickup(Region pickup) {this.pickup = pickup;return this;}
    }

    public static class Region {
        private String regionEn;
        Region(String regionEn) {this.regionEn = regionEn;}
        public String getRegionEn() {return regionEn;}
    }
}

Optional.ofNullable(carDetail) 得到了一个 Optional<CarDetail> 的对象
由于 CarDetail.location 本身已经是一个 Optional<Location> 对象
因此 Optional.ofNullable(carDetail).map(CarDetail::getLocation) 得到的将是一个 Optional.ofNullable(CarDetail::getLocation) 的对象
而 Optional.ofNullable(carDetail).flapMap(CarDetail::getLocation) 得到的将是一个 CarDetail::getLocation 对象

Java 是希望对开发者屏蔽「指针」这个复杂概念的，但是偏偏返回了 null…这是一个「空指针」，因此出现 Optional 类希望能用 Optional.empty() 来屏蔽返回真正 null 的情况。

所以当我们选择 map() or flipMap() 的时候，即：面临 「“对象”嵌套“对象”」 情况下的要看 内部嵌套的这个对象是一个 Optional<T> 还是一个其他的实体对象？

是时候清理你的 Git 分支了”

Wed, 05 Apr 2023 00:00:00 +0000

背景

历史原因，拆分了 20 几个仓库出来，仓库太多而人员太少，没有人维护项目分支的管理
Git 分支的成本太廉价，创建且不删除的代价很小
Windows 上的 GUI 工具太给力，轻易就能搜索对应的分支，但在 Linux 下 Git GUI Tools 没什么很好的工具
开发人员没有良好的习惯，自己创建的分支经常不删除、经常在过期的迭代分支调试代码…

长期下来，导致分支泛滥，最严重的一个历史项目居然积压了 256 个无效分支。目前后端团队就 10 来人，因此 95% 的分支估计都是没什么用的！

很多已经合并到了 origin/master 没有删除，很多虽然没有合并到 origin/master 但最后一次提交都要追溯到 2019-2022 年期间去了。

期望

写一个脚本完成以下目标：

自动拉取最新稳定项目的主干分支（master）
清除本地已经丢失了的远程追踪的分支及其远程追踪记录
提醒对应的开发人员及时清理已经合并到了 origin/master 的远程分支
提醒对应的开发人员及时清理已经远远落后 origin/master 的远程分支

解决方案

清明假期间写了一个脚本，自动清理 1100+ 个分支。

很久没发文，保号发一篇，脚本如下：

#!/bin/bash
#title       : git-branch-alert
#description : Git 已合并/过期分支清理提醒脚本
#author      : limingshuang
#date        : 2023/04/05
#version     : 1.0.1
#change-list : 2023-04-05 v1.0.0 发布脚本
#change-list : 2023-05-25 v1.0.1 修复不同目录 log 文件会被覆盖问题
#===============================================

# 定义项目目录
project_path='/mnt/d/htdocs'
if [ $1 ];then
    project_path=$1
fi
# 定义默认检查最深目录层级
level=4
if [ $2 ];then
    level=$2
fi
# 定义过期分支时间参数，默认：非当前年的分支都视为过期分支
timeReg=$(date +%Y);
if [ $3 ];then
    timeReg=$3
fi

# 定义 log 输出文件
log='/tmp/project-branch-alert-log_'$(date +%Y%m%d)'.log'
if [ ! -a $log ]; then
    touch $log
    echo -e "创建 $log\n"
fi
cat /dev/null > $log

# 定义主干远程分支, 一般都为 master，Github 现在为了避嫌改为了 main
master='master'

# 定义通用 Git命令
specialBranch="|feature-k8s-supplier-api|feature-$(date +'%Y')"
keepBranch='dev|master|main|HEAD|->'
keepBranch+=$specialBranch
# 自动拉取当前分支
fb='git pull $(git remote) $(git symbolic-ref --short -q HEAD)'
# 检查远程分支列表中，有哪些远程分支是没有合并到当前所指向的远程分支的
cm='git branch -r --format="%(refname:short) %(authorname) (%(committerdate:short))" --merged $(git remote)/$(git symbolic-ref --short -q HEAD) | grep -vE "$keepBranch"'
# 检查过期分支命令定义
cv='git for-each-ref refs/remotes/ --format="%(refname:short) %(authorname) (%(committerdate:short))" | grep -Ev "$keepBranch|$timeReg"'

function action()
{
    echo -e "\n更新：$1"
    # reset 当前工作域自动 fetch 远程信息
    # 清理掉 .git/refs/remotes/origin/HEAD 分支文件
    # `origin/HEAD` 并不是一个真正的分支，而是指向远程仓库中默认分支的引用，它通常指向 `origin/master` 或 `origin/main`，具体取决于你的远程仓库的默认分支名称
    # `git remote set-head -d origin` 可以删除本地仓库中的 origin/HEAD 分支
    cd $1 && git reset --hard HEAD && git fetch -pa $(git remote) && git worktree prune && git remote set-head -d $(git remote)

    # fix：处理 github 仓库将 master 改为 main，导致上游分支丢失问题
    # 自动将本地 master 切换为 main 分支
    if [[ `git symbolic-ref --short -q HEAD` = 'master' && `git branch -r | grep origin/main | wc -l` != 0 ]];then
        master='main'
    elif [[  `git symbolic-ref --short -q HEAD` != 'master' && `git branch -r | grep origin/master | wc -l` != 0 ]];then
        master='master'
    fi

    # 先更新当前分支，然后切到主分支, 更新主干分支
    eval $fb
    if [[ `git symbolic-ref --short -q HEAD` != $master ]];then
        git switch $master && eval $fb
    fi

    # 清理本地已经丢失了远程分支的分支
    git branch -v | grep -F [gone] | awk '{print $1}' | xargs -I {} bash -c "if [ ! -z {} ];then git branch -D {};fi"

    # 检查没有合并到当前分支所在远程分支
    local cmLog=''
    cmLog=$(eval $cm)
    if [ ! -z "$cmLog" ];then
        echo -e "\n已经合并到 - "$(git remote)/$(git symbolic-ref --short -q HEAD)"分支($1# " $(git remote get-url --push $(git remote))")，请及时清理：\n$cmLog" >> $log
    fi

    # 检查过期分支
    local cvLog=''
    cvLog=$(eval $cv)
    if [ ! -z "$cvLog" ];then
        echo -e "\n过期分支 - "$(git remote)/$(git symbolic-ref --short -q HEAD)"($1# " $(git remote get-url --push $(git remote))")，请相关人员检查并清理：\n$cvLog" >> $log
    fi

    # 如果存在子模块，则同步更新子模块
    if [ -f "$1/.gitmodules" ];then
        git submodule update --init --remote --recursive && git submodule foreach 'echo "清理 $sm_path" && git fetch -pa $(git remote)'
    fi
}

function listDir()
{
    local project_path=$1;
    # 如果传入目录已经是一个 Git 项目直接执行更新退出
    if [ -d "$project_path/.git" ];then
        action $project_path
        if [ $(echo $project_path | grep "/library" | wc -l) -eq 1 ] && [ -d "$project_path/erc-model" ]; then
             action $project_path/erc-model
        fi
        return
    fi
    # 如果不是 Git 目录
    for dir in `ls -l $project_path/ | grep -E "^d" | awk '{print $NF}' | grep -v "vendor"`;
    do
        local l=$2
        # 判断目录层级
        if [ $l -le $level ] && ((l+=1));then
            listDir $project_path/$dir $l
        fi
    done
}

listDir $project_path 1

# 企业微信告警
text=$(cat $log)
if [ ! -z "$text" ];then
    curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxx' -H 'Content-Type: application/json' -d '{"msgtype": "text","text":{"content":"'"$text"'"}}'
fi

将脚本拷贝到 /usr/local/bin 下，创建脚本名为：git-branch-alert，使用 git-branch-alert <dir-path> <dir-level> <fileter>

<第1个参数：dir-path> ：指定检查目录，不想每次都输入可以修改一下脚本的 project_path 默认值
<第2个参数：dir-level> ：指定检查目录层级，这个根据自己项目部署情况修改，默认值是 4 层，本来想放开限制，但是…有个项目真尼玛太人才，子目录太多了
<第3个参数：filter> ：默认过滤 HEAD|dev|master|main|->|(当前年份-2023)，如果想保留其它年份和规则可以传递参数

！！！注意：使用这个脚本之前记得先提交你项目目录的记录，因为脚本中的 git reset --hard HEAD 会清掉你当前工作区的信息。

Change List

2023-05-25 - `origin/HEAD` 分支引发的告警异常

上述脚本正常的告警格式应该如下：

已经合并到 - origin/master分支([email protected]:xx/xx.git)，请及时清理：
origin/branch-name author (YYYY-mm-dd)

但在公司电脑执行检查一个新目录时，突然发现了很多项目都存在一个异常的告警信息：branche-name 丢失

已经合并到 - origin/master分支([email protected]:xx/xx.git)，请及时清理：
origin author (YYYY-mm-dd)

服务器上检查没有问题，家里的电脑运行检查脚本也没有问题…git branch -r 对比了一下，发现了异常项目都多了一个 origin/HEAD 分支在结果列表中

git branch -r 其实就是将 .git/refs/remote/origin/* 文件全部列出来，通过 ls 查看目录发现确实是多了这么一个 HEAD 文件。

ChatGPT 问了一下：

origin/HEAD 是在你执行 git clone 一个仓库时自动创建的一个引用，它指向你从中克隆的远程仓库的默认分支（通常是master或者main分支）
origin/HEAD 并不是一个真正的分支，而是指向远程仓库中默认分支的引用，它通常指向 origin/master 或 origin/main，具体取决于你的远程仓库的默认分支名称
git remote set-head -d origin 命令可以删除本地仓库中的 origin/HEAD 分支，且该命令只影响本地视图

多次尝试想在执行 git branch -r --fromat="xxxx" 的时候屏蔽掉 origin/HEAD 分支，尝试无果且实现方案感觉成本较大。删除 origin/HEAD 并未发现执行有什么异常。因此直接在检查前执行 git remote set-head -d $(git remote) 删除 HEAD 分支。

重学编程-PHP”

Sat, 26 Nov 2022 00:00:00 +0000

[TOC]

WSL2 Debian 编译安装 PHP 8.1.13(LNMP)

安装 PHP

前置准备

sudo apt update
sudo apt upgrade

安装依赖

sudo apt-get install -y \
 autoconf build-essential curl libtool \
 libssl-dev libcurl4-openssl-dev libsqlite3-dev \
 libxml2-dev libreadline8 libreadline-dev \
 libzip-dev libonig-dev libzip4 openssl \
 pkg-config zlib1g-dev libpng-dev libjpeg-dev \
 libfreetype-dev libsodium-dev libgmp-dev 

新增用户

sudo groupadd -g 500 www # 创建 www 用户组，指定用户组的 groupId 为 500
sudo useradd -u 500 -r -g www -d /home/www www # 创建 www 用户，Id 为 500
passwd www # 设置 www 密码

下载安装 PHP8.1.13

sudo mkdir -p /apps/php81 /data/logs/php
cd /apps
wget https://www.php.net/distributions/php-8.1.13.tar.gz
tar -xf php-8.1.13.tar.gz && rm -f php-8.1.13.tar.gz

编译安装 PHP8.1.13，可以通过 ./configure -h 查看支持的编译参数

configure 这些选项只用在编译的时候。如果想要修改 PHP 的运行时配置，请阅读运行时配置

$ cd /apps/php-8.1.13
$ ./configure --prefix=/apps/php81 \
    --with-config-file-path=/apps/php81/etc \
    --with-fpm-user=www \
    --with-fpm-group=www \
    --with-freetype=/usr \
    --with-jpeg=/usr \
    --with-libzip=/usr/lib/x86_64-linux-gnu \
    --with-curl \
    --with-openssl \
    --with-pdo-mysql \
    --with-mysqli \
    --with-pdo-mysql=mysqlnd \
    --with-gmp \
    --with-zlib \
    --with-pear \
    --with-readline \
    --with-sodium \
    --with-zip \
    --enable-mysqlnd \
    --enable-gd \
    --enable-iconv \
    --enable-bcmath \
    --enable-fpm \
    --enable-mbstring \
    --enable-opcache \
    --enable-mbstring \
    --enable-phpdbg \
    --enable-shmop \
    --enable-sockets \
    --enable-soap \
    --enable-sysvmsg \
    --enable-sysvsem \
    --enable-sysvshm \
    --enable-zip \
    --enable-pcntl 

$ make -j # 查看编译结果
$ make && make install

配置信息

cp /apps/php-8.1.13/php.ini-* /apps/php81/etc/
cd /apps/php81/etc
cp php.ini-development php.ini
cp php-fpm.conf.default php-fpm.conf
cp php-fpm.d/www.conf.default www.conf
touch php-fpm.d/env.conf

php.ini 配置信息，见 php.ini核心配置选项说明

php-fpm.conf 全局配置

[global]
pid = run/php-fpm.pid
error_log = /data/logs/php/php-fpm.log
syslog.facility = daemon
syslog.ident = php-fpm
log_level = notice
process.priority = -19
daemonize = yes
events.mechanism = epoll

include=/apps/php81/etc/php-fpm.d/*.conf

php-fpm.d/www.conf 配置 web 配置

[www]
user = www
group = www
listen = /dev/shm/php8-1-13-fcgi.sock
listen.owner = www
listen.group = www

pm = static
pm.max_children = 5
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 2
pm.max_requests = 500
pm.status_path = /status_php_81

slowlog = /data/logs/php/$pool.log.slow
request_slowlog_timeout = 5

rlimit_files = 1024

catch_workers_output = yes

php-fpm.d/env.conf 配置环境变量

[www]
env[CURRENT_ENV] = test
env[IS_NEW_TEST_ENV] = 1

;env[MYSQL_HOST] = xxx
;env[MYSQL_USERNAME]= xxx
;env[MYSQL_PASSWORD]= xxx

设置软连

sudo ln -s /apps/php81/bin/php /usr/local/bin/php

扩展安装
- 获取或者 Browse Packages ： https://pecl.php.net/packages.php
- 在 php.ini 中开启扩展 extension=memcache
- 配置：可以查看 PHP: 其它服务 - Manual

# 安装 memcache
wget http://pecl.php.net/get/memcache && tar -zxvf memcache && cd memcache-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 memcached
sudo apt install -y libmemcached-dev
wget https://pecl.php.net/get/memcached && tar -zxvf memcached && cd memcached-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 Gearman
sudo apt install -y libgearman-dev
wget https://pecl.php.net/get/gearman && tar -zxvf gearman && cd gearman-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 amqp 扩展
sudo apt install -y librabbitmq-dev
wget https://pecl.php.net/get/amqp && tar -zxvf amqp && cd amqp-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 redis 扩展
wget https://pecl.php.net/get/redis && tar -zxvf redis && cd redis-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 mongodb 扩展
wget https://pecl.php.net/get/mongodb && tar -zxvf mongodb && cd mongodb-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 mcrypt 扩展
sudo apt install -y libmcrypt-dev
wget https://pecl.php.net/get/mcrypt && tar -zxvf mcrypt && cd mcrypt-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 timezonedb 扩展
wget https://pecl.php.net/get/timezonedb && tar -zxvf timezonedb && cd timezonedb-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 swoole 扩展
sudo apt install -y librabbitmq-dev
wget https://pecl.php.net/get/swoole && tar -zxvf swoole && cd swoole-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

# 安装 gRPC 扩展
sudo apt install -y librabbitmq-dev
wget https://pecl.php.net/get/gRPC && tar -zxvf gRPC && cd grpc-* && /apps/php81/bin/phpize
./configure --with-php-config=/apps/php81/bin/php-config
make && make install

安装包管理器 composer

php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"

sudo ln -s /apps/php-composer/composer.phar /usr/local/bin/composer

NGINX

安装依赖

mkdir -p /apps/nginx /data/logs/nginx && cd /apps
sudo apt install -y build-essential libpcre3 libpcre3-dev zlib1g-dev openssl libssl-dev libxml2-dev libxslt1-dev

下载源码：nginx documentation

wget https://nginx.org/download/nginx-1.22.1.tar.gz && tar -zxvf nginx-1.22.1.tar.gz && rm nginx-1.22.1.tar.gz

wget https://github.com/wandenberg/nginx-push-stream-module/archive/refs/tags/0.5.5.tar.gz && tar -zxvf nginx-push-stream-module-0.5.5.tar.gz && rm nginx-push-stream-module-0.5.5.tar.gz

配置&&编译，配置参数可以参考 Nginx 官方 configure 说明，也可以通过 ./configure --help 查看说明（[Nginx模块-HTTP Push Stream NGINX](https://www.nginx.com/resources/wiki/modules/push_stream/))）

cd nginx-1.22*/
./configure \
--prefix=/apps/nginx1.22 \
--sbin-path=/apps/nginx1.22/sbin/nginx \
--pid-path=/apps/nginx1.22/nginx.pid \
--lock-path=/apps/nginx1.22/nginx.lock \
--conf-path=/apps/nginx1.22/conf/nginx.conf \
--error-log-path=/data/logs/nginx/error.log \
--user=www \
--group=www \
--with-file-aio \
--with-threads \
--with-http_addition_module \
--with-http_auth_request_module \
--with-http_dav_module \
--with-http_flv_module \
--with-http_gunzip_module \
--with-http_gzip_static_module \
--with-http_mp4_module \
--with-http_random_index_module \
--with-http_realip_module \
--with-http_secure_link_module \
--with-http_slice_module \
--with-http_ssl_module \
--with-http_stub_status_module \
--with-http_sub_module \
--with-http_v2_module \
--with-mail \
--with-mail_ssl_module \
--with-stream \
--with-stream_realip_module \
--with-stream_ssl_module \
--with-stream_ssl_preread_module \
--add-module=/apps/nginx-push-stream-module-0.5.5

make && make install

启动 nginx ： /apps/nginx1.22/sbin/nginx
停止 nginx ： /apps/nginx1.22/sbin/nginx -s quit
重启 nginx ： /apps/nginx1.22/sbin/nginx -s reload
重启日志： /apps/nginx1.22/sbin/nginx -s reopen

reload 重新检查加载配置文件（若配置文件错误则继续保持当前配置正常运行），采用滚动发布方式，Nginx 会使用新配置启动新的工作主进程，并向旧的工作进程发送关闭信号。当旧进程收到关闭信号后，它将会停止接受新的请求，并在处理完旧请求的自行退出；

reopen 滚动日志，当Nginx的日志文件过大，我们将日志文件 mv 到其他位置后会发现日志文件仍在写入，这是由于mv后的文件 inode 相关信息不变，因此 Nginx 还会将日志写入到该文件中。这时我们就可以执行 reopen 操作，Nginx 就会关闭原来的句柄，在配置的日志目录下重新创建新的日志文件来进行日志记录。inode 相当于一个文件的身份证号，文件路径只是相当于一个住址而已。

查看 Nginx 进程： ps -ef grep nginx 或 ps -ax grep nginx
Nginx系列之nginx信号控制 (aiopsclub.com)

将 Nginx 注册为 System 服务（通过 systemd 服务用 systemctl 管理，通过放在：/lib/systemd/system/nginx.service或/etc/systemd/system/nginx.service）

ExecStart=
ExecReload=/apps/nginx1.22/sbin/nginx -s reload
ExecStop=/apps/nginx1.22/sbin/nginx -s quit
ps
/apps/nginx1.22/sbin/nginx -V # 查看编译参数

sudo vi /lib/systemd/system/nginx.service  #写入如下内容
[Unit]
Description=nginx - high performance web server
Documentation=http://nginx.org/en/docs/
After=network-online.target remote-fs.target nss-lookup.target
Wants=network-online.target
[Service]
Type=forking
PIDFile=/usr/local/nginx/logs/nginx.pid
ExecStart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
ExecReload=/bin/sh -c "/bin/kill -s HUP $(/bin/cat /usr/local/nginx/logs/nginx.pid)"
ExecStop=/bin/sh -c "/bin/kill -s TERM $(/bin/cat /usr/local/nginx/logs/nginx.pid)"
[Install]
WantedBy=multi-user.target

注册后需要 systemctl daemon-reload 重新加载服务，然后就可以通过 systemctl start|stop|reload nginx

如果想通过 service 进行管理 nginx 服务（通过 init.d 用 service 管理，在 /etc/init.d/nginx）

# Download nginx startup script
wget -O init-deb.sh https://www.linode.com/docs/assets/660-init-deb.sh

# Move the script to the init.d directory & make executable
sudo mv init-deb.sh /etc/init.d/nginx
sudo chmod +x /etc/init.d/nginx

# Add nginx to the system startup
sudo /usr/sbin/update-rc.d -f nginx defaults

# service nginx start
# service nginx stop
# service nginx reload
# 不支持 status 

可参考 docker 的脚本自行实现

❯ cat /etc/init.d/docker
#!/bin/sh
set -e

### BEGIN INIT INFO
# Provides:           docker
# Required-Start:     $syslog $remote_fs
# Required-Stop:      $syslog $remote_fs
# Should-Start:       cgroupfs-mount cgroup-lite
# Should-Stop:        cgroupfs-mount cgroup-lite
# Default-Start:      2 3 4 5
# Default-Stop:       0 1 6
# Short-Description:  Create lightweight, portable, self-sufficient containers.
# Description:
#  Docker is an open-source project to easily create lightweight, portable,
#  self-sufficient containers from any application. The same container that a
#  developer builds and tests on a laptop can run at scale, in production, on
#  VMs, bare metal, OpenStack clusters, public clouds and more.
### END INIT INFO

export PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin

BASE=docker

# modify these in /etc/default/$BASE (/etc/default/docker)
DOCKERD=/usr/bin/dockerd
# This is the pid file managed by docker itself
DOCKER_PIDFILE=/var/run/$BASE.pid
# This is the pid file created/managed by start-stop-daemon
DOCKER_SSD_PIDFILE=/var/run/$BASE-ssd.pid
DOCKER_LOGFILE=/var/log/$BASE.log
DOCKER_OPTS=
DOCKER_DESC="Docker"

# Get lsb functions
. /lib/lsb/init-functions

if [ -f /etc/default/$BASE ]; then
        . /etc/default/$BASE
fi

# Check docker is present
if [ ! -x $DOCKERD ]; then
        log_failure_msg "$DOCKERD not present or not executable"
        exit 1
fi

check_init() {
        # see also init_is_upstart in /lib/lsb/init-functions (which isn't available in Ubuntu 12.04, or we'd use it directly)
        if [ -x /sbin/initctl ] && /sbin/initctl version 2>/dev/null | grep -q upstart; then
                log_failure_msg "$DOCKER_DESC is managed via upstart, try using service $BASE $1"
                exit 1
        fi
}

fail_unless_root() {
        if [ "$(id -u)" != '0' ]; then
                log_failure_msg "$DOCKER_DESC must be run as root"
                exit 1
        fi
}

cgroupfs_mount() {
        # see also https://github.com/tianon/cgroupfs-mount/blob/master/cgroupfs-mount
        if grep -v '^#' /etc/fstab | grep -q cgroup \
                || [ ! -e /proc/cgroups ] \
                || [ ! -d /sys/fs/cgroup ]; then
                return
        fi
        if ! mountpoint -q /sys/fs/cgroup; then
                mount -t tmpfs -o uid=0,gid=0,mode=0755 cgroup /sys/fs/cgroup
        fi
        (
                cd /sys/fs/cgroup
                for sys in $(awk '!/^#/ { if ($4 == 1) print $1 }' /proc/cgroups); do
                        mkdir -p $sys
                        if ! mountpoint -q $sys; then
                                if ! mount -n -t cgroup -o $sys cgroup $sys; then
                                        rmdir $sys || true
                                fi
                        fi
                done
        )
}

case "$1" in
        start)
                check_init

                fail_unless_root

                cgroupfs_mount

                touch "$DOCKER_LOGFILE"
                chgrp docker "$DOCKER_LOGFILE"

                ulimit -n 1048576

                # Having non-zero limits causes performance problems due to accounting overhead
                # in the kernel. We recommend using cgroups to do container-local accounting.
                if [ "$BASH" ]; then
                        ulimit -u unlimited
                else
                        ulimit -p unlimited
                fi

                log_begin_msg "Starting $DOCKER_DESC: $BASE"
                start-stop-daemon --start --background \
                        --no-close \
                        --exec "$DOCKERD" \
                        --pidfile "$DOCKER_SSD_PIDFILE" \
                        --make-pidfile \
                        -- \
                                -p "$DOCKER_PIDFILE" \
                                $DOCKER_OPTS \
                                        >> "$DOCKER_LOGFILE" 2>&1
                log_end_msg $?
                ;;

        stop)
                check_init
                fail_unless_root
                if [ -f "$DOCKER_SSD_PIDFILE" ]; then
                        log_begin_msg "Stopping $DOCKER_DESC: $BASE"
                        start-stop-daemon --stop --pidfile "$DOCKER_SSD_PIDFILE" --retry 10
                        log_end_msg $?
                else
                        log_warning_msg "Docker already stopped - file $DOCKER_SSD_PIDFILE not found."
                fi
                ;;

        restart)
                check_init
                fail_unless_root
                docker_pid=`cat "$DOCKER_SSD_PIDFILE" 2>/dev/null`
                [ -n "$docker_pid" ] \
                        && ps -p $docker_pid > /dev/null 2>&1 \
                        && $0 stop
                $0 start
                ;;

        force-reload)
                check_init
                fail_unless_root
                $0 restart
                ;;

        status)
                check_init
                status_of_proc -p "$DOCKER_SSD_PIDFILE" "$DOCKERD" "$DOCKER_DESC"
                ;;

        *)
                echo "Usage: service docker {start|stop|restart|status}"
                exit 1
                ;;
esac

推荐阅读：Nginx配置文件的结构和最佳做法

根据上述文章，我的配置文件结构如下：

Nginx配置文件存储在 /apps/nginx1.22/conf/nginx.conf

虚拟主机配置：[如何在Debian 10配置Nginx虚拟主机

myfreax](https://www.myfreax.com/how-to-set-up-nginx-server-blocks-on-debian-10/)

虚拟主机配置文件统一存储在 conf/sites-available/*.conf
将 conf/sites-available 链接到 conf/sites-enabled目录时，启用配置
命名规范：域名.conf

日志统一存放路径：/data/logs/nginx/*.log（access.log 分域名存储不同的 log 文件中）

[如何使用mkcert创建SSL证书

myfreax](https://www.myfreax.com/how-to-create-locally-trusted-ssl-certificates-on-linux-and-macos-with-mkcert/)

Nginx——访问日志、错误日志、日志文件切割
Nginx Shell 部署文档

user www www;
worker_processes  auto;
worker_rlimit_nofile 51200;
error_log  /data/logs/nginx/nginx_error.log error; # error_log 错误等级：debug info notice error

pid        /apps/nginx1.22/nginx.pid;

events {
    use epoll;
    multi_accept on;
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    log_format    main    '$remote_addr - $remote_user [$time_local] "$host" "$request" '
                          '$status $body_bytes_sent "$http_referer" '
                          '"$http_user_agent" "$http_x_forwarded_for" '
                          'responsetime=$request_time';

    log_format    access    '$request_time|$remote_addr|$remote_user|$host|[$time_local]|$request|'
                            '$status|$body_bytes_sent|$http_referer|$http_x_forwarded_for|'
                            '$upstream_addr|$upstream_status|$upstream_response_time|'
                            '"$http_user_agent"|$request_body|$scheme';

    log_format    access-debug    '$request_time|$remote_addr|$remote_user|$host|[$time_local]|$request|'
                                  '$status|$body_bytes_sent|$http_referer|$http_x_forwarded_for|'
                                  '$upstream_addr|$upstream_status|$upstream_response_time|'
                                  '"$http_user_agent"|$request_body|$scheme|$http_if_modified_since';

    # access_log /data/logs/nginx/nginx_access_log.log;
    sendfile       on;
    tcp_nopush     on;
    tcp_nodelay    on;
    keepalive_timeout  10;

    gzip  on;
    gzip_static  on;
    gzip_proxied any;
    gzip_min_length 1k;
    gzip_buffers    4 16k;
    gzip_http_version 1.0;
    gzip_comp_level 2;
    gzip_types  text/plain application/javascript application/x-javascript text/javascript text/css application/xml application/json;
    gzip_vary  on;

    push_stream_shared_memory_size 128M;
    push_stream_max_channel_id_length 200;
    push_stream_max_messages_stored_per_channel 1;
    push_stream_message_ttl 1m;

    include sites-enabled/*.conf;
    add_header hostname $hostname always;
    port_in_redirect off; # 302 重定向时，不自动加上当前URL的端口
    add_header X-Frame-Options DENY; # 站点是否允许用 iframe 嵌套使用（DENY-不允许；SAMEORIGIN-同源允许；ALLOW-FROM <uri> - 指定链接允许）
}

005 Why You Need To Learn Design Patterns

Sat, 24 Sep 2022 00:00:00 +0000

设计模式学习导读

[TOC]

为什么说每个程序员都要尽早地学习并掌握设计模式相关知识？

很多程序员都知道基础知识的重要性，觉得要夯实基础，才能走得更远，但：基础知识有哪些？基础要怎么样才算是“夯实”？如何将基础知识转化成开发“生产力”？
- 基础一般有哪些？框架、语言都是变化的，“不变”的是基础，如：计算机组成原理、操作系统原理、编译原理、网络原理、算法与数据结构、设计模式…
- “夯实”的基础是怎么定义的？用最简单的方式，能快速实现解决问题，并明白其“本质”、“原理”
- 为什么需要学习这些基础？CURD 其实可能用不上，但这些基础其实在潜移默化的影响你的学习速度、提高你对技术的理解、编写程序的质量；其次，功利性的说就是“大厂面试，都注重基础和经验”
为什么学习“设计模式”？如果说前面的基础是让你学会如何写出高效的代码（内功心法），那“设计模式”更像是“屠龙记”（具体的武功招式）教你学会“如何写出高质量的代码”。
烂代码的特征：命名不规范，类设计不合理，分层不清晰，没有模块化，代码混乱，高度耦合，没有抽象，代码行数太长，逻辑结构太复杂，代码参数太多，参数没有做任何封装
如何设计一个通用的模块/架构，该从哪些方面去思考：
- 如何分层、分模块？
- 应该怎么划分类？
- 每个类应该具有哪些属性、方法？
- 怎么设计类之间的交互？该用继承还是组合？该使用接口还是抽象类？
- 怎样做到解耦、高内聚低耦合？
- 该用单例模式还是静态方法？
- 用工厂模式创建对象还是直接 new 出来？
- 如何避免引入设计模式提高扩展性的同时带来的降低可读性问题？……
关于看源码的一些思考和观点
1. 看源码是为了看什么？优秀的开源项目、框架、中间件，代码量、类的个数都会比较多，类结构、类之间的关系极其复杂，常常调用来调用去。所以，为了保证代码的扩展性、灵活性、可维护性等，代码中会使用到很多设计模式、设计原则或者设计思想。我们可以从这些优秀的源码中去学习别人的编写规范、设计原则、设计思想、实现方案技巧等信息
2. 看源码遇到的两类问题：
  - 看不懂、看不下去：有一些人看源码的时候，经常会遇到看不懂、看不下去的问题。实际上，这个问题的原因很简单，那就是你积累的基本功还不够，你的能力还不足以看懂这些代码。不懂这些设计模式、原则、思想，在看代码的时候，你可能就会琢磨不透作者的设计思路，对于一些很明显的设计思路，你可能要花费很多时间才能参悟。事倍功半，持续得不到正反馈，就会让人倦怠。
  - 以为看懂，但不会用：你自己觉得看懂了，实际上，里面的精髓你并没有 get 到多少？这是一个隐藏的问题，自己可能都比较难发现。因为优秀的开源项目、框架、中间件，就像一个集各种高精尖技术在一起的战斗机。如果你想剖析它的原理、学习它的技术，而你没有积累深厚的基本功，就算把这台战斗机摆在你面前，你也不能完全参透它的精髓，只是了解个皮毛，看个热闹而已。
学好设计模式相关的知识，不仅能让你更轻松地读懂开源项目，还能更深入地参透里面的技术精髓，做到事半功倍。
内容中涉及的问题：如何设计一个餐厅系统、停车场系统、售票系统？(作者觉得这题目老套…，然而我却不懂）
- 一套完整的停车场管理系统设计方案 - 知乎 (zhihu.com)
- 12306售票系统设计方案 - fzhovo - 博客园 (cnblogs.com)

02 | 从哪些维度评判代码质量的好坏？如何具备写出高质量代码的能力？

如何评价代码质量的好坏，比如：是否符合编程规范？可读性是否强？是否易扩展？是否易维护？是否足够简单？但…什么才算是可读性好、易扩展、易维护、足够简单的“标准”

可维护性：一个项目的维护时间远远大于编写代码的时间，因此代码的可维护性格外重要。可维护性就是指：在不破坏原有代码设计、不引入新的bug的情况下，能够快速地修改或者添加代码。（事实上，当代码的可读性好、简洁、可扩展性好，就会使得代码的维护性更简单。即：代码分层清晰、模块化好、高内聚低耦合、基于接口而非实现编程的设计原则；易维护性与项目代码量、业务复杂度、技术复杂度、文档全面、开发水平等因素有关）
可读性：软件设计大师 Martin Fowler 曾经说过：“Any fool can write code that a computer can understand. Good programmers write code that humans can understand.”翻译成中文就是：“任何傻瓜都会编写计算机能理解的代码。好的程序员能够编写人能够理解的代码”。个人认为可读性应该是最重要的，如果连让人读明白都不行，谈什么可维护？代码是否符合编码规范、命名是否达意、注释是否详尽、函数是否长短合适、模块划分是否清晰、是否符合高内聚低耦合。
可扩展性：代码预留了一些功能扩展点，支持新加功能、用户自定义时能直接最小改动。开闭原则（OCP）：“对修改关闭，对扩展开放”。“对修改关闭”是为了保证现有代码的稳定性，“对扩展开放”开放是为了应对变化
简洁性：KISS原则-“Keep It Simple，Keep It Stupid”，让代码保持简单、逻辑清晰，自然就意味着“可读性高、易维护”
可复用性：DRY原则-“Don’t Repeat Yourself”，尽量减少重复代码的编写，复用已有的代码。要么一起错，更容易暴露问题，要么一起对没有问题。
- 面向对象中“继承、多态”存在的目的之一就是为了提高可复用性
- “单一职责”的设计原则
- 重构技巧：解耦(低耦合)、高内聚、模块化
可测试性：代码的可测试性差，比较难写单元测试，那基本上就能说明代码设计得有问题。可测试性对于代码重构时非常的重要

==思从深而行从简，真正的高手能云淡风轻地用最简单的方法解决最复杂的问题。==

03 | 面向对象、设计原则、设计模式、编程规范、重构，这五者有何关系？

面向对象：是一种设计思想和开发方法，其核心就是“关注各个构件，提高构件的独立性，通过将其组合起来实现系统整体功能”。即：将系统抽象设计为众多的“独立性较高”的对象，对象包含不同的方法、属性。面向对象分析（OOA）、面向对象设计（OOD）、面向对象编程（OOP）
- 面向对象编程（OOP）：将程序定义为一个个独立性不同的类，通过类创建实例对象，实例对象之间的相互作用，构成实现了软件的功能（即：类是模板，实例对象是实际工作的人）。面向对象的四大特效：抽象、封装、继承、多态
- 面向对象的四大特性：封装、抽象、继承、多态
- 面向对象编程与面向过程编程的区别和联系
- 面向对象分析、面向对象设计、面向对象编程
- 接口和抽象类的区别以及各自的应用场景
- 基于接口而非实现编程的设计思想
- 多用组合少用继承的设计思想
- 面向过程的贫血模型和面向对象的充血模型
设计原则：是指导我们代码设计的一些经验总结
- SOLID 原则 -SRP 单一职责原则
- SOLID 原则 -OCP 开闭原则
- SOLID 原则 -LSP 里式替换原则
- SOLID 原则 -ISP 接口隔离原则
- SOLID 原则 -DIP 依赖倒置原则
- DRY 原则、KISS 原则、YAGNI 原则、LOD 法则
设计模式：设计模式是针对软件开发中经常遇到的一些设计问题，总结出来的一套解决方案或者设计思路。
- ==设计原则是经验总结、是心法口诀==
- ==设计模式是对设计原则的“最佳实践和扩展”==。因此：设计模式并非是一成不变的，随着语言的演进，一些设计模式（如：Singleton）也随之过时甚至是反例模式，本身设计模式在最初也是为了解决某些语言在语法特性上的局限性而诞生的最佳实践方案。
设计模式分类：创建型、结构型、行为型 23种设计模式的UML图
- 创建型：
  - 常用的有：单例模式、工厂模式（工厂方法或抽象工厂）、建造者模式
  - 不常用的：原型模式
- 结构型：
  - 常用的有：代理模式、桥接模式、装饰者模式、适配器模式、门面模式（作者归位不常用，但很多类库都有用，如：ORM框架、写日志框架）
  - 不常用的：组合模式、享元模式
- 行为型：
  - 常用的有：观察者模式、模板模式、策略模式、职责链模式、迭代器模式、状态模式
  - 不常用的：访问者模式、备忘录模式、命令模式、解释器模式、中介模式
编程规范：主要解决的是代码的可读性问题，提供一些细节上的约束从而形成“共识”，减少大家的无效沟通交流。可以看：《重构》、《代码大全》、《代码整洁之道》
代码重构：没有一劳永逸的设计，只有持续迭代变化的需求。随着需求的变化，原有的设计必定存在一些问题，此时针对这些问题就需要对代码进行重构。持续重构是保持代码质量不下降的有效手段，能有效避免代码腐化到无可救药的地步。重构代码之前需要知道：
- 重构的目的（why）、对象（what）、时机（when）、方法（how）
- 保证重构不出错的技术手段：单元测试（TDD）和代码可测试性
- 不同规模的重构：大重构（大规模高层次）和小重构（小规模低层次）。大重构往往是一个漫长而新旧不断交替的痛苦过程，因此可测试性显得格外重要。

“设计原则”提供了心法口诀
设计模式对这些心法口诀进行了具象化，成为了一门门具体的“内功秘籍”
面向对象是修炼这些武功秘籍的“基础、丹药、武器、工具”
编程规范是你练好这些武功的注意事项，避免走火入魔
“重构”是利用上述提到的东西，反复不断的“锤炼”

004 Personal Growth Experience

Fri, 23 Sep 2022 00:00:00 +0000

个人成长经验

[TOC]

什么才是所谓的编程能力？如何考核？如何提升？

所谓编程能力，指的是把“逻辑”（或者说“功能”“业务”）翻译成代码的能力。所谓编程能力强，指的是，不仅能编写正确的代码，而且编写代码的速度很快，写出来的代码 bug 很少、性能很好、质量很高。

更加具体点讲，一个编程能力强的人，能熟练使用编程语言、开发类库等工具，思路清晰，面对复杂的逻辑，能够编写出 bug free 的代码，能够合理地利用数据结构和算法编写高效的代码，能够灵活地使用设计思想、原则和模式，编写易读、易扩展、易维护、可复用的高质量代码。

如何考核

考核一个人的编程能力，主要包含三方面：编程语言、数据结构与算法、设计思想、设计原则和设计模式。

不管从事什么行业，要积累的东西都可以分为“变”与“不变”两类。==“不变”的是内功，“变”的是招式==。我们要善于发现、持续积累那种“不变”的能力，而不是要去盲目追逐一直都在“变”的招式。

编程领域，不变的东西：

技术上：数据结构，操作系统，网络，设计模式，数据库(SQL、NoSQL)、MQ
非技术：产品意识（关注问题本身，而非产品的需求文档）、沟通能力、快速定位发现问题的能力

如何提升

算法与数据结构：刷 LeetCode，不仅仅能加强个人对数据结构和算法的掌握，还能锻炼你的逻辑思维能力，写出 bug free 代码的能力、快速实现复杂逻辑的能力，也能锻炼你的性能意识

设计思想原则和模式：平时工作中“刻意练习思考”

拿到一个需求时：先思考如何设计，再开始写代码。
写代码时：多思考代码是否遵循了经典的设计思想、设计原则。如：是否足够可扩展、是否满足 SOLID 原则、可读性如何、可维护性如何、代码是否有进一步优化的空间？
做 Code Review 时：看到别人的优秀代码我们就去思考一下：有哪些值得借鉴的地方

问题：将 IPv4 地址字符串（仅包含数字、点、空格）转化成 32 位整数（32位的二进制数字）？

基础学科的知识，如何转化程实际的技术生产力？

没有直接用得上并不代表没有用：事实上，“二八法则”适用于任何一门技术。我们能够经常用在工作中的那部分，都只占 20% 左右，近80%都会用不到，但往往这 20% 需要的知识是需要其余的 80% 作为辅助依托的。好比：有一个人想要一个葫芦，于是他就种了一棵葫芦树，葫芦树叶子生了虫子，有人建议他赶紧杀杀虫。这个人却说：”我要的是葫芦，管葫芦叶子干嘛”。
现在用不到并不代表以后用不到：你高数、微积分学的再溜，口算可能依然赶不上市场买菜大妈们，但是换一个工作环境，那你的这些知识能让你在工作上甩几条街。因此：随便培训3-5个月的人，就能掌握框架、工具熟练的进行编程，但是牢固的基础会让你在后面的工作时间中，优势逐渐凸显出来
学了记不住并不代表白学了：学习本身是一种能力锻炼，是让你在遇到问题的时候可以快速检索曾经看过的知识，而不是为了考验你“记忆力”。从：自学能力、理解能力、逻辑思维能力，到：时间控件复杂度分析能力、分析发现解决问题的能力，这些都是学习能给我们带来的锻炼。

比起编程语言、框架、工具，基础学科知识确实很难直接转化成生产力，但它却是你构建整个“技能树”的根本，构建整个“知识大楼”的地基。基础掌握不牢，你对很多应用层技术的理解就会不够有深度，略知皮毛，只能做个技术熟练工。相反，基础扎实能让你学东西更快、更有深度、理解更透彻，也就间接地增强了你的开发能力。可以这么说，在一定程度上，基础知识本身，就是技术生产力。

程序员怎么才能让自己走的更高、更远？

技术方面的竞争壁垒主要来自：==在一个细分技术领域长期、深入的积累==。
业务壁垒：对某个业务有深入的积累。实际上，很多领导之所以能做领导，并非技术能力强，而是对业务熟悉。
技术、业务都没有什么复杂度，能做就是多积累自己
学历、项目、履历毕竟是入场门票，所以要适当学会：“面向简历打工”“面向跳槽打工”，提前做一些职业规划，把自己的履历弄好看点。
不要让职场软技能成为短板：职场不是学校，影响你向上发展的因素很多，肯定不是单靠技术，所以，学生思维要不得。

作为面试官或候选人，如何面试或回答设计模式问题？

能盲写常用的设计模式，要求并不过分，毕竟在开发中，徒手写个单例模式、工厂模式，也是常有的事情
但，学习设计模式的初衷是：提高代码质量。学习设计模式的重点：掌握应用场景、能解决哪些问题，而非纯考验记忆
用真实功能需求来面试：
- 明确需求：考察你的沟通能力、分析能力，是否能通过挖掘、假设、取舍，搞清楚具体的需求，梳理出可以执行落地的需求列表
- 设计与实现：由最简单的设计和实现方案做起，基于最简单方式后可以通过什么设计模式进行优化，对代码进一步解耦，提供代码的可读、扩展性
通过对代码片段进行 Code Review 来考察：考察编程能力、习惯、设计、改进优化。

如何接手一坨烂业务代码？如何在烂业务代码中成长？

要想接手一个业务系统，前提是要读懂代码，而读懂代码的关键，是要熟悉业务。代码只是业务的翻译实现，对照业务看代码是事半功倍。
没文档、没熟悉业务的同事，那么只能硬着头皮读代码，反推业务。将读懂的代码业务进行文档化。
偏底层的开发更加考验程序员在某一细分领域的技术深度，偏业务的开发更加考验程序员的能力，比如沟通能力、分析问题解决问题能力、权衡取舍能力、架构能力等，毕竟业务多种多样，问题千奇百怪，单一细分领域的经验很难应对所有问题。
业务系统的开发难度一般来自两个方面：高性能要求和业务复杂。
1. 解决性能问题，主要依赖：技术广度、技术深度、工作经验。
  
  你需要具备一定的架构能力，有一定的技术广度，需要对各种基础架构、框架、中间件都有所了解。光了解还不够，还要有一定的技术深度，最好能对原理甚至是源码有所研究。
2. 业务复杂性，需要有很强的业务建模能力、复杂逻辑的抽象能力、代码翻译能力等。

003 Code Review

Thu, 22 Sep 2022 00:00:00 +0000

代码审计（Code Review）

[TOC]

聊一聊 Google 是如何做 Code Review 的

腾讯工程师，万字长文说 Code Review
Code Review 的巅峰
Code Review 快把我逼疯了
技术团队如何高效的落地代码CR
[Google官方：How to do a code review eng-practices (google.github.io)](https://google.github.io/eng-practices/review/reviewer/)

为什么国内企业不重视 Code Review？

很多人会认为是：“项目工期紧，没时间做 Code Review”，但是…不忙的时候你做了吗？你一直呆的公司都是这么忙碌吗？之前做过很好的 CR 实践吗？如果让你来做 Code Review 你准备怎么做？

回答不上，那么其实就是不重视，因为缺乏 “技术文化传承”，一个 996 的工程师到了其他的公司，也大概率会带领新团队继续 996 而已。其次就是…要面子，讲究“为人处世”，有问题又不好意思当面指出

Code Review 到底是在考察什么？代码质量、代码规范、代码设计问题。

问题：如果新项目或新需求之初，一次提交几十个文件、几百行代码…怎么落地 code review？

Google 是如何进行 Code Review 的？

每次提交的代码片段叫做一个 CL（Change List），每次提交一段至少含 100 行代码且稍微复杂的 CL 给 CR 评审委员会，但 CL 不能太大，太大容易导致 Review 缓慢，迟迟不能合并代码，最终引发代码合并时冲突…

CL 必须有前因后果描述、上下文背景，让 Review 人员能一眼看懂设计意图，及时当面高效沟通
委员会委派一名资深工程师给你 Review 代码，并提出修改建议，反复进行，直到他觉得没有问题（最终提交的代码是一个可读代码、符合编码规范代码）才会给你颁发一个 Readablity 证书：代码结构是否何来？代码是否容易理解？业务是否正确？异常考虑是否全面？是否有隐藏 bug？代码是否安全？性能是否满足业务需求？是否满足编程规范？

Google 那些让人值得学习快速成长的地方？

完善的培训课程：如新技术分享、对新人友好的入门级101教程、比较有深度的系列教程、G2G计划-公司内部人员录制视频分享给其他的同事（有优质课程提供学习，且不反对员工占用上班时间来学习）==> 问题：如何合理的评估出工作需要的时间？
公开的文档和代码：项目的设计文档、代码及架构设计，除了核心代码基本都内部公开学习

看别人代码是看什么？带着问题去看，参考别人的设计思路、实现技巧方案，从而提高自己的设计和实现能力
清晰的成长路径：公司关注员工的个人成长，希望跟员工共同进步，而不只是将员工代做达成目标的工具。在不同阶段，公司会帮组员制定不同的成长计划
- 新人入职：学习编码规范、单元测试、Code Review、开放工具、行为准则等
- 导师制度：新人入职更多是迷茫不知道自己的工作目标是什么？导师制度可以更好帮新人明确目标，也可以通过导师更好快速的融入公司
- 每隔半年，Leader 会跟你一块制定 OKR，包含你的：工作目标、个人成长部分目标(学习、个人成长方向都可以写)
- Leader 会协助你制定升职计划，如：做什么项目、做哪些有影响力的事情、管理多大的团队等等，也会有意安排一些帮你晋升的事情给你做
- 鼓励内部转岗，鼓励跳出舒适区，换岗到其他的团队，用不熟悉的语言、不熟悉的技术做一些不熟悉的项目

听小争哥对 Google 工程师文化的解读

什么是工程师文化？技术团队的价值观（这个团队最看重什么，比如效率、质量等等），更直白点讲就是做事风格。
为什么想学习 Google 工程师i文化？打造优秀的技术团队-执行力强、工作效率高、创新能力强的优秀团队
作者认为 Google 的这种文化是如何形成的？
- “尖子生”文化，Google 在用人条件苛刻、招聘要求高，过滤出了一批优秀的工程师，而这批优秀的人聚集在一起只需要稍加引导就可以形成优秀的工程师文化，如：高产出、高效率、高创新，至于前方说的“重视代码质量”、“工匠精神”、“重视效率”…自然不在话下
- 招最优秀的人才，给足钱、自由和尊重，这些人必然发挥最大价值
- 控制住招聘人才入口：如乔布斯所说：“A 类工程师招聘 A 类工程师，B 类工程师只能招聘 C 类工程师”
普通公司如何参考呢？
- 招聘一小撮足够优秀的工程师，让这部分工程师影响公司里更多的人，带动起我们想要的工程师文化
- 人才培养上，尽可能留住最符合公司工程师文化的员工，让他们在公司内部有好的职场发展，避免劣币驱逐良币

MinsonLee's Blog

Windows 和 Linux 下如何查看内存条硬件信息

Windows 查看内存条信息

Linux 查看内存条信息

简单的告警闪烁效果

Windows 自带的电池健康检测

SEO：通过 IndexNow 向 Bing 推送站点链接

IndexNow

Bing IndexNow 接入

注意事项

抓取测试结果

Java 中如何告别面条式的 null 判断”

Java 中如何告别面条式的 null 判断

背景

Optional 类源码简读

1、获取 Optional 对象

2、过滤、转换数据的方法

3、获取 Optional 的值

4、value 判断方法

疑问

1、为什么要有 Optional.empty() 返回一个空 Optional 对象??

2、map() 和 flatMap() 的区别？

是时候清理你的 Git 分支了”

背景

期望

解决方案

Change List

2023-05-25 - origin/HEAD 分支引发的告警异常

重学编程-PHP”

WSL2 Debian 编译安装 PHP 8.1.13(LNMP)

安装 PHP

NGINX

005 Why You Need To Learn Design Patterns

设计模式学习导读

为什么说每个程序员都要尽早地学习并掌握设计模式相关知识？

02 | 从哪些维度评判代码质量的好坏？如何具备写出高质量代码的能力？

03 | 面向对象、设计原则、设计模式、编程规范、重构，这五者有何关系？

004 Personal Growth Experience

个人成长经验

什么才是所谓的编程能力？如何考核？如何提升？

如何考核

如何提升

基础学科的知识，如何转化程实际的技术生产力？

程序员怎么才能让自己走的更高、更远？

作为面试官或候选人，如何面试或回答设计模式问题？

如何接手一坨烂业务代码？如何在烂业务代码中成长？

003 Code Review

代码审计（Code Review）

聊一聊 Google 是如何做 Code Review 的

为什么国内企业不重视 Code Review？

Google 是如何进行 Code Review 的？

Google 那些让人值得学习快速成长的地方？

听小争哥对 Google 工程师文化的解读

`Optional` 类源码简读

1、获取 `Optional` 对象

3、获取 `Optional` 的值

4、`value` 判断方法

1、为什么要有 `Optional.empty()` 返回一个空 Optional 对象??

2、`map()` 和 `flatMap()` 的区别？

2023-05-25 - `origin/HEAD` 分支引发的告警异常