Hexo搭建个人博客

汤晔飞

技术知识脚本

发布于：2021年6月5日

次浏览

本人的博客最终选择了Hexo，原因：

1. 强大的社区，基本什么问题都能查到，网上各种主题模板资料很全，各种QQ群一起high，讨论。
2. 插件功能强大，技术成熟，使用起来很方便，从而封装性很好。
3. 也能使用自动化部署技术GitHubActions或者TravisCi技术,弥补了相对于Jekyll博客能在Github自动部署的缺点。
4. 使用Hexo能让你学习到很多东西。例如git知识、自动化部署等、第三方工具、在线编辑、云等等。

☀Hexo搭建博客(快速上手)

☀hexo安装

1. 执行安装命令：cnpm install -g hexo-cli

2. 验证安装hexo -v。

☀基本命令本地创建博客

hexo init

​ 初始化目录，变为hexo博客目录，内容为hexo基础的框架内容。

cnpm install

​ npm安装可能会失败，使用国内cnpm安装package.json依赖。

hexo s

​ 启动博客

hexo n blogname

创建一篇博客

hexo clean

​ 清理生成的html博客文件，一般生成之前都需要清理。

hexo g

​ hexo根据md文件，生成html博客。

☀将博客部署远端

cnpm install --save hexo-deployer-git

​ 安装hexo的部署依赖包

修改_config.yml deply参数

1
2
3
4

deploy:
	type:git
	repo:仓库地址
	branch:master

1
2
3
4
5
6
7

deploy:
  type: 'git'
  repo:
    github:
      url: https://github.com/aner1001/blog3.git
      branch: gh-pages
      token: $HEXO-GITHUB-TOKEN					#读取系统中的环境变量

hexo d

​ 执行命令，将本地生成好的博客部署到远端。

☀更换主题

yilia主题为例：

$ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

​ 将博客克隆到当前blog博客目录下的，themes主题文件夹，yilia文件夹下。

修改_config.yml theme参数

1

theme:yilia

hexo clean

​ 重新清理博客。

hexo g

​ 重新生成博客。

hexo d

​ 重新发布博客。

☀根目录设置

如果博客并非部署在端口号对应的根目录下。则需要修改博客部署的根目录，所有文件都是基于这个根目录访问。

本地启动时，会在端口号后拼接上根目录的路径。

这样就可已解决，万一博客不是在服务器根目录造成的问题。

☀Hexo配置_config.yml

☀参数纪要

记录一些个人认为比较有用的参数，详细参数文档请看Hexo官方参数文档

☀#site网站参数

☀#URL网址参数

☀#Directory目录参数

1
2
3
4
5

skip_render: "mypage/**/*"
# 将会直接将 `source/mypage/index.html` 和 `source/mypage/code.js` 不做改动地输出到 'public' 目录
# 你也可以用这种方法来跳过对指定文章文件的渲染
skip_render: "_posts/test-post.md"
# 这将会忽略对 'test-post.md' 的渲染

☀#Writing写作文章的参数

☀#Date / Time format日期格式参数

updated_option

updated_option 控制了当 Front Matter 中没有指定 updated 时，updated 如何取值：

• mtime: 使用文件的最后修改时间。这是从 Hexo 3.0.0 开始的默认行为。
• date: 使用 date 作为 updated 的值。可被用于 Git 工作流之中，因为使用 Git 管理站点时，文件的最后修改日期常常会发生改变。在 Git 工作流中这个选项会很有用 。
• empty: 直接删除 updated。使用这一选项可能会导致大部分主题和插件无法正常工作。

☀#Extensions/Plugins/Themes/Deployment主题，拓展，发布等参数

☀#包括或不包括目录和文件# Include / Exclude file(s)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# Include/Exclude Files/Folders
include:
  - ".nojekyll"
  # 包括 'source/css/_typing.css'
  - "css/_typing.css"
  # 包括 'source/_css/' 中的任何文件，但不包括子目录及其其中的文件。
  - "_css/*"
  # 包含 'source/_css/' 中的任何文件和子目录下的任何文件
  - "_css/**/*"

