Master He's Blog

网站建立记录

🚀 博客搭建全流程笔记 (Pelican + GitHub + Cloudflare)

核心架构：

发动机：Python + Pelican (静态网站生成器)

仓库：GitHub (版本控制与存储)

发布端：Cloudflare Pages (全球 CDN 加速 + 自动化构建)

📅 第一阶段：基础设施准备

1. 域名与 DNS

购买：在 Spaceship 购买高性价比数字域名。
托管：登录 Spaceship 后台，将 Nameservers (NS) 修改为 Cloudflare 提供的地址。
意义：利用 Cloudflare 的全球 CDN 加速、免费 SSL 证书（HTTPS）以及后续的 Pages 托管服务。

2. 本地环境初始化 (Python)

在 PyCharm 或 VS Code 终端执行以下核心命令：

PowerShell

# 1. 创建虚拟环境 (隔离项目，防止污染全局库)
python -m venv .venv

# 2. 激活环境 (Windows) -> 每次写博客前必做！
.venv\Scripts\activate
# 注：Mac/Linux 使用 source .venv/bin/activate

# 3. 安装 Pelican 和 Markdown 支持
pip install "pelican[markdown]"

# 4. 初始化项目 (一路回车，URL 暂时留空)
pelican-quickstart

🛠️ 第二阶段：版本控制 (Git) —— 最关键的一步

此阶段极易踩坑，必须严格执行 .gitignore 配置，否则会导致仓库爆炸。

1. 创建防爆盾：`.gitignore`

在项目根目录（和 pelicanconf.py 同级）新建文件 .gitignore，填入以下内容：

Plaintext

.venv/
output/
__pycache__/
.idea/
cache/
*.pyc

⚠️ 警示：如果不加这个文件，Git 会试图上传虚拟环境里成千上万个 Python 库文件，导致上传失败或崩溃。

2. 推送到 GitHub

PowerShell

git init
git add .
git commit -m "Initial commit"
# 关联远程仓库 (URL 替换为你自己的)
git remote add origin https://github.com/你的用户名/my_blog.git
git push -u origin master

☁️ 第三阶段：云端部署 (Cloudflare Pages)

1. 核心配置清单

在 Cloudflare Pages 后台关联 GitHub 仓库后，Build Settings 必须精准填写：

配置项	填写内容	备注
Framework preset	`None`	不要选其他框架
Build command	`pip install pelican[markdown] && pelican content -s publishconf.py`	安装依赖并生成网页
Build output	`output`	Pelican 默认生成位置
Environment Variables	`PYTHON_VERSION` = `3.11`	关键！即使本地是 3.14，云端也要填 3.11

2. 域名绑定

在 Pages 项目页点击 Custom Domains。
输入在 Spaceship 购买的域名，Cloudflare 会自动完成 DNS 解析记录的添加。

✍️ 第四阶段：日常创作与维护 (Loop)

搭建完成后，以后的日常只需要做三件事：

写 (Write)：
- 在 content/ 目录下新建 .md 文件。
- 元数据必填：文件头部必须包含 Title:, Date:, Category: 等信息。
存 (Commit)：

PowerShell

git add . git commit -m "新文章：标题"
发 (Push)：

PowerShell

git push

🚀 自动化：Git 推送后，Cloudflare 会自动检测更新并重新部署，全球用户立刻就能看到新内容。

📝 附录：踩坑与故障排除日志 (Troubleshooting)

🔴 故障 A：Git 试图上传数千个文件 (.venv 问题)

现象：git status 满屏红色，包含 .venv/Lib/...。
原因：.gitignore 文件缺失、位置错误，或在创建该文件前就已经执行了 git add。
急救方案：

PowerShell

```

1. 确保 .gitignore 在根目录且内容正确

2. 清空 Git 缓存

git rm -r --cached .

3. 重新添加

git add . ```

🔴 故障 B：Git 报错 "Author identity unknown"

原因：新环境未配置身份。
解决：

PowerShell

git config --global user.email "你的邮箱" git config --global user.name "你的名字"

🔴 故障 C：仓库太乱，想重头再来 (重生之术)

解决：

PowerShell

rm -Recurse -Force .git # 删除旧的 Git 记录 git init # 重新初始化 git add . # 重新添加

💡 常用命令备忘

本地预览：pelican --listen (访问 localhost:8000)
云端卡顿：如果更新后线上没变，去 Cloudflare 控制台看 Deployments 日志，通常是构建命令写错或网络波动。

Master He's Blog

Other articles

Test

我的第一篇博客

你好，世界！

Other articles

你好，世界！

links

social