不用买服务器、不用花钱，一套工具就能拥有专属自媒体站点，全程跟着操作就行。

一、搭建前必备准备

1. 注册 GitHub 账号，记好账号名 + 注册邮箱，后续推送文章必须用到
2. 电脑安装 Git，安装时勾选把 Git 加入系统环境变量，装好后重启终端
3. 本地装好 Node.js，才能运行 Hexo 全部命令

二、初始化 Hexo 博客项目

建好本地文件夹存放博客源码，终端进入目录执行初始化命令，等待依赖自动安装完成。 安装 Fluid 主题（npm 方式），不用手动拖拽文件到 themes 文件夹，配置文件直接读取 node_modules 内主题资源。

复制主题配置文件

运行这条命令，把主题默认配置复制到博客根目录，后续改样式、改页面只动这份文件： copy node_modules\hexo-theme-fluid\_config.fluid.yml _config.fluid.yml

三、修改站点基础配置

打开根目录_config.yml，拉到最底部填写 GitHub 推送信息，格式不能写错：
（复制以下文本）

deploy:
  type: git
  repo: git@github.com:账号名/账号名.github.io.git
  branch: main

冒号后面一定要加空格，仓库名称必须和你的 GitHub 账号完全一致，少一个字符都会推送失败。

四、解决国内推送 GitHub 报错（高频踩坑点）

1. 生成 SSH 密钥免密登录

终端执行ssh-keygen -t rsa -C "你的GitHub注册邮箱"，全程回车，不用设置密码。 打开C:\Users\电脑用户名\.ssh\id_rsa.pub，完整复制全部文本，粘贴到 GitHub 账号 SSH 密钥设置页保存。

2. 首次连接确认指纹

执行ssh -T git@github.com，弹出验证提示输入yes，出现账号认证成功文字，才算密钥绑定完成。

3. 网络连接重置急救方案

推送时报连接中断，先清空全局代理，切换手机 5G 热点再操作； 每次发布前执行Remove-Item .deploy_git -Recurse -Force，清理旧部署缓存，规避文件冲突。

五、写文章、更新发布完整流程

1. 新建一篇博客文章

终端在博客目录运行命令，引号包裹文章标题（有空格必须加引号）： hexo new "文章标题" 运行后会自动生成 Markdown 文档，存放路径：source/_posts。

2. 编辑文章内容

用记事本 /typora 打开.md文件，顶部配置不用改动，在分隔线下方写正文，写完Ctrl+S 保存。 可自定义标签、文章分类，支持图文、列表、标题等自媒体常用排版格式。

3. 三步发布更新（PowerShell 分开逐条运行）

1. hexo clean：清空旧网页缓存，防止新旧内容错乱
2. hexo g：把 Markdown 文章转换成网页文件
3. hexo d：一键上传全部网页到 GitHub 仓库

终端输出INFO Deploy done: git，代表上传完成，等待 1-3 分钟，打开https://账号名.github.io就能查看更新后的博客。

六、实用小功能

本地提前预览文章效果，不用反复上传 GitHub 测试： 终端运行hexo s，浏览器打开http://localhost:4000，修改文章保存页面会自动刷新。

七、常见报错快速处理

1. Deployer not found: git 缺失推送插件，终端执行npm install hexo-deployer-git --save重装依赖。
2. Repository not found 核对仓库地址拼写，确认 GitHub 已创建同名仓库，SSH 密钥粘贴完整无多余空格换行。
3. Spawn failed Git 未正确配置，先执行git --version验证安装，再补全全局用户名、邮箱配置。

找知识网站 www.zhaozhishi.com 原创的文章欢迎转载
必须注明去处，否则可能追究侵权责任。