exclude:
  # 不包括 'source/js/test.js'
  - "js/test.js"
  # 不包括 'source/js/' 中的文件、但包括子目录下的所有目录和文件
  - "js/*"
  # 不包括 'source/js/' 中的文件和子目录下的任何文件
  - "js/**/*"
  # 不包括 'source/js/' 目录下的所有文件名以 'test' 开头的文件，但包括其它文件和子目录下的单文件
  - "js/test*"
  # 不包括 'source/js/' 及其子目录中任何以 'test' 开头的文件
  - "js/**/test*"
  # 不要用 exclude 来忽略 'source/_posts/' 中的文件。你应该使用 'skip_render'，或者在要忽略的文件的文件名之前加一个下划线 '_'
  # 在这里配置一个 - "_posts/hello-world.md" 是没有用的。

ignore:
  # Ignore any folder named 'foo'.
  - "**/foo"
  # Ignore 'foo' folder in 'themes/' only.
  - "**/themes/*/foo"
  # Same as above, but applies to every subfolders of 'themes/'.
  - "**/themes/**/foo"

列表中的每一项都必须用单引号或双引号包裹起来。

include 和 exclude 并不适用于 themes/ 目录下的文件。如果需要忽略 themes/ 目录下的部分文件或文件夹，可以使用 ignore 或在文件名之前添加下划线 _。

☀#永久链接（Permalinks）

您可以在 _config.yml 配置中调整网站的永久链接或者在每篇文章的 Front-matter 中指定。

☀变量

除了下列变量外，您还可使用 Front-matter 中的所有属性。

您可在 permalink_defaults 参数下调整永久链接中各变量的默认值：

1
2

permalink_defaults:
  lang: en

示例

1
2
3
4
5

source/_posts/hello-world.mdtitle: Hello World
date: 2013-07-14 17:01:34
categories:
- foo
- bar

1
2
3
4
5

source/_posts/lorem/hello-world.mdtitle: Hello World
date: 2013-07-14 17:01:34
categories:
- foo
- bar

☀多语种支持

若要建立一个多语种的网站，您可修改 new_post_name 和 permalink 参数，如下：

1
2

new_post_name: :lang/:title.md
permalink: :lang/:title/

当您建立新文章时，文章会被储存到：

1
2

$ hexo new "Hello World" --lang tw
# => source/_posts/tw/Hello-World.md

而网址会是：

1

http://localhost:4000/tw/hello-world/

☀配置文件合并原理

☀使用代替配置文件

可以在 hexo-cli 中使用 --config 参数来指定自定义配置文件的路径。你可以使用一个 YAML 或 JSON 文件的路径，也可以使用逗号分隔（无空格）的多个 YAML 或 JSON 文件的路径。例如：

1
2
3
4
5

# use 'custom.yml' in place of '_config.yml'
$ hexo server --config custom.yml

# use 'custom.yml' & 'custom2.json', prioritizing 'custom3.yml', then 'custom2.json'
$ hexo generate --config custom.yml,custom2.json,custom3.yml

当你指定了多个配置文件以后，Hexo 会按顺序将这部分配置文件合并成一个 _multiconfig.yml。如果遇到重复的配置，排在后面的文件的配置会覆盖排在前面的文件的配置。这个原则适用于任意数量、任意深度的 YAML 和 JSON 文件。

例如，使用 --options 指定了两个自定义配置文件：

1

$ hexo generate --config custom.yml,custom2.json

如果 custom.yml 中指定了 foo: bar，在 custom2.json 中指定了 "foo": "dinosaur"，那么在 _multiconfig.yml 中你会得到 foo: dinosaur。

♣注：一般直接使用hexo根目录下的_config.yml。

☀使用代替主题配置文件

通常情况下，Hexo 主题是一个独立的项目，并拥有一个独立的 _config.yml 配置文件。

除了自行维护独立的主题配置文件，你也可以在其它地方对主题进行配置。

配置文件中的 theme_config

该特性自 Hexo 2.8.2 起提供

1
2
3
4
5
6
7
8
9
10
11

# _config.yml
theme: "my-theme"
theme_config:
  bio: "My awesome bio"
  foo:
    bar: 'a'
# themes/my-theme/_config.yml
bio: "Some generic bio"
logo: "a-cool-image.png"
  foo:
    baz: 'b'

最终主题配置的输出是：

1
2
3
4
5
6
7
8

{
  bio: "My awesome bio",
  logo: "a-cool-image.png",
  foo: {
    bar: "a",
    baz: "b"
  }
}

独立的 _config.[theme].yml 文件

