技术编程

• 1: Python
• 2: Docker
  • 2.1: Docker 学习笔记
  • 2.2: Docker 常用命令速查
  • 2.3: Docker 重启策略详解
  • 2.4: Docker 远程管理 Portainer
• 3: Git
  • 3.1: Git 常用命令速查
  • 3.2: Git 多仓库身份配置
  • 3.3: Git 清理远端仓库全部提交历史
• 4: 其他
  • 4.1: Linux 常用命令速查
  • 4.2: Markdown 语法速查
  • 4.3: MySQL 常用 SQL 语句速查
  • 4.4: SSH 密钥配置指南
  • 4.5: VSCode 配置机制完整笔记
  • 4.6: MacOS 系统降级流程
  • 4.7: Front Matter 规范
  • 4.8: 修复 Git 提交时间无法显示

1 - Python

这里放 Python 的语法、常用库与踩坑记录，从 UV 管环境到 DataFrame 打印。

2 - Docker

容器相关的东西都在这：概念、常用命令，还有把服务搬进 Docker 的过程。

2.1 - Docker 学习笔记

Docker 核心概念

容器化技术

• Docker 是目前最成熟高效的软件部署技术
• Docker 就是用容器化技术给应用程序封装独立的运行环境
• 每个运行环境就是一个==容器==
• 运行容器的计算机被称为==宿主机==

容器与虚拟机的需求

• 容器：多个容器共用同一个系统内核
• 虚拟机：每个虚拟机都包含操作系统的完整内核
• 优势：Docker 容器比虚拟机更轻、更小，启动速度更快

镜像与容器的关系

• 镜像：镜像是容器的模板，可类比为软件安装包
• 容器：由“软件安装包”安装出来的软件
• 类比：
  • 类比于用模具做糕点，镜像是模具，容器是做出来的糕点
  • 可以使用一个模具（镜像）做出很多个糕点（容器）
  • 也可以将模具（镜像）分享给其他人使用

Docker 仓库

• Docker 仓库是用来存放和分享镜像的地方
• 用户可以将镜像上传到仓库后，供其他人下载
• Docker Hub 是 Docker 的官方仓库，可以搜索大量镜像

Docker 安装方式

暂略~ 我日常使用 ==1Panel==、==cnb.cool==、==群晖 Nas== 这些方式管理 Docker 容器 他们都已经配置好了 Docker 环境 暂时不需要去了解 Docker 的安装

Docker 镜像管理

镜像地址

一个完整的镜像地址包含以下四部分：

docker.io/library/nginx:latest
<仓库地址>/<命名空间>/<镜像名称>:<版本标签>

• docker.io 是 Docker Hub 官方仓库的地址，可以省略
• library 是 Docker Hub 官方仓库的命名空间，可以省略
• nginx 是镜像名称
• latest 是版本标签，latest表示最新版本，可以省略
• 示例：
  • 从官方仓库下载最新版 nginx 镜像: docker pull nginx
  • 从官方仓库的 n8n 命名空间下载镜像: docker pull n8nio/n8n
  • 从 n8n 私有仓库下载镜像: docker pull docker.n8n.io/n8nio/n8n

官方仓库的镜像往往无法直接下载，需要寻找相应的镜像站或使用代理。

//TODO

2.2 - Docker 常用命令速查

列出日常使用频率最高的命令。更多可参考 Docker 命令大全 | 菜鸟教程

容器管理

镜像管理

日志与调试

Docker Compose

系统维护

2.3 - Docker 重启策略详解

Docker 容器的重启策略有四种：no、always、on-failure、unless-stopped。

下面通过一个 demo 来演示它们的区别。

准备测试环境

创建一个名为 test.sh 的脚本，5 秒后自动退出：

#!/bin/bash
sleep 5
exit 1

创建 Dockerfile 将其打包进镜像：

FROM ubuntu
ADD test.sh /
CMD /bin/bash /test.sh

构建镜像：

docker build -t test-restart .

no

docker run -d --name=test-restart-no test-restart

容器 5 秒后退出，docker daemon 不做任何处理。

结论：容器退出后不重启。

always

docker run -d --restart=always --name=test-restart-always test-restart

容器退出后 docker daemon 自动重启。虽然每次生命周期只有 5 秒，但不断重启，表面上像一直在运行。

如果手动 docker stop 停止，不会自动重启。但重启 Docker daemon 后，容器会再次启动。

结论：除非手动停止，否则总是重启。重启 Docker daemon 也会触发。

on-failure

