部署 Hexo 博客

第一步:安装必备软件 (Node.js 和 Git)

Hexo 是基于 Node.js 的,并且需要 Git 来管理主题和部署。因此,你需要先安装这两个软件。

1. 安装 Node.js:

  • 访问 Node.js 官方网站。

  • 网站会自动推荐适合你操作系统的版本。建议下载 LTS (长期支持版),因为它最稳定。

  • 下载后,双击安装包,按照提示完成安装即可。安装过程中请确保勾选了 “Add to PATH” (添加到环境变量) 的选项。

  • 验证安装: 打开你的终端 (在 Windows 上是cmd PowerShell,在 macOS 上是 Terminal),输入以下命令并回车:

1
2
node -v
npm -v

如果能看到相应的版本号输出,说明 Node.js 和 npm (Node.js 包管理器) 已成功安装。

2. 安装 Git:

  • 访问 Git 官方网站。

  • 网站会自动检测你的操作系统并提供下载链接。

  • 下载后,同样按照安装向导的默认设置完成安装。

  • 验证安装: 在终端中输入以下命令并回车:

1
git --version

如果能看到版本号输出,说明 Git 已成功安装。

第二步:安装 Hexo

当 Node.js 和 Git 都准备好后,你可以使用 npm 来一键安装 Hexo。

1. 打开终端。

####2. 输入以下命令并回车,全局安装 hexo-cli (Hexo 命令行工具):

1
npm install -g hexo-cli

-g 参数表示全局安装,这样你就可以在任何位置使用hexo命令。

验证安装: 输入以下命令并回车:

1
hexo -v

如果能看到 Hexo 的版本信息,说明 Hexo 已经成功安装。

第三步:初始化你的博客

现在,你可以创建一个文件夹来存放你的博客网站的所有文件。

1. 在你想存放博客的地方 (例如,桌面、文档文件夹等) 创建一个新的文件夹。假设我们将其命名为 my-blog

2. 通过终端进入这个新创建的文件夹。例如:

1
2
# 如果文件夹在桌面
cd ~/Desktop

3.使用 Hexo 命令初始化博客:

1
hexo init my-blog

Hexo 会自动在此文件夹内创建所有必需的文件和目录。

4.进入你的博客目录:

1
cd my-blog

5.安装所有依赖包:

1
npm install

这个命令会根据package.json文件下载所有 Hexo 运行所需的插件。

第四步:在本地运行博客

恭喜你!到这里,你的博客已经基本搭建完成了。现在让我们在本地电脑上运行它,看看效果。

1.在你的博客目录 (my-blog) 下,运行以下命令:

1
hexo server

或者使用缩写:

1
hexo s

终端会显示如下信息:

1
2
INFO  Start processing
INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

现在,打开你的浏览器 (如 Chrome, Edge, Safari),访问地址 http://localhost:4000

你应该能看到一个默认主题的 Hexo 博客页面,上面有一篇 “Hello World” 的文章。

第五步:基本使用

你的博客已经在本地运行起来了。以下是两个最常用的命令:

1.创建新文章:

  • 在终端中 (确保仍在 my-blog 目录下),按 Ctrl+C 停止本地服务器。

  • 运行以下命令来创建一篇新文章:

1
hexo new "我的第一篇文章"
  • Hexo 会在source/_posts目录下创建一个名为我的第一篇文章.md的 Markdown 文件。

  • 你可以使用任何文本编辑器 (如 VS Code, Typora) 打开这个.md文件,开始用 Markdown 语法写作。

2.重新生成和预览:

  • 写完文章保存后,需要重新生成静态文件并启动服务器才能预览。

  • 在终端中运行:

1
hexo clean && hexo generate && hexo server

hexo clean: 清除旧的生成文件和缓存。

hexo generate (或 hexo g): 生成最新的静态网页文件。

hexo server (或 hexo s): 启动本地服务器。

刷新浏览器 http://localhost:4000,你就能看到新添加的文章了。

总结和后续步骤

至此,你已经成功在本地部署了 Hexo 博客。

接下来你可以做什么?

  • 修改配置: 打开根目录下的 _config.yml 文件,你可以修改网站标题、作者、语言等基本信息。

  • 更换主题: Hexo 有大量漂亮的主题。你可以去 Hexo 官网主题页 挑选喜欢的主题,并按照主题的说明进行安装和配置。

  • 学习写作: 熟悉 Markdown 语法,开始创作你的内容。

  • 部署到线上: 当你准备好将博客发布到互联网时,可以考虑将其部署到 GitHub Pages (免费)、Vercel、Netlify 或你自己的服务器上。