自动清理pelican缓存的脚本

wen 实用脚本 2026-07-06 5

自动清理Pelican缓存的脚本实战指南

目录导读

为什么要清理Pelican缓存？
手动清理的痛点
自动清理脚本的核心逻辑
脚本实现与详解
如何集成到部署流程中
常见问题与解答

为什么要清理Pelican缓存？

Pelican作为一款优秀的静态站点生成器,在每次构建时都会生成大量缓存文件，这些缓存包括已渲染的HTML、主题资源、插件中间文件等，当你的博客经历以下场景时，缓存问题就会凸显：

自动清理pelican缓存的脚本

修改主题或配置后，旧缓存导致页面样式不更新
文章数量增长到数百篇，构建时间从几秒膨胀到数分钟
频繁发布和回滚，缓存目录积累了大量废弃文件

一个典型的Pelican项目在运行几个月后,output和cache目录可能会占用数百MB甚至GB级的磁盘空间，这不仅拖慢构建速度，还可能导致某些插件因读取陈旧缓存而报错。

手动清理的痛点

许多用户依赖以下方式进行清理：

pelican content -s publishconf.py --delete-output-directory

或者直接：

rm -rf output cache

但手动操作存在三个致命缺陷：

遗忘风险：你很可能在连续调试10次后忘记清理，结果被诡异的前端bug困扰半小时
耗时浪费：每次全量构建需要3-5分钟，手动等待让人烦躁
部署割裂：当你使用CI/CD自动化部署时，手动清理环节无法集成

这正是我们需要一个自动清理脚本的根本原因。

自动清理脚本的核心逻辑

一个优秀的自动清理脚本应满足：

智能识别：不是无脑删除全部缓存，而是清理过期的、无用的文件
安全防护：不删除用户手动创建的重要文件（如content/articles）
可配置性：通过环境变量或配置文件控制清理行为
日志输出：记录清理了哪些文件、释放了多少空间

以下脚本基于这些原则设计。

脚本实现与详解

脚本：`clean_pelican_cache.sh`

#!/bin/bash
# Pelican缓存自动清理脚本
# 用途：清理output、cache目录，保留关键配置和内容文件
PELICAN_DIR="${1:-.}"  # 允许传入项目根目录参数
OUTPUT_DIR="$PELICAN_DIR/output"
CACHE_DIR="$PELICAN_DIR/cache"
CONFIG_FILE="$PELICAN_DIR/pelicanconf.py"
CONTENT_DIR="$PELICAN_DIR/content"
LOG_FILE="$PELICAN_DIR/logs/clean_cache.log"
TIMESTAMP=$(date "+%Y-%m-%d %H:%M:%S")
# 检查依赖命令
for cmd in rm find du; do
    if ! command -v $cmd &> /dev/null; then
        echo "错误：缺少$cmd命令"
        exit 1
    fi
done
# 创建日志目录
mkdir -p "$(dirname "$LOG_FILE")"
# 安全防护：确保不删除内容目录
if [ ! -d "$CONTENT_DIR" ]; then
    echo "$TIMESTAMP [错误] 内容目录 $CONTENT_DIR 不存在，脚本终止" >> "$LOG_FILE"
    echo "错误：内容目录不存在，请从Pelican项目根目录运行此脚本。"
    exit 1
fi
# 记录清理开始
echo "$TIMESTAMP [开始] Pelican缓存清理" >> "$LOG_FILE"
# 清理output目录（保留.git等隐藏文件）
if [ -d "$OUTPUT_DIR" ]; then
    OUTPUT_SIZE=$(du -sh "$OUTPUT_DIR" | cut -f1)
    # 删除output内的所有非隐藏文件和目录
    find "$OUTPUT_DIR" -maxdepth 1 -not -path '*/\.*' -not -path "$OUTPUT_DIR" -exec rm -rf {} + 2>/dev/null
    echo "$TIMESTAMP [完成] 清理output目录 (原大小: $OUTPUT_SIZE)" >> "$LOG_FILE"
fi
# 清理cache目录
if [ -d "$CACHE_DIR" ]; then
    CACHE_SIZE=$(du -sh "$CACHE_DIR" | cut -f1)
    rm -rf "$CACHE_DIR"/*
    echo "$TIMESTAMP [完成] 清理cache目录 (原大小: $CACHE_SIZE)" >> "$LOG_FILE"
fi
# 清理pelican生成的临时文件（如.pelican_plugins_cache）
find "$PELICAN_DIR" -maxdepth 1 -name ".pelican_*" -type f -delete 2>/dev/null
# 释放系统缓存（可选，需要sudo）
# sync && echo 3 > /proc/sys/vm/drop_caches
echo "$TIMESTAMP [全部完成] 缓存清理结束" >> "$LOG_FILE"
echo "缓存清理完成！输出目录和缓存目录已被清空。"

使用方法

将脚本保存到Pelican项目根目录
赋予执行权限：chmod +x clean_pelican_cache.sh
运行：./clean_pelican_cache.sh

安全特性：

脚本会首先验证content目录是否存在，防止在错误目录执行
只删除output下的非隐藏文件,保护.git、.gitignore等
记录详细的日志到logs/clean_cache.log，方便追溯

如何集成到部署流程中

Git Hooks（推荐）

在.git/hooks/pre-push中添加：

#!/bin/bash
# 在push到远程仓库前自动清理缓存
cd /path/to/your/pelican/project
./clean_pelican_cache.sh
# 然后执行重新构建
pelican content -s publishconf.py

Makefile集成

在项目根目录的Makefile中添加：

clean-cache:
    @echo "Cleaning Pelican cache..."
    @./clean_pelican_cache.sh
    @echo "Rebuilding site..."
    @pelican content -s publishconf.py

之后通过make clean-cache一键清理并构建。

部署脚本（如Fabric或Ansible）

# deploy.py (Fabric示例)
from fabric import task
@task
def clean_cache(c):
    c.run("bash clean_pelican_cache.sh")
    c.run("pelican content -s publishconf.py --output output")