该特性自 Hexo 5.0.0 起提供

独立的主题配置文件应放置于站点根目录下，支持 yml 或 json 格式。需要配置站点 _config.yml 文件中的 theme 以供 Hexo 寻找 _config.[theme].yml 文件。

1
2
3
4
5
6
7
8
9
10
11

# _config.yml
theme: "my-theme"
# _config.my-theme.yml
bio: "My awesome bio"
foo:
  bar: 'a'
# themes/my-theme/_config.yml
bio: "Some generic bio"
logo: "a-cool-image.png"
  foo:
    baz: 'b'

最终主题配置的输出是：

1
2
3
4
5
6
7
8

{
  bio: "My awesome bio",
  logo: "a-cool-image.png",
  foo: {
    bar: "a",
    baz: "b"
  }
}

我们强烈建议你将所有的主题配置集中在一处。如果你不得不在多处配置你的主题，那么这些信息对你将会非常有用：Hexo 在合并主题配置时，Hexo 配置文件中的 theme_config 的优先级最高，其次是 _config.[theme].yml 文件，最后是位于主题目录下的 _config.yml 文件。

♣注：针对主题的配置，基本上直接新建使用hexo根目录下_config.[theme].yml，统一处理。不修改主题，目录下的_config.yml

☀Hexo命令

♣注：一定要先写关键字主命令后再写参数。

☀init

1

$ hexo init [folder]

1

$ hexo init

新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。

☀new

1

$ hexo new [layout] <title>

新建一篇文章。如果没有设置 layout 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来。

1

$ hexo new "post title with whitespace"

默认情况下，Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说，Hexo 会创建一个以标题为名字的目录，并在目录中放置一个 index.md 文件。你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录：

1

hexo new page --path about/me "About me"

以上命令会创建一个 source/about/me.md 文件，同时 Front Matter 中的 title 为 "About me"

注意：指定目录后，文件名会以最后一层目录下的名称me作为文件名。

♠个人心得:为何要这样生成？md文件最后渲染的就是一个md文件名称的目录，其中有个index.html。

注意！title 是必须指定的！如果你这么做并不能达到你的目的：

1

hexo new page --path about/me

此时 Hexo 会创建 source/_posts/about/me.md，同时 me.md 的 Front Matter 中的 title 为 "page"。这是因为在上述命令中，hexo-cli 将 page 视为指定文章的标题、并采用默认的 layout。

注意：如果标题中有特殊字符如[],必须带上’'符号括起来.

☀generate

生成静态文件。

1
2
3

$ hexo generate
#简写为
$ hexo g

☀publish

1

$ hexo publish [layout] <filename>

发表草稿。经过测试目前只能将darft目录下的文件添加到_post文件夹下。不支持子目录添加操作。

☀server

1
2
3

$ hexo server
#简写为
$ hexo s

启动服务器。默认情况下，访问网址为： http://localhost:4000/。

服务启动后，文章中内容是实时渲染的。一旦改动立马会生效。不会使用静态public中generate生成后的文件。

☀deploy

1
2
3

$ hexo deploy
#简写为
$ hexo d

部署网站。

☀render

1

$ hexo render <file1> [file2] ...

file需要指明目录。路径默认在的执行此命令的blog根目录中。

例：hexo render source\_posts\about\me.md -o data

渲染文件。

☀clean

1

$ hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。

在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

☀list

1

$ hexo list <type>

列出网站资料，已经存在的文件等。

☀version

1
2
3

$ hexo version
#简写为
$ hexo v

显示 Hexo 版本。

☀基本的操作

☀创建文章

你可以执行下列命令来创建一篇新文章或者新的页面。

1

$ hexo new [layout] <title>

您可以在命令中指定文章的布局（layout），默认为 post，可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。

☀布局（Layout）

Hexo 有三种默认布局：post、page 和 draft。在创建者三种不同类型的文件时，它们将会被保存到不同的路径；而您自定义的其他布局和 post 相同，都将储存到 source/_posts 文件夹。对应Scaffold文件夹中的post

.md、page.md、draft.md。

Disabling layout

If you don’t want an article (post/page) to be processed with a theme, set layout: false in its front-matter. Refer to this section for more details.

☀自定义模版（Scaffold）

在新建文章时，Hexo 会根据 scaffolds 文件夹内相对应的文件来建立文件，例如：

