如何用GitHub和Hexo搭建个人博客

基础环境部署

Node.js 安装

• 官网 https://nodejs.org/en/download 下载对应的版本安装

• 检查 Node.js 环境是否成功安装（有版本显示即成功安装）
  打开 cmd

  node -v
  npm -v

Git 安装

• 官网：https://git-scm.com/downloads 下载对应的版本安装

• 检查 Git 是否成功安装（有版本显示即成功安装）
  鼠标桌面右击选择 Git bash here 打开，输入：

  git --version

Hexo 安装

• 在 blog 文件夹下，鼠标右击选择 Git bash here ，依次执行以下命令：

  npm install hexo-cli
  npm install hexo --save

• 检查 Git 是否成功安装（有版本显示即成功安装）

  hexo -v

• 初始化 Hexo ，需要将 blog 文件夹下的文件清空，不然会报错
  输入以下命令：

  hexo init
  npm install

• 生成 Hexo 页面

  hexo generate
  hexo g  # 简写

• 启动 Hexo 服务（本地服务）

  hexo server
  hexo s  # 简写

  启动后，打开浏览器输入网址 http://localhost:4000

恭喜你，成功在本地部署了 Hexo ！！！

Hexo 部署到 GitHub

注册 GitHub 账号

• 官网 https://github.com 注册账号

新建项目

• 项目名称为：username.github.io 仓库设置为 public
• 稍等一会就可以通过 https://username.github.io 进行访问了

推送代码

• Github 推送代码目前已经不支持账号密码方式，所以需要开启 ssh 密钥直接推送

  git config --global user.name "XXX"              # 配置个人信息-username
  git config --global user.email "XXX@XXX.com"     # 配置个人信息-useremail
  ssh-keygen -t rsa -C "XXX@XXX.com"               # 生成密钥

• 给 git 用户添加 ssh 秘钥（找到本地的 ssh 公钥，以 .pub 结尾，我的是C:\Users\用户名.ssh\id_rsa.pub）并整个复制。然后在 Github 中添加 id_rsa.pub 文件中的内容

• 输入 ssh -T git@github.com ，测试添加 ssh 是否成功。如果看到 Hi 后面是你的用户名，就说明成功了（有一个会让你输入 yes）

部署 Hexo

• 打开 Hexo 的配置文件 _config.yml 修改 deploy 位置的配置

  deploy:
    type: git
    repo: git@github.com:XXX/XXX.github.io.git  # 仓库地址
    branch: main  # 分支!!! 是 main

• 使用 Hexo deploy 部署到 Github
  安装Git部署插件:

  npm install hexo-deployer-git --save

• Hexo 一键三连：

  hexo cl && hexo g && hexo d  # cl 是 clean 的简写

恭喜你，成功在 GitHub 上部署了 Hexo ！！！
此时就可以通过 https://username.github.io 进行访问你的博客了