docker run -d --restart=on-failure:3 --name=test-restart-on-failure test-restart

容器退出后触发重启。容器退出后触发重启。当重启达到 3 次上限后不再重启。

注意：Docker 认为容器成功启动至少需运行 10 秒。脚本 5 秒就退出，触发重启的次数会持续累加直到上限（参考Docker 官方文档）。

结论：仅在容器非正常退出时重启，可设置最大重试次数。

unless-stopped

docker run -d --restart=unless-stopped --name=test-restart-unless-stopped test-restart

表现和 always 一样——容器退出后自动重启。区别在于：手动 docker stop 停止后，重启 Docker daemon 时容器不会自动启动，而 always 会。

结论：与 always 类似，但手动停止后重启 Docker 不会再次启动。

如何选择

• no：一次性任务、调试环境，不需要自动重启
• always：Web 服务、数据库等需要持续运行的服务
• on-failure：脚本任务、批处理作业，只在出错时重试
• unless-stopped：和 always 类似，但希望手动停止后不再被 Docker 重启时使用

参考资料

• 了解 Docker 容器重启策略，这一篇就够了！ - 墨天轮

2.4 - Docker 远程管理 Portainer

本文内容基于 6053537/portainer-ce - Docker Image | Docker Hub 的汉化版。

远程主机设置

1. 确保远程主机已安装 Docker

2. 进入主机终端，输入命令：

nano /usr/lib/systemd/system/docker.service

3. 然后做以下修改：

# 将这一行
ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

# 改为这样
ExecStart=/usr/bin/dockerd -H tcp://0.0.0.0:2375 -H fd:// --containerd=/run/containerd/containerd.sock

4. 最后再重启 Docker 即可

systemctl daemon-reload
systemctl restart docker

5. 记得在服务器的防火墙放开 2375 端口

Portainer 设置

1. 环境 - 添加环境 - 独立的 Docker
2. 选择 API 连接模式
3. Docker API URL 处填写被远程连接的主机 IP+ 端口，如 6.6.6.6:2375
4. 点击链接，完成。

参考资料

• 部署 Portainer 来管理本地或远程的 Docker - Moeyukina’s Blog

3 - Git

Git 的日常命令、身份配置，以及仓库写坏之后的收拾办法。

3.1 - Git 常用命令速查

本文基于 Git 2.46.0，日常使用中如有更多需求可查看 git help 或官方文档。

基本操作

分支管理

查看历史

撤销与暂存

远程协作

配置

其他

3.2 - Git 多仓库身份配置

工作电脑上同时有个人项目和公司项目时，如果不做配置，所有提交都会使用同一个用户名和邮箱。这篇文章教你如何让 Git 根据仓库自动切换身份。

配置优先级

Git 采用三层配置覆盖，优先级从低到高：

系统级 → 全局级 → 仓库级

仓库级配置会覆盖全局级，所以只需要在个别仓库设置独立身份即可。

操作步骤

1. 设置全局默认身份

适用于大多数仓库（比如你的个人项目）：

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

2. 设置单个仓库的独立身份

终端切换到需要单独设置的仓库目录，不加 --global：

cd /path/to/company-project
git config user.name "work-name"
git config user.email "work@company.com"

这条命令会写入当前仓库的 .git/config，只影响这个仓库。

3. 验证当前仓库身份

git config user.name
git config user.email

手动编辑配置

也可以直接打开仓库下的 .git/config 文件，找到或添加：

[user]
    name = work-name
    email = work@company.com

常见场景

3.3 - Git 清理远端仓库全部提交历史

背景

当提交记录中包含隐私信息（如密钥、密码），或仓库因上传大量文件导致体积过大、拉取频繁出错时，可以通过清除全部提交历史来"瘦身"仓库，同时保留仓库本身（Star、Issues 等不受影响）。

以下两种方法均以 main 分支为例，操作前请先将仓库克隆到本地。

方法一：创建空白分支替换

通过 --orphan 创建一个没有历史的新分支，替换掉原来的 main：

git checkout --orphan latest_branch  # 创建一个没有历史的新分支
git add -A  # 暂存所有文件
git commit -m "Initial commit"  # 创建初始提交
git branch -D main  # 删除本地的 main 分支
git branch -m main  # 将当前分支重命名为 main
git push -f origin main  # 强制推送到远程仓库，替换远程 main 分支

方法二：删除 .git 重新初始化

直接删除本地的 Git 历史，重新初始化一个全新的仓库：

