以下是快速搭建个人博客网站的详细教程,基于 Hexo + GitHub Pages 的免费方案,无需服务器和域名即可快速上线,适合零基础用户。
一、准备工作
-
注册GitHub账号
访问 GitHub官网,注册账号。后续将通过GitHub Pages托管博客。
-
安装Git
- Windows/Mac用户:从Git官网下载安装包,按提示安装。
- 安装完成后,终端输入
git --version
验证是否成功。
-
安装Node.js
- 从Node.js官网下载LTS版本安装包。安装完成后,终端输入
node -v
和npm -v
检查版本。
- 从Node.js官网下载LTS版本安装包。安装完成后,终端输入
二、安装并初始化Hexo
Hexo是一个基于Node.js的静态博客框架,支持Markdown写作,生成速度快。
-
安装Hexo
终端执行以下命令:
bashnpm install -g hexo-cli
-
若因网络问题安装失败,可切换为国内镜像:
bashnpm config set registry https://registry.npm.taobao.org
-
安装成功后,输入
hexo -v
验证。
-
-
初始化博客项目
bashhexo init myblog # 创建名为myblog的文件夹 cd myblog npm install
三、配置博客基本信息
-
修改站点配置
打开
myblog/_config.yml
文件,修改以下字段:yamltitle: 我的博客 # 博客标题 subtitle: 记录技术点滴 # 副标题 author: 你的名字 # 作者名 language: zh-CN # 语言 timezone: Asia/Shanghai # 时区
-
更换主题(可选)
- 从Hexo主题库选择主题(如Butterfly、Next)。
- 终端执行
git clone 主题仓库地址 themes/主题名
,然后在_config.yml
中修改theme: 主题名
。
四、创建并发布文章
-
生成新文章
bashhexo new "我的第一篇博客"
- 文章Markdown文件位于
source/_posts
目录下,可编辑内容并添加Front-matter(如分类、标签)。
- 文章Markdown文件位于
-
本地预览
bashhexo clean && hexo generate # 生成静态文件 hexo server # 启动本地服务
- 访问
http://localhost:4000
查看效果。
- 访问
五、部署到GitHub Pages
-
创建GitHub仓库
- 仓库名必须为
用户名.github.io
(如AI-Green.github.io
),选择Public可见性。
- 仓库名必须为
-
配置Hexo部署插件
-
安装部署插件:
bashnpm install hexo-deployer-git --save
-
修改
_config.yml
文件末尾的部署配置:yamldeploy: type: git repo: [email protected]:用户名/用户名.github.io.git # 替换为你的仓库地址 branch: main # 分支名可能是main或master
-
-
部署到GitHub
bashhexo clean && hexo generate && hexo deploy
- 完成后访问
https://用户名.github.io
即可看到在线博客。
- 完成后访问
六、进阶优化
-
绑定自定义域名
- 在域名服务商(如阿里云)添加CNAME记录指向
用户名.github.io
。 - 在博客的
source
目录下创建CNAME
文件,写入域名(如blog.example.com
),重新部署。
- 在域名服务商(如阿里云)添加CNAME记录指向
-
加速国内访问
- 同步部署到Gitee或Coding Pages,利用国内CDN加速。
-
SEO优化
- 在
_config.yml
中设置关键词(keywords
)。 - 安装
hexo-generator-sitemap
插件生成站点地图。
- 在
常见问题
- 部署失败 :检查SSH密钥是否配置(通过
ssh -T [email protected]
验证)。 - 页面样式异常 :执行
hexo clean
清除缓存后重新生成。 - 文章不显示:确认Markdown文件的Front-matter格式正确。
通过以上步骤,20分钟内即可完成个人博客的搭建。如需更个性化功能(如评论系统、数据分析),可参考Hexo插件库扩展。