1

$ hexo new photo "My Gallery"

在执行这行指令时，Hexo 会尝试在 scaffolds 文件夹中寻找 photo.md，并根据其内容建立文章，模版中使用的变量列举：

☀文件名称

Hexo 默认以标题做为文件名称，但您可编辑 new_post_name 参数来改变默认的文件名称，举例来说，设为 :year-:month-:day-:title.md 可让您更方便的通过日期来管理文章。

☀写作

☀写作语言格式

不仅可以用 Markdown 写作，你还可以用 EJS 写作。甚至可以用 Pug 模板语言书写文章。需要渲染插件的支持，hexo-renderer-marked 和 hexo-renderer-ejs默认已安装。hexo-renderer-pug安装后可渲染Pug。

☀Front-matter文章前提

Front-matter 是文件最上方以 --- 分隔的区域，用于指定个别文件的变量，举例来说：

1
2
3
4

---
title: Hello World
date: 2013/7/13 20:46:25
---

以下是预先定义的参数，您可在模板中使用这些参数值并加以利用。

☀分类和标签

只有文章支持分类和标签，您可以在 Front-matter 中设置。在其他系统中，分类和标签听起来很接近，但是在 Hexo 中两者有着明显的差别：分类具有顺序性和层次性，也就是说 Foo, Bar 不等于 Bar, Foo；而标签没有顺序和层次。

1
2
3
4
5

categories:
- Diary
tags:
- PS3
- Games

分类方法的分歧

如果您有过使用 WordPress 的经验，就很容易误解 Hexo 的分类方式。WordPress 支持对一篇文章设置多个分类，而且这些分类可以是同级的，也可以是父子分类。但是 Hexo 不支持指定多个同级分类。下面的指定方法：

1 2 3

categories: - Diary - Life

会使分类Life成为Diary的子分类，而不是并列分类。因此，有必要为您的文章选择尽可能准确的分类。

如果你需要为文章添加多个分类，可以尝试以下 list 中的方法。

1 2 3 4

categories: - [Diary, PlayStation] - [Diary, Games] - [Life]

此时这篇文章同时包括三个分类： PlayStation 和 Games 分别都是父分类 Diary 的子分类，同时 Life 是一个没有子分类的分类。

☀引入资源文件

资源（Asset）代表 source 文件夹中除了文章以外的所有文件，例如图片、CSS、JS 文件等。比方说，如果你的Hexo项目中只有少量图片，那最简单的方法就是将它们放在 source/images 文件夹中。然后通过类似于 ![](/images/image.jpg) 的方法访问它们。

♣注：引入图片资源最好的解决方案就是使用图床。下方的方案可以参考，更加了解Hexo。

对于那些想要更有规律地提供图片和其他资源以及想要将他们的资源分布在各个文章上的人来说，Hexo也提供了更组织化的方式来管理资源。这个稍微有些复杂但是管理资源非常方便的功能可以通过将 config.yml 文件中的 post_asset_folder 选项设为 true 来打开。

1

post_asset_folder: true

当资源文件管理功能打开后，Hexo将会在你每一次通过 hexo new [layout] <title> 命令创建新文章时自动创建一个文件夹。这个资源文件夹将会有与这个文章文件一样的名字。将所有与你的文章有关的资源放在这个关联文件夹中之后，你可以通过相对路径来引用它们，这样你就得到了一个更简单而且方便得多的工作流。

由于md文件最终渲染后生成的index.html，最终会放到md文件名称的文件夹中。所以md中引入路径需要写成：![](example.jpg)

但是这样写，如果文章显示在首页，则图片在首页中不会显示出。

解决方案：

​ ❀使用标签插件
​

​ ❀使用Hexo3.1.0新增的插件渲染配置.

_config.yml

1
2
3
4

post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true

☀引入数据文件

有时您可能需要在主题中使用某些资料，而这些资料并不在文章内，并且是需要重复使用的，那么您可以考虑使用 Hexo 3.0 新增的「数据文件」功能。此功能会载入 source/_data 内的 YAML 或 JSON 文件，如此一来您便能在网站中复用这些文件了。

举例来说，在 source/_data 文件夹中新建 menu.yml 文件：

1
2
3

Home: /
Gallery: /gallery/
Archives: /archives/

您就能在模板中使用这些资料：

1
2
3

