主要参考这篇文章如何用Hexo搭建个人博客?
内容有部分有问题&不详细so请参考下文

文中问题纠正&详解

本地blog同步github

进入本地用于放blog的文件夹
右键空白处然后点Git bash here[[什么是bash]]

hexo安装&项目依赖安装

首先运行

1
hexo init #初始化

如果你是想安装 Hexo 项目依赖，那么接下来就应该进入该目录，正确的做法是：

1
npm install #这个命令会根据你项目目录下的 `package.json` 文件安装所有依赖项。

Hexo 默认不带部署功能，必须安装这个插件hexo-deployer-git后，才能使用一键部署

1
npm install hexo-deployer-git --save
  • npm install：使用 Node.js 的包管理器 npm 安装一个依赖包。
  • hexo-deployer-git：这是 Hexo 官方推荐的 Git 部署插件，它让你可以通过 hexo d 命令将博客部署到 GitHub、Gitee 等平台。
  • --save：表示将这个依赖写入 package.json 文件的 dependencies 字段中（在 npm 5 之后其实默认就会保存了，但加上也没问题）。

测试一下, 你现在应该可以使用：

1
2
hexo g   # 生成静态页面
hexo s   # 启动本地服务器

此时开启了本地服务器,端口号默认4000

上线博客

在blog文件夹的config.yml文件中修改最后一行配置
这段配置是 Hexo 部署到 Git 仓库（比如 GitHub Pages）的关键部分：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:

  type: 'git' 
  #表示使用 Git 的方式部署（Hexo 支持多种部署方式，比如 FTP、SFTP、rsync 等）。
  #你需要安装插件：`hexo-deployer-git`，否则这个配置不会生效。
  
  repository:
  #这里应该填写你的 Git 仓库地址，比如：
  #repository: https://github.com/你的用户名/你的仓库名.git
  #如果你用的是 SSH，可以写成：
  #repository: git@github.com:你的用户名/你的仓库名.git

  branch: 'main' #请注意,记得加单引号避免奇奇怪怪的问题
  #指定部署到哪个分支, 默认是部署到 `master` 分支, 可以改一下
  #如果是普通项目仓库，则部署在 `gh-pages` 分支。
✅ 为什么要这样配置？

因为 Hexo 的部署命令 hexo d 会根据 _config.yml 中的 deploy 配置，把生成的静态网页（public 文件夹）推送到你指定的 Git 仓库和分支上，从而实现一键发布博客。

如果你还没填 repository，可以去 GitHub 上复制你的仓库地址粘贴进去。

记得保存

上线博客

如果是第一次使用git的话会需要配置

1
2
git config --global user.email "你的邮箱"
git config --global user.name "你的名字"

使用以下命令

1
2
hexo deploy
# 或简写为 hexo d

来将生成的静态网页推送到你配置好的 Git 仓库（比如 GitHub Pages）。

博客使用

在_config.yml中可以配置博客的一些基础参数，如

1
2
3
4
5
6
7
8
## Site
title: 标题
subtitle: 副标题
description: 描述
keywords: 关键词
author: 站主
language: 语言（可以填写zh-CN）
timezone: 时区（可以填写Asia/Shanghai）
1
2
hexo new [NAME] #在`source/_posts`下新建[NAME].md(NAME可以是中文)
#hexo new 这是一个测试

注意: 路径为source/_posts

上传

1
2
hexo g
hexo d
某些问题
  1. main分支里没有看到文件？
    1. 可能上传到了master分支(默认分支)
    2. 原因:这是因为你本地的 Git 初始化时使用了默认分支名 master，而不是 main。可能是config.yml文件有问题(如没加单引号)
  2. 如何删除/更改名称master分支?
    1. git branch -d master可能运行不了, 因为当前路径就在这个分支下
    2. 使用git branch -m XXX重命名当前分支
相关链接

我目前使用的hexo博客主题是anzhiyu，推荐主题：Butterfly，anzhiyu
大家可以参阅主题文档进行安装配置
有什么问题的话欢迎评论。
本篇下文：Hexo搭建进阶：Vercel部署、主题安装、基础用法
我的Hexo优化系列：Hexo文章目录