个人博客 开发日志

从 2022 年的原生 HTML 一路改到现在，中间换了三套技术栈
产物仓库 personal_website 共 26 个提交，源码仓库 2026-10-01 首次入库

演进速览

• ✅ 2022.11 原生 HTML/CSS/JS + Flask 动态站（手写模板）
• ✅ 2024 静态化改造：HTML + 手动同步脚本
• ✅ 2025.07 迁移 VuePress 2 + Theme Hope + Waline + Webhook 自动部署
• ✅ 2026.10 SEO 全套、双仓库拆分、Nginx 404 修正
• ✅ 运维自动化：Gitee Webhook 自动部署 + acme.sh 证书自动续期（阿里云 DNS API）

---

2022/11 起点

• √ 原生 HTML + Flask，模板全手写
• √ 文章、竞赛笔记先堆上去再说

那时候觉得动态站才叫"真网站"，后来才发现博客 99% 的时间都在被人读，不在被人写。

---

2024 静态化

• √ 把 Flask 动态渲染改成静态 HTML
• √ 写了个手动同步脚本

第一次意识到：博客这种东西，静态就够了，还便宜、还快、还不会被注入。

---

2025/7/7

• ✅ Initial commit —— 正式迁到 VuePress 2 + Theme Hope
• ✅ 五大栏目骨架、标签/分类/时间线三维索引、侧边栏分组折叠
• ✅ Waline 自部署评论系统（独立子域，邮箱登录、暗色适配、被回复邮件提醒）
• ✅ Gitee Webhook 自动部署链路搭起来：push → fcgiwrap → deploy.sh → git pull

换了框架之后，第一次体会到"写完 Markdown 就上线"的爽感。

---

2025/7/8 ~ 7/12

• ✅ 这五天产物仓库连着 14 个"自动更新"提交——全是构建脚本自己提的
• ✅ 最狠一天构建了 5 次（07-09），把发布流程跑成了肌肉记忆
• ✅ 暗色/浅色主题切换、文章元信息（字数、阅读时间）

提交记录里全是"自动更新：周X HH:MM:SS"，看着像机器人干的活，其实是我一天手贱构建了五次。

---

2025/7/26 ~ 7/28

• ✅ 继续补内容、调样式（改动在私有源码仓库，产物仓库只留下自动更新记录）

---

2025/8/24

• ✅ 最后一次自动更新，该修的修完
• 之后博客进入"只写不改"状态，一停就是一年多

---

2026/10/1

• ✅ SEO 全套：sitemap.xml 自动生成、robots.txt、每页 og 标签
• ✅ 简历页 + 抖音主页链接 + 介绍页重写
• ✅ 源码仓库正式入库：源码（私有，含配置与素材）纳入版本管理，与只管部署的产物仓库彻底分开
• ✅ Nginx 404 修正：未知路径原本转发到 localhost:8080（那儿根本没服务，返回 502），改成 try_files ... =404
• ✅ 新增「我的作品」栏目文章（含本页）

SEO 这块拖了一年多才做，纯粹是因为之前不知道死链会拖垮收录——一个 502 就够了。

---

踩过的坑（记下来，免得重犯）

1. ⬜ 图片放错目录直接挂：VuePress 只拷贝 .vuepress/public/ 下的资源，Markdown 同级目录的图片不进产物，线上图挂了半天才发现
2. ⬜ 正文在 JS chunk 里：内容被编译进 assets/xxx.html-<hash>.js，index.html 里只有标题和目录，用 grep 查不到正文不代表没发布
3. ⬜ 旧构建产物堆积：每次构建哈希都变，旧 chunk 不会自动清理，产物仓库体积一路涨
4. ✅ 不存在的路径返回 502：上面 2026/10/1 已修

---

写完 Markdown → 一条命令构建 → push → 十秒内上线，全程不登服务器。
这条链路调通的那天，才算是这个博客真正"做完了"——剩下的只是往里写东西。