<% for (var link in site.data.menu) { %>
  <a href="<%= site.data.menu[link] %>"> <%= link %> </a>
<% } %>

渲染结果如下 :

1
2
3

<a href="/"> Home </a>
<a href="/gallery/"> Gallery </a>
<a href="/archives/"> Archives </a>

☀部署

Hexo 提供了快速方便的一键部署功能，让您只需一条命令就能将网站部署到服务器上。

1

$ hexo deploy

在开始之前，您必须先在 _config.yml 中修改参数，一个正确的部署配置中至少要有 type 参数.
例如：使用git工具部署

1
2

deploy:
  type: git

可以使用支持多个平台同时部署

1
2
3
4
5
6
7
8
9
10
11
12

deploy:
  type: 'git'
  repo:
    github:
      url:
      branch: gh-pages
      token: $HEXO_GITHUB_TOKEN
    coding:
      url:
      branch: gh-pages
      token: $HEXO_CODING_TOKEN

您可同时使用多个 deployer工具，Hexo 会依照顺序执行每个 deployer。

1
2
3
4
5

deploy:
- type: git
  repo:
- type: heroku
  repo:

☀Git工具部署

1. 安装 hexo-deployer-git。

1

$ npm install hexo-deployer-git --save

1. 修改配置。

1
2
3
4
5
6

deploy:
  type: git
  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
  branch: [branch]
  message: [message]
  token: [token]  #一般配置在环境变量中。

1. 生成站点文件并推送至远程库。执行

   1	hexo clean && hexo deploy

   • You will be prompted with username and password of the target repository, unless you authenticate with a token or ssh key.
   • hexo-deployer-git does not store your username and password. Use git-credential-cache to store them temporarily.

2. 登入 Github/BitBucket/Gitlab，请在库设置（Repository Settings）中将默认分支设置为_config.yml配置中的分支名称。稍等片刻，您的站点就会显示在您的Github Pages中。

这一切是如何发生的？

当执行 hexo deploy 时，Hexo 会将 public 目录中的文件和目录推送至 _config.yml 中指定的远端仓库和分支中，并且完全覆盖该分支下的已有内容。

☀自动化部署

☀[Travis CI]

☀介绍

编写代码只是软件开发的一小部分，更多的时间往往花在构建（build）和测试（test）。

为了提高软件开发的效率，构建和测试的自动化工具层出不穷。Travis CI 就是这类工具之中，市场份额最大的一个。

用好这个工具不仅可以提高效率，还能使开发流程更可靠和专业化，从而提高软件的价值。而且，它对于开源项目是免费的，不花一分钱，就能帮你做掉很多事情。

什么是持续集成？
Travis CI 提供的是持续集成服务（Continuous Integration，简称 CI）。它绑定 Github 上面的项目，只要有新的代码，就会自动抓取。然后，提供一个运行环境，执行测试，完成构建，还能部署到服务器。

持续集成指的是只要代码有变更，就自动运行构建和测试，反馈运行结果。确保符合预期以后，再将新代码"集成"到主干。

持续集成的好处在于，每次代码的小幅变更，就能看到运行结果，从而不断累积小的变更，而不是在开发周期结束时，一下子合并一大块代码。

☀部署步骤

1. 创建博客源码仓库和静态文件仓库。
2. github创建token，权限为repo。
3. 前往 Travis CI 使用 GitHub 账户登录并赋权。
4. Travis CI中前往你的 博客源码仓库repository 的设置页面，在 Environment Variables 下新建一个环境变量，Name 为 GITHUB_TOKEN，Value 为刚才你在 GitHub 生成的 Token。确保 DISPLAY VALUE IN BUILD LOG 保持 不被勾选 避免你的 Token 泄漏。点击 Add 保存。
5. 在你的 Hexo 站点文件夹中新建一个 .travis.yml 文件：gistLink.
6. 接下来每次提交博客源码仓库，都会被Travis CI监控到。执行脚本，部署到静态文件仓库中。

☀[GitHub Actions]

☀介绍

大家知道，持续集成由很多操作组成，比如抓取代码、运行测试、登录远程服务器，发布到第三方服务等等。GitHub 把这些操作就称为 actions。

很多操作在不同项目里面是类似的，完全可以共享。GitHub 注意到了这一点，想出了一个很妙的点子，允许开发者把每个操作写成独立的脚本文件，存放到代码仓库，使得其他开发者可以引用。

