0成本搭建博客教程
0成本搭建博客教程
这篇教程面向零基础,从框架选择到部署上线,全程用免费工具。看完你应该能搭出一个能正常访问的博客。
一、先选博客框架
博客框架决定了网站的骨架。新手不用纠结太多,选一个上手快、主题多、维护简单的就行。
静态博客(推荐)
不需要服务器和数据库,生成一堆 HTML 文件,部署到免费托管平台就能跑。速度快、安全、基本不花钱。
| 框架 | 推荐度 | 特点 | 适合谁 |
|---|---|---|---|
| Astro | ★★★★★ | 新一代静态框架,性能强,支持 Vue/React 组件 | 想升级博客、做高性能静态站 |
| Hexo | ★★★★★ | 上手最简单,主题极多,一键部署 | 只想快速搭好、长期稳定用 |
| Hugo | ★★★★☆ | Go 编写,生成速度极快,千篇文章秒生成 | 文章很多、追求极致速度 |
| VitePress | ★★★★ | Vue 官方出品,极轻极快,界面清爽 | 技术笔记、文档型博客 |
本站用的是 Astro。如果你不想折腾,Hexo 是最省心的选择。
动态博客(需要服务器)
需要买服务器和域名,要维护数据库,成本和门槛都更高。
- WordPress:插件和主题海量,后台可视化,不用写代码。缺点是重、需要服务器、容易被攻击。
- Typecho:超轻量 PHP 博客,简洁快速。
- Halo:Java 写的现代博客,界面好看,自带后台。
新手入门建议先用静态博客,等有明确需求了再考虑动态。
二、CSS 和前端框架(可选)
这部分是做自定义网页时会用到的,搭博客可以跳过。
CSS 框架
- Tailwind CSS:原子化 CSS,灵活、体积小、性能好。适合改主题、做自定义网页。
- Bootstrap 5:老牌全能,组件多,兼容性强,新手零门槛。适合快速做官网和后台页面。
前端框架
- Vue 3 + Vite:上手容易,生态强,文档全。适合个人站、工具站、中小后台。
- React + Next.js:支持 SSR,SEO 强。适合复杂网站、电商、大型项目。
三、开始搭建
1. 安装必备工具
先装这三个,安装时一路默认下一步就行。
装完后打开命令行,依次输入下面的命令,能显示版本号就说明装好了。
node -vnpm -vgit -v2. 创建 GitHub 仓库
- 点右上角 + → New repository
- 仓库名填
你的GitHub用户名.github.io,必须严格一致 - 描述可以随便填,比如“我的博客”
- 勾选 Add a README file
- 点 Create repository
3. 配置 SSH 密钥
SSH 用于免密码推送代码到 GitHub,配一次以后都不用输密码。
打开 Git Bash,输入:
ssh-keygen -t rsa -C "你的邮箱"然后连按四次回车。
接着进入 C:\Users\你的用户名\.ssh,用记事本打开 id_rsa.pub,全选复制里面的内容。
回到 GitHub,进入 Settings → SSH and GPG keys → New SSH key,名称随便填,把刚才复制的内容粘贴到 Key 里,保存。
测试一下:
ssh -T git@github.com提示确认时输入 yes,看到 “successfully authenticated” 就说明配好了。
这一步两个博客通用,做完再往下走。
4. 搭建 Astro 博客
如果你用的是现成的 Astro 主题,下载主题压缩包,解压到博客文件夹,然后装依赖就行。不需要执行 npm create astro。
如果你有一定前端基础,想从零开始:
npm create astro@latest # 创建 Astro 项目npm install # 安装依赖npm run dev # 本地启动运行后终端会显示一个本地地址,类似 http://localhost:4321,浏览器打开就能看到效果。
5. 推送到 GitHub
在博客文件夹里右键,选 Git Bash Here,依次执行:
git add . # 添加所有文件git commit -m "初始化博客" # 提交,描述随便填git branch -M main # 把分支名改成 maingit remote add origin git@github.com:你的用户名/你的用户名.github.io.gitgit push -u origin main # 推送到远程等一会儿,访问 你的用户名.github.io 就能看到博客了。
6. 搭建 Hexo 博客
Hexo 的教程网上很多,流程和上面基本一样。区别主要在命令上,可以参考这个视频:Hexo 博客搭建教程。
四、部署到免费平台
GitHub Pages 可以跑,但访问速度一般。推荐部署到 Cloudflare Pages,免费且不限带宽。
Cloudflare Pages
- 登录 Cloudflare
- 进入 Workers & Pages → Create application → Pages → Connect to Git
- 选择你的博客仓库
- 构建设置:
- 构建命令:
pnpm run build(或npm run build) - 输出目录:
dist
- 构建命令:
- 点部署,完成后会给你一个
xxx.pages.dev的域名
其他选择
- Netlify:老牌平台,功能全面,但 2026 年调整了定价,免费版有带宽限制。
- Vercel:适合 Next.js 项目,免费版仅限非商业用途。
- GitHub Pages:最省事,和仓库直接绑定,但国内访问速度一般。
五、写文章用什么工具
博客文章都是 Markdown 格式,.md 后缀。推荐两个编辑器:
- VS Code:免费,插件多,适合一边写一边调格式。
- Typora:所见即所得,写起来更直观,89 元永久授权。
有能力请支持正版。
总结
整个流程其实就四步:装工具 → 配 SSH → 搭框架 → 推送到 GitHub。搭好之后你可以再绑定 Cloudflare Pages,访问速度会更好。
遇到问题优先看命令行报错,大部分错误都有明确提示。实在解决不了,去框架的官方文档或者 GitHub Issues 搜一下,基本都能找到答案。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!













