从零开始的 Hexo 生活（一）入门安装篇

目录

• 前言
• 一、Hexo 是什么
  • 1.什么是静态网站
  • 2.为什么选择静态网站
  • 3.为什么选择 Hexo
• 二、Markdown 是什么
  • 1.为什么要学 Markdown
  • 2.怎么学 Markdown
• 三、如何使用 Hexo
  • 1.前期准备
  • 2.安装 Node.js
  • 3.安装 Git
  • 4.安装 Hexo
  • 5.初始化网站
  • 6.本地测试

前言

Hexo 作为一款静态博客网站框架，是新手搭建属于自己的博客网站的不二之选。但是如果你只是按照相关教程快速地完成了一个网站的搭建，搭建完成时获得的成就感很快就会消散。了解搭建过程中的相关知识和原理，并用于提升自己的知识储备，才能让这种获得感长久，这篇文章的意义就在于此。

本文首发于 正切橙的博客，更多详细信息请点击 这里，转载请注明出处。

---

一、Hexo 是什么

Hexo 是一款基于 Node.js 的静态博客网站框架，依赖少且易于安装使用，可以很方便并且快速地生成静态网页，然后托管在 GitHub Pages、Netlify 和 Vercel 等上搭建个人博客网站。Hexo 的作者来自台湾，对于中文的支持很好，阅读相关文档也很方便。

Hexo 中文官网

1.什么是静态网站

既然有静态网站，与之相对的也有动态网站。静态网站往往没有数据库和后台，网站代码一经发布到网站服务器上后内容便不可修改，只能通过重新长传更改后的网站代码来更新网站。而动态网站不同，它可以根据用户的要求和选择而动态地改变网页内容，并且自动更新网站，还能通过后台实时监控网站的情况并作出响应。

2.为什么选择静态网站

动态网站的交互性和功能都很强大，但是搭建的过程很复杂，需要有一定的代码基础，还要了解数据库等相关知识，它往往是一些公司和企业的官网。对于只想搭建博客网站的个人来说，学习成本太高，所以选择静态网站，它上手简单，对于个人网站来说绰绰有余，同时维护成本也很低。

3.为什么选择 Hexo

虽然搭建静态网站相对于动态网站已经简单很多，但是还是要有 html、css 和 js 等前端开发的基础，而 Hexo 的出现又降低门槛，它可以把写好的 Markdown 文档渲染生成网页，你要做的只是配置好 Hexo 就行了。

和 Hexo 类似的工具还有 Jekyll 和 Hugo ，jekyll 是 GitHub 的亲儿子，而 Hugo 是采用 Go 语言编写的，但是从使用人数和博客主题数量来看，Hexo 更胜一筹，网上关于 Hexo 的介绍也更多，遇到问题也更好解决。

二、Markdown 是什么

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML（或 HTML）文档，简单来说，就是以 Markdown 格式编写的文档（.md 结尾）可以在特定工具下转换为 XHTML（或 HTML，即 .html 结尾）的文档，从而简化写复杂的 XHTML（或 HTML） 代码过程。

1.为什么要学 Markdown

你在 Hexo 上写的所有文章都是 Markdown 格式的，Hexo 可以把你写的这些 Markdown 文档（.md 结尾）批量转换成 XHTML（或 HTML，即 .html 结尾）的文档，然后渲染组成页面，再把页面组织构成网站。

2.怎么学 Markdown

Markdown 作为轻量级标记语言，学习起来难度较小，了解 Markdown 基本语法后多写写就能熟练掌握，可以查看 菜鸟教程 或者 马克飞象 的例子，网上其他的相关教程也很多，就不一一列举了。当你熟悉之后，进阶的话可以在 Markdown 文档中插入 HTML 语句实现更多功能和样式。

Markdown 编辑器的话使用 VSCode 或者 Typora、MarkText 等都行，甚至记事本也行（不过无法预览）。

三、如何使用 Hexo

1.前期准备

• Node.js
• npm
• Git

以前 js 只能运行在浏览器中，Node.js 出现之后，不管是服务器上，还是我们自己的的笔记本上，只要安装了 Node.js 就可以运行 js 代码。

Node.js 中文官网

npm 的全称是 Node Package Manager，是一个 Node.js 的包管理和分发工具，可以使用它安装和管理官方以及别人开发好的模块，并应用到你的项目中。

npm 官网

Git 是一个分布式的版本控制软件，用于记录某个项目中各种文件内容的变动。 而 GitHub 是一个基于 Git 的远程文件托管平台，你可以在上面建立仓库存储你的项目，并且通过 Git 记录你的项目内容变动。

Git 官网

2.安装 Node.js

打开 Node.js 官网，找到 下载，选择 长期维护版 下载，下载完成后双击下载的 .msi 文件进行安装，可以更改安装位置到其他盘，其他选项默认即可，Node.js 安装完成后自带 npm

安装完成后，在 cmd、powershell 或者 Windows Terminal 等终端中输入

node -v

如果输出版本号即为安装成功

也可以查看 npm 版本

npm -v

3.安装 Git

打开 Git 官网，找到 Latest source Release，点击 Download for Windows，下载 64-bit 的版本，下载完成后，双击进行安装，安装时的勾选默认即可（Git 老玩家的话按自己需求选择）。

Git 在记录项目内容修改时，可以附加修改者的姓名和邮箱信息，这需要自己设定。安装完成后，在桌面右键呼出菜单，选择 Git Bash Here，输入

git config --global user.name "yourname"

git config --global user.email "youremail@xxx.com"

查看修改后的用户信息

git config --list

4.安装 Hexo

查看 Hexo 中文官网 发现，只需要一个命令就可以安装 Hexo，它是通过 npm 安装的

由于 npm 的源服务器在国外，速度慢，可以使用 阿里云 npm 镜像站，终端输入

npm config set registry https://registry.npmmirror.com

查看换源是否成功

npm config get registry

镜像源配置好就可以安装 Hexo 了，输入

npm install hexo-cli -g

-g 表示全局安装某模块，会写入环境变量，可以在终端直接输入该模块的指令进行相应操作，不加则会安装在终端打开文件夹的 node_modules 目录中，只在当前项目中使用

验证安装是否成功

hexo -v

输出版本号和其他基本信息即表明安装成功

5.初始化网站

可以查看 Hexo 官方文档 或者看我下面的介绍

任选位置新建一个空文件夹，初始化该文件夹

hexo init

按住 Shift 不放并右击此文件夹，选择 在此处打开 Powershell 窗口 可以打开 powershell，或者进入这个空文件夹，在地址栏输入 cmd 可以打开 cmd

等待完成，然后更新 npm 包的依赖

npm install

6.本地测试

Hexo 初始化完成后会有一个默认主题 landscape

依次输入以下指令，在本地运行

hexo clean
# 清除缓存，可用简略写法 hexo cl
hexo generate
# 生成静态页面，可用简略写法 hexo g
hexo server
# 本地运行，可用简略写法 hexo s

按住 Ctrl 并点击终端输出的 http://localhost:4000 链接可以跳转浏览器打开测试页面，或者在浏览器地址栏输入 http://localhost:4000 也可以打开测试页面

4000 表示本地端口号为 4000，也可以使用 -p 参数指定端口，例如：hexo s -p 8080 表示在 8080 端口测试

在终端按 Ctrl 加 C 可以中止运行

如果已经熟练 Hexo 的话，可以只使用一条测试运行指令

• cmd

hexo cl && hexo g && hexo s

• powershell

hexo cl ; hexo g ; hexo s

---

从零开始的 Hexo 生活（二）主题配置篇

更新中 ······

---