如果你需要某个 action，不必自己写复杂的脚本，直接引用他人写好的 action 即可，整个持续集成过程，就变成了一个 actions 的组合。这就是 GitHub Actions 最特别的地方。

GitHub 做了一个官方市场，可以搜索到他人提交的 actions。另外，还有一个 awesome actions 的仓库，也可以找到不少 action。

☀部署步骤

1. 创建博客源码仓库和静态文件仓库。
2. github创建token，权限为repo。
3. 在博客源码仓库中创建隐私资料,settings->secrets,将创建的token存入。不等同于Travis中的配置。区别：secrets中的变量需要在脚本配置中再引入。Travis中配置的，直接就是环境变量直接可以使用。
4. 在博客源码仓库中创建Actions，并配置。参考Gist。实际生成.github/workflow/xxx.yml配置文件。
5. 每次提交博客源码仓库，都会被Actions监控，执行部署脚本。

☀好看的博客收藏

☀Volantis主题

注意：

使用hexo-filter-github-emojis 插件会使gulp压缩报错，不能用这个插件。

使用emojis插件个人推荐：markdown-it-emoji，好看简洁又好用。重点和Typroa渲染一模一样。

☀问题解决

☀1.YAMLException: can not read a block mapping entry; a multiline key may not be an implicit key at …

原因是在博客头文件时，键值对格式需要有空格。

☀2.ExperimentalWarning: The fs.promises API is experimental

根本原因是node的版本不是最新的，而在项目引入的模块是最新的，node.js的版本低于模块的版本：

解决方法是升级npm,node.js：

☀3.Warning: Accessing non-existent property ‘lineno’ of module exports inside circular dependency

出现这些是因为node版本太高，切换成低版本的node来安装Hexo就可以了

☀4.Travis CI日志push失败src refspec master does not match any

原因：tarvis ci配置文件中，commit的说明中带有中文，导致TravisCI环境中中文变为空字符串。提交报错，最终导致无法提交远程仓库。

配置文件中带有中文：

TravisCi环境中提交时，变为了空字符串，提交失败。
日志报文信息:

☀5.extends includes/layout.pug block content include ./includes/mixins/post-ui.pug #recent-posts.recent-posts +postUI include includes/pagination.pug

解决执行：

1

npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive

hexo clean

hexo g

hexo s

☀6.err: Error [Nunjucks Error]: gallery/index.md [Line 2, Column 4] unknown block tag: galleryGroup

☀7.Git提交时提示‘The file will have its original line endings in your working directory’

原来是Git默认配置替换回车换行成统一的CRLF，我们只需要修改配置禁用该功能即可。

Gitshell中输入如下命令解决：

git config --global core.autocrlf false

☀8.PWA启动err: TypeError: Cannot read property ‘data’ of undefined

原因是hexo版本过高导致。

☀9. heox部署Warning: Accessing non-existent property ‘column’ of module

出现这些是因为node版本太高，切换成低版本的node来安装Hexo就可以了

我原先是安装了最新版node14.0，后来多装了一个比较稳定的node12.14版本，这个问题就解决了

☀10.cnpm安装过程中提示optional install error: Package require os(darwin) not compatible with your platform

sass loader出问题的

解决方法：cnpm rebuild node-sass —经过尝试不一定行。😢

😄

☀11.刚下载下来的Hexo工程，hexo g报错，无法编译。unknown block tag: btn

原因是:子工程主题模块没有下载。

解决办法：

1.git submodule update --init --recursive 下载子工程

2.git clone 父工程地址 --recursive #在克隆父工程时，直接使用递归命令

☀参考文献

nodejs环境搭建之搭建nvm(node版本管理)

NodeJS入门（一）—nodejs详细安装步骤

npm基本命令

npm install 本地安装与全局安装的区别

YAMLException: can not read a block mapping entry; a multiline key may not be an implicit key at …

npm install 、npm install --save 和 npm install --save-dev的区别

[馨客栈分享]使用travis CI自动部署hexo博客到Github并且在Github pages上展示页面

通过travis-ci或者GitHub Actions自动化部署GitHub Pages和Coding Pages

持续集成服务 Travis CI 教程

GitHub Actions 入门教程

更新于：2021年6月5日

Hexo

Nodejs