免费搭建个人博客网站全教程

学完本文你能做到什么

• 拥有一个完全免费、可长期运行的个人博客网站
• 获得一个专属的二级域名（如 yourname.github.io）
• 掌握发布文章、更换主题、绑定自定义域名的完整流程
• 无需购买服务器，无需编写任何代码

整个过程约需 30-60 分钟，所需条件仅为一个邮箱账号。

前置条件

第一步：注册 GitHub 账号

1. 打开 github.com，点击首页右侧 Sign up。
2. 输入邮箱、密码和用户名。用户名会出现在你的博客域名中，建议使用全小写字母或数字组合。
3. 完成邮箱验证码验证后，保持默认选项，点击 Continue 完成注册。
4. 登录后进入个人主页，确认左上角显示你的用户名。

注意：用户名一旦确定，你的免费博客地址将是 用户名.github.io，后续修改用户名会导致博客地址变化。

第二步：创建博客仓库

1. 在 GitHub 右上角点击 + 号，选择 New repository。
2. 在 Repository name 一栏填写：你的用户名.github.io（必须完全一致，包括大小写）。
3. 可见性选择 Public。
4. 勾选 Add a README file。
5. 点击 Create repository。

创建完成后，GitHub 会自动将这个仓库识别为静态网站仓库，博客框架已经就绪。

第三步：选择并启用博客主题

GitHub 内置了多套免费 Jekyll 主题，无需手动安装。

1. 进入刚创建的仓库页面，点击顶部 Settings 标签页。
2. 在左侧菜单中找到 Pages（或 Code and automation → Pages）。
3. 在 Branch 区域，确认来源为 main 分支，目录为 / (root)，点击 Save。
4. 回到仓库主页，点击 Add file → Create new file。
5. 文件名填写 _config.yml，在文件内容中输入以下代码：

title: 我的博客
description: 记录学习与生活
theme: jekyll-theme-minimal

6. 点击 Commit new file 保存。

等待约 1-2 分钟，访问 https://你的用户名.github.io，即可看到博客首页已经生成。

第四步：发布第一篇文章

博客文章以 Markdown 格式存放在 _posts 文件夹中。

1. 进入仓库主页，点击 Add file → Create new file。
2. 文件名按以下格式填写（日期必须为真实日期）：

_posts/2025-01-15-my-first-post.md

3. 在文件内容中写入：

---
layout: post
title: "我的第一篇博客"
date: 2025-01-15
---

这是我的第一篇博客文章。免费博客搭建成功！

4. 点击 Commit new file。
5. 等待约 1 分钟后刷新博客首页，文章已出现在列表中。

第五步：绑定自定义域名（可选）

如果希望使用自己的域名（如 blog.example.com），需要先拥有一个域名。

1. 在仓库 Settings → Pages → Custom domain 栏中填入你的域名。
2. 点击 Save。
3. 前往域名服务商后台，添加一条 CNAME 记录：

• 主机记录：blog（或你使用的子域名前缀）
• 记录值：你的用户名.github.io

4. 等待 DNS 生效（通常几分钟到几小时），访问自定义域名即可打开博客。

搭建完成后的效果

以下为使用默认主题搭建完成后的博客页面示意：

实际页面布局取决于所选主题。更换主题只需修改 _config.yml 中的 theme 字段，可选值包括 jekyll-theme-minimal、jekyll-theme-cayman、jekyll-theme-architect 等，修改后提交即可生效。

常见问题排查