我是如何借助 Codex、KimiCode、VSCode 和 GitHub Pages 搭建个人博客的

这篇文章记录了我搭建个人博客的完整过程。这个站点不仅用来写技术分享，也承担了个人简历、项目介绍和作品集展示的作用。

整个博客最终采用的是 Jekyll + Chirpy + GitHub Pages 方案，而我实际完成整理和配置的方式，是在 VSCode 里结合 Codex 和 KimiCode 一起推进。

为什么要做这个博客

我希望这个博客能够同时承担几件事：

• 作为个人分享平台，记录学习、实践和整理后的内容
• 作为项目展示入口，集中放自己的项目介绍和链接
• 作为在线简历的补充页面，展示经历、方向和持续更新的作品
• 作为长期积累的个人空间，保留技术文章和一些杂谈

我使用的工具组合

这次搭建里，几个工具分别承担了不同角色：

• VSCode：主要编辑器，用来查看项目结构、修改 Markdown 和配置文件
• Codex：帮助我阅读项目、解释配置、修改文件、排查问题和整理文章
• KimiCode：作为辅助插件，补充日常开发时的内容整理和交互支持
• GitHub Pages：负责最终托管和自动发布博客

实际搭建过程

1. 先确认项目到底是什么

关于博客的网站搭建，直接使用的kimi code部署生成，最开始是hexo+butterfly的技术栈，后来在使用搜索引擎查询其他内容时候，发现butterfly的主题不太合我的胃口，不过可以直接部署使用，还是很方便。

对于网站的部署，选用的GitHub page。注册账号->新建仓库（建议与账号同名称）-> 进入仓库 setting 选择pages切换到mian分支，然后选择action部署。这部分内容可自行查阅其他部署教程。下附我参考的内容。

【避坑篇】使用Github Pages搭建个人主页or博客网站【上】 - 春枫禾旭的文章 - 知乎 https://zhuanlan.zhihu.com/p/641525444 零基础小白如何搭建自己的 github.io 个人网站: https://pianfan.github.io/build_own_website/

因为部署完成后，对于一下子生成的代码仓库。不知道如何处理，于是准备了codex和kimi帮助我理解仓库的代码结构。每个文件是干什么的。于是就有了接下来的内容。

一开始最重要的不是马上写文章，而是先搞清楚当前项目的真实技术栈。通过查看目录结构和配置文件，可以确定这是一个基于 Jekyll 的博客项目，主题使用的是 Chirpy。

这个步骤很关键，因为只有先确认框架，后面才能知道应该修改：

• _config.yml
• _posts
• _tabs
• _data/contact.yml
• .github/workflows/pages-deploy.yml

2. 配置博客的基础信息

接着开始整理博客的站点配置，包括：

• 博客标题
• 副标题
• 个人简介
• 头像
• 社交账号
• 邮箱
• 时区

这些内容主要集中在 _config.yml 里。头像资源放到项目目录里，再通过配置文件引用。社交图标则放在 _data/contact.yml 中管理。

3. 同步关于页和项目页

只有配置文件更新还不够，因为站点里还有“关于我”“项目”这类独立页面。于是继续同步 _tabs/about.md 等页面，让首页侧边栏、关于页和社交入口保持一致。

这样做的好处是：

• 访客看到的信息统一
• 后续维护时不容易遗漏
• 个人介绍、项目入口和联系方式会更完整

4. 处理头像和时间显示问题

博客上线后，又遇到了两个非常真实的问题：

• 头像没有正确显示
• 归档页时间和文章发布时间不一致

继续排查后发现：

• 头像问题来自配置项没有正确写入头像路径
• 时间问题来自一个插件自动读取 Git 提交记录，覆盖了文章展示时间

修正以后，头像恢复正常，归档页时间也重新和文章 front matter 中的发布时间保持一致。

5. 整理文章内容

原来的文章里保留了一些旧方案的描述，和当前项目的真实结构不一致。于是重新把内容整理成现在这两篇正式文章：

• 一篇讲博客是怎么搭起来的
• 一篇讲我是谁、博客会写什么

这样首页打开后，读者看到的就是更清晰、也更符合当前状态的内容。

6. 推送到 GitHub 并自动发布

内容修改完成后，通过 Git 提交并推送到 GitHub 仓库，GitHub Pages 会根据工作流自动构建部署。这样博客的更新流程就变成了：

1. 在本地修改文章或配置
2. 提交到 GitHub
3. 等待自动发布
4. 在线查看最新效果

为什么我选择这个方案

对我来说，这套方案有几个明显优点：

• 成本低，几乎不需要额外服务器
• 内容管理简单，写文章就是写 Markdown
• GitHub Pages 部署稳定，适合个人博客长期维护
• 既能写文章，也能做个人简历和作品集
• 借助 AI 工具，可以更高效地理解代码和修改配置

这个博客接下来会做什么

这个博客接下来主要会承载几类内容：

• 技术博客整理
• 一些有趣、实用、值得记录的技术内容
• 日常杂谈与个人思考
• 我的个人项目集
• 作为个人主页的简历和作品展示

总结

这次搭建不只是把博客跑起来，更重要的是把博客定位想清楚了：它既是内容平台，也是个人展示页。

借助 Codex、KimiCode、VSCode 和 GitHub Pages，我把这个博客整理成了一个更适合长期更新和个人表达的空间。后面就可以围绕内容本身持续更新，而不是反复折腾基础结构。