rm -rf .git  # 删除本地 Git 仓库目录
git init  # 重新初始化一个新的 Git 仓库
git add -A  # 暂存所有文件
git commit -m "Initial commit"  # 创建初始提交
git push -f https://github.com/username/repo.git main  # 强制推送到远程仓库（需替换为实际仓库地址）

参考资料

• 删除 GitHub 上的 commit 记录 - 博客园

4 - 其他

系统命令、云原生、开发工具这些暂时没单独分出去的笔记，都先放这里。

4.1 - Linux 常用命令速查

列出日常使用频率最高的命令。更多可参考 Linux 命令大全 | 菜鸟教程

系统信息

文件与目录

文件查找与内容搜索

进程管理

磁盘与内存

网络

文件权限

压缩与归档

包管理（Debian/Ubuntu）

4.2 - Markdown 语法速查

语法速查表

标题

注意：所有符号都是英文输入法下的符号。井号加空格，几个井号就是几级标题，一级标题字体最大。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

文本

**加粗**
*斜体*
***粗斜体***
~~删除线~~

列表

无序列表： 减号/加号/星号 + 空格，三个符号均可，建议用减号。

- 列表项 1
- 列表项 2
 - 嵌套列表项
- 列表项 3

有序列表： 数字 + 点 + 空格。

1. 列表项 a
2. 列表项 b
 1. 嵌套项 b1
3. 列表项 c

任务列表： 方括号内空格代表未完成，x 代表已完成。

- [ ] 未完成的任务
- [x] 已完成的任务

引用

> 这是一段引用
>> 嵌套引用

链接

