为什么你的技术博客迟迟没有上线?
很多想写技术博客的人卡在第一步:要么觉得买服务器太贵,要么被复杂的建站流程劝退。GitHub Pages正是为解决这些问题而生——免费托管、自动部署、支持自定义域名,还能直接用Markdown写作。但官方文档对新手不够友好,这里我们用最直白的语言拆解每个步骤。
准备工作:这些工具缺一不可
- GitHub账号:直接注册即可,不需要付费
- Git客户端:推荐下载GitHub Desktop(图形化操作更简单)
- 文本编辑器:VS Code或任意能写Markdown的软件
Q&A:没有编程基础能用吗?
完全可以。虽然GitHub本身是代码托管平台,但GitHub Pages提供了「傻瓜式」的博客搭建方案,就像在社交平台开通主页一样简单。

Step 1:创建你的专属仓库
- 登录GitHub点击右上角「+」→「New repository」
- 仓库名必须写成
用户名.github.io(例如john.github.io) - 勾选「Initialize this repository with a README」
关键细节:
- 仓库名拼写错误会导致无法访问
- 后续所有博客文件都上传到这个仓库里
Step 2:三选一的建站方案
| 方案 | 难度 | 适合人群 |
|---|---|---|
| 直接上传HTML文件 | ★☆☆☆☆ | 仅需展示静态页面 |
| 使用Jekyll主题 | ★★★☆☆ | 需要分类/标签功能 |
| Hexo等静态生成器 | ★★★★☆ | 追求高度定制化 |
建议新手从Jekyll开始:GitHub原生支持,数百款免费主题可选,修改配置文件就能更换样式。
Step 3:发布你的第一篇文章
- 在仓库中创建
_posts文件夹 - 新建Markdown文件,命名格式:
2024-03-15-标题.md - 文件开头添加YAML头信息:
---
layout: post
title: 你的文章标题
---
常见问题:
- 为什么我的文章没显示? → 检查文件名日期是否在未来
- 图片无法加载? → 使用相对路径如
/images/photo.jpg
进阶技巧:让博客更专业
自定义域名:在仓库Settings的Pages选项卡填写你的域名,别忘了在域名服务商处添加CNAME记录。有人会说「免费博客用GitHub的二级域名不行吗?」——当然可以,但拥有独立域名会显得更正式。
自动部署:安装GitHub Actions后,每次推送新文章都会自动构建。相比手动操作,能避免本地环境差异导致的问题。
现在打开浏览器访问用户名.github.io,你的技术博客已经悄然上线。比起反复纠结「该用什么平台」,立刻开始写作才是更重要的——毕竟再好的工具,也代替不了持续输出的价值。