[显示的文字](https://example.com)

直接链接：<https://github.com>

锚点链接：[链接文字][锚点名]
[锚点名]: https://example.com

图片

![替代文本](图片路径 "可选的标题")

带链接的图片：[![替代文本](图片路径)](https://example.com)

表格

竖线分隔单元格，分隔行至少三个减号，冒号控制对齐。

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| AAA    |   BBB    |    CCC |

代码

行内代码：用反引号包裹，如 `code`。

代码块：用三个反引号包裹，可指定语言。

```python
import numpy as np
def calc(a):
    return np.sqrt(a) * 3
```

脚注

要添加脚注[^01]

[^01]: 脚注内容

分割线

三个或以上的减号、星号、下划线均可。

---
***
___

注意事项

• 所有符号都是英文输入法下的符号
• 井号 # 后要加空格才是标题

4.3 - MySQL 常用 SQL 语句速查

数据库操作

/* 创建数据库 */
CREATE DATABASE 数据库名称;

/* 删除数据库 */
DROP DATABASE 数据库名称;

/* 查看所有数据库 */
SHOW DATABASES;

/* 查看当前数据库的字符集等信息 */
SHOW CREATE DATABASE 数据库名称;

/* 修改数据库的字符集等属性 */
ALTER DATABASE 数据库名称 CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

数据表操作

/* 创建数据表 */
CREATE TABLE 数据表名称 (字段1 数据类型1, 字段2 数据类型2, ...);

/* 删除数据表 */
DROP TABLE 数据表名称;

/* 查看当前数据库中的所有数据表 */
SHOW TABLES;

/* 查看数据表的结构 */
DESCRIBE 数据表名称;

/* 查看数据表的创建语句 */
SHOW CREATE TABLE 数据表名称;

/* 添加新列 */
ALTER TABLE 数据表名称 ADD COLUMN 新字段 数据类型;

/* 修改列的数据类型 */
ALTER TABLE 数据表名称 MODIFY COLUMN 字段1 新数据类型;

/* 重命名列 */
ALTER TABLE 数据表名称 CHANGE COLUMN 字段1 新字段名 数据类型;

/* 删除列 */
ALTER TABLE 数据表名称 DROP COLUMN 字段1;

数据行操作

/* 插入数据行 */
INSERT INTO 数据表名称 (字段1, 字段2, ...) VALUES (值1, 值2, ...);

/* 查询数据行 */
SELECT 字段1, 字段2, ... FROM 数据表名称 WHERE 字段1 = '条件值1';

/* 更新数据行 */
UPDATE 数据表名称 SET 字段1 = '新值1', 字段2 = '新值2', ... WHERE 字段1 = '条件值1';

/* 删除数据行 */
DELETE FROM 数据表名称 WHERE 字段1 = '条件值1';

条件与排序

/* 条件查询 */
SELECT * FROM 数据表 WHERE 字段1 = '值';
SELECT * FROM 数据表 WHERE 字段1 LIKE '%关键词%';
SELECT * FROM 数据表 WHERE 字段1 > 100 AND 字段2 = '值';

/* 排序 */
SELECT * FROM 数据表 ORDER BY 字段1 DESC;        /* 降序 */
SELECT * FROM 数据表 ORDER BY 字段1 ASC;         /* 升序（默认） */

/* 分页 */
SELECT * FROM 数据表 LIMIT 10;                    /* 取前 10 条 */
SELECT * FROM 数据表 LIMIT 10 OFFSET 20;          /* 跳过 20 条，取 10 条 */
SELECT * FROM 数据表 LIMIT 20, 10;                /* 同上，简写形式 */

聚合与分组

/* 聚合函数 */
SELECT COUNT(*) FROM 数据表;                      /* 统计行数 */
SELECT SUM(金额字段) FROM 数据表;                  /* 求和 */
SELECT AVG(价格字段) FROM 数据表;                  /* 平均值 */
SELECT MAX(年龄字段) FROM 数据表;                  /* 最大值 */
SELECT MIN(年龄字段) FROM 数据表;                  /* 最小值 */

/* 分组统计 */
SELECT 分类字段, COUNT(*) FROM 数据表 GROUP BY 分类字段;
SELECT 分类字段, SUM(金额) FROM 数据表 GROUP BY 分类字段 HAVING SUM(金额) > 1000;

索引

/* 创建索引 */
CREATE INDEX 索引名称 ON 数据表 (字段1);
CREATE INDEX 索引名称 ON 数据表 (字段1, 字段2);   /* 联合索引 */

/* 删除索引 */
DROP INDEX 索引名称 ON 数据表;

/* 查看索引 */
SHOW INDEX FROM 数据表;

用户管理

/* 创建用户 */
CREATE USER '用户名'@'localhost' IDENTIFIED BY '密码';
CREATE USER '用户名'@'%' IDENTIFIED BY '密码';     /* 允许远程登录 */

/* 授权 */
GRANT ALL PRIVILEGES ON 数据库名.* TO '用户名'@'localhost';
GRANT SELECT, INSERT, UPDATE ON 数据库名.* TO '用户名'@'%';

/* 刷新权限 */
FLUSH PRIVILEGES;

/* 查看用户 */
SELECT User, Host FROM mysql.user;

/* 修改密码 */
ALTER USER '用户名'@'localhost' IDENTIFIED BY '新密码';

/* 删除用户 */
DROP USER '用户名'@'localhost';

常用数据类型

数值类型

FLOAT(M,D) / DOUBLE(M,D) / DECIMAL(M,D) 中的 (M,D) 表示总长度 M 位，其中 D 位是小数。例如 DECIMAL(10,2) 总长 10 位，小数 2 位，整数 8 位。

字符串类型

日期和时间类型

DATETIME 和 TIMESTAMP 的区别：TIMESTAMP 会自动转换为当前时区；DATETIME 不受时区影响。日常场景首选 DATETIME。

JSON 类型

4.4 - SSH 密钥配置指南

简介

SSH 密钥（SSH Key）是一种用于安全登录远程服务器的"钥匙"，它由一对公钥和私钥组成。与密码相比，SSH 密钥更安全，也更方便。

• 公钥（Public Key）：放在远程服务器上，可以公开。
• 私钥（Private Key）：保存在本地电脑，必须保密，不能泄露。

可以将其类比为钥匙（私钥）和锁芯（公钥），公钥放在远程服务器上，私钥保存在本地电脑里，相互配对才能正确打开。

生成密钥

在终端内执行：

• 使用 ed25519 算法（推荐）：ssh-keygen -t ed25519 -C "备注"
• 使用 rsa 算法（兼容性好）：ssh-keygen -t rsa -b 4096 -C "备注"

执行后，会让你确认密钥保存在哪里，是否需要再加一个密码。在一路回车的默认情况下，会在 ~/.ssh 目录下生成两个文件：

• id_ed25519 或 id_rsa 即私钥
• id_ed25519.pub 或 id_rsa.pub 即公钥

然后将公钥与远程服务器绑定即可。

绑定公钥

• GitHub-SSH and GPG keys
• 腾讯轻量云服务器-SSH密钥

进阶：使用 ~/.ssh/config

服务器多起来后，每次 SSH 都要记 IP 和端口很麻烦。可以在 ~/.ssh/config 中为常用服务器设置别名：

# 个人服务器
Host my-server
    HostName 123.123.123.123
    User root

# Web 服务器
Host web-server
    HostName 456.456.456.456
    User admin
    Port 2222

配置后直接 ssh my-server 即可登录，不用再记 IP 和端口。

4.5 - VSCode 配置机制完整笔记

一、.vscode 目录概述

.vscode 是 VS Code 的项目级配置目录，定义"当 VS Code 打开这个项目时，该如何表现"。

常见文件结构

.vscode/
├── settings.json      # 工作区设置（覆盖用户全局设置）
├── extensions.json    # 推荐安装的扩展列表
├── launch.json        # 调试配置
├── tasks.json         # 自定义任务
└── snippets/          # 代码片段目录

二、配置层级与覆盖机制

三层架构（优先级由低到高）

VS Code 默认设置
    ↓
用户级设置（~/settings.json）
    ↓
工作区设置（.vscode/settings.json）← 项目级，优先级最高

关键区别

示例对比

settings.json（增量）

// 用户级：a=1, b=2, c=3, d=4, e=5
// 项目级写：{"b": 20}
// 结果：a=1, b=20, c=3, d=4, e=5（继承+覆盖）

extensions.json（全量）

// 用户级：安装了 a,b,c,d
// 项目级写：{"recommendations": ["a","b"]}
// 结果：只推荐 a,b（不会推荐 c,d）

三、配置存储位置

用户级配置

项目级配置

• 位置：.vscode/ 目录下
• 作用范围：仅当前项目
• 版本控制：应提交到 Git，确保团队一致

四、扩展管理

用户级 vs 项目级

扩展推荐配置

{
  "recommendations": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"],
  "unwantedRecommendations": ["some.extension.to.disable"]
}

多项目扩展隔离方案

场景：项目A用a,b,c，项目B用d,e,f，其他项目用a,b,c,d

五、跨平台路径处理

核心原则

能用相对不用绝对，能用变量不用字符串

内置变量

正确 vs 错误示例

// ❌ 错误：硬编码绝对路径
"python.defaultInterpreterPath": "C:/Users/123/project/venv/bin/python"

// ✅ 正确：使用变量
"python.defaultInterpreterPath": "${workspaceFolder}/venv/bin/python"
"python.analysis.extraPaths": ["${userHome}/.local/lib/python"]

特殊情况处理

如果路径完全无关（如 Windows D:\project1\123 vs macOS Documents/project1/123）：

六、VS Code 设置同步

同步内容

• ✅ 用户级 settings.json
• ✅ 扩展列表（自动重新安装）
• ✅ 键盘快捷键
• ✅ 用户级代码片段
• ✅ UI 状态

不同步内容

• ❌ 项目级 .vscode/ 目录（需 Git 管理）
• ❌ 扩展的本地数据/缓存

分工明确

七、最佳实践总结

1. 配置原则

• 项目级（.vscode/）：放团队共享、通用、跨平台的配置
• 用户级（~/settings.json）：放个人偏好、系统特定的配置

2. 路径原则

• 优先使用 ${workspaceFolder}（项目内）
• 其次使用 ${userHome}（用户目录）
• 避免硬编码盘符（如 D:\、/Volumes/）

3. 扩展原则

• 项目必需的扩展 → extensions.json 推荐
• 个人辅助扩展 → 用户级安装，不同步到项目

4. 调试/任务原则

• 通用任务 → .vscode/tasks.json（全量定义）
• 个人调试习惯 → 用户级 launch.json

八、快速参考命令

4.6 - MacOS 系统降级流程

本文介绍如何将 Intel 芯片的 MacOS 从 13.x 版本降级到 10.15 或 12.x 版本（已实测），其他版本仅供参考。

参考链接

• 视频教程：经验分享｜macOS｜如何创建可引导的macOS安装器并重装macOS系统
• 官方文档：创建可引导的 macOS 安装器 - 官方 Apple 支持 (中国)
• 官方文档：如何下载和安装 macOS - 官方 Apple 支持 (中国)

MacOS 版本推荐

以下版本信息针对 2017 MacBook Pro 设备：

• Ventura 13——最后一个支持的版本
• Monterey 12——稳定性一般，兼容性较好
• Catalina 10.15——稳定性最佳，兼容性一般

操作步骤

1. 准备工作

1. 备份所有重要数据
2. 退出系统的 Apple ID
3. 准备一个 14GB 以上的 USB 闪存盘

2. 下载 MacOS

1. 在 本页面 通过 App Store 下载所需的系统版本（如 Monterey 12）
2. 下载完毕后，若自动打开安装程序，直接关闭退出
3. 确保应用程序文件夹内有名为 安装macOS Monterey 的安装器

3. 创建 macOS 安装器

1. 插入准备的 USB 闪存盘
2. 使用系统自带的 磁盘工具 应用，将其全盘抹掉并格式化：
   • 名称：MyVolume（建议使用此名称，方便后续操作）
   • 格式：Mac OS拓展（日志式）（是否区分大小写不影响）
3. 启动终端，根据所需的系统版本输入命令（命令来源）：
   • Catalina：sudo /Applications/Install\ macOS\ Catalina.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolume
   • Monterey：sudo /Applications/Install\ macOS\ Monterey.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolume
4. 根据终端提示完成安装：
   • 输入登录密码（输入时终端无字符提示）
   • 输入 Y 确认全部抹掉 USB 闪存盘（弹出允许终端访问可移动宗卷的提示时点击允许）
   • 耐心等待，过程较为漫长
5. 安装完成后，USB 闪存盘名称将改为类似 Install macOS Monterey 的名称

4. 启动 MacOS 安装程序

1. 重启设备后，立刻按住 Option 键，直到出现可引导安装器的宗卷（即 Install macOS Monterey）
2. 通过方向键选择安装器（若无法启动，需确保“启动安全性实用工具”已设为允许从外部或可移动介质启动）

5. 安装 MacOS

1. 进入安装器后，启动磁盘工具，抹掉内置的整个硬盘（通常被命名为 Macintosh HD）：
   • 名称：Macintosh HD
   • 格式：APFS
2. 关闭磁盘工具，返回选择 安装macOS Monterey
3. 选择安装到 Macintosh HD
4. 耐心等待，过程较为漫长

6. 完成安装

安装完成后，剩余步骤为初始化新的 MacOS 系统流程。

4.7 - Front Matter 规范

本站约定

• title 是唯一必填字段，没有它 Hugo 无法渲染页面。
• 日期使用本站自定义的 created / updated 字段，由 hugo.yml 的 frontmatter 映射到 Hugo 原生的 date / lastmod。
• updated 一般不写——页面「最后修改」由 :git（最后一次 commit 时间）自动填充；手动写 updated 才会覆盖。
• 编辑器可能对 created / updated 报 schema 错误，这是误报，勿改名（改名会破坏日期映射）。
• 字段取值优先级：页面 front matter → 上级 cascade → hugo.yml 站点参数。

文章页字段

OINK 主题常用字段

完整字段表见 OINK Front Matter 官方文档。

文章页模板

---
created: YYYY-MM-DD
title: 本文标题
tags: [标签1, 标签2]
---

索引页

各分区的 _index.md：

日期机制

hugo.yml 中配置了 front matter 的取值优先级：

frontmatter:
  date:
    - created       # 第一优先级 → 页面创建日期
    - date
  lastmod:
    - updated       # 手动覆盖（可选）
    - :git          # 由 Git 提交记录自动填充
    - lastmod

• 创建日期：Hugo 从 created 取值。
• 更新日期：默认由 :git 自动填充（最后一次 commit 时间），如需手动指定，在 front matter 中写 updated 即可覆盖。

4.8 - 修复 Git 提交时间无法显示

问题现象

文章页面底部的"最后更新"时间始终不显示，检查 Hugo 模板发现 .GitInfo 和 .Lastmod 均为空值。

原因

当文件路径包含中文等非 ASCII 字符时（如 content/docs/实践笔记/Docker 重启策略详解.md），Git 默认会对路径做转义处理，导致 Hugo 的 Git 集成无法正确匹配文件路径，.GitInfo 返回 nil，.Lastmod 随之失效。

这是 Hugo 的已知问题，umlauts（ä、ö、ü）等路径也会触发。

解决方案

本地开发

在仓库根目录执行一次：

git config core.quotePath false

然后删除 .hugo_build.lock（缓存了旧状态），重新构建即可。

CI/CD 构建

.cnb.yml 中在 hugo 命令之前加上同一行：

- name: Hugo 构建
  script: |
    # 文件路径包含中文等字符时会导致 Hugo 拿不到 Git 提交时间，执行以下命令修复此问题
    git config core.quotePath false
    hugo --minify

验证

构建后检查页面 HTML，如果出现 hx:mt-12 而非 hx:mt-16，说明更新日期已正常显示。

参考

• GitInfo fails if there is an umlaut in the folder path — Hugo Discourse
• Hugo .GitInfo 官方文档
• Hugo enableGitInfo 配置