文档

欢迎阅读 Hexo 文档。如果你在使用 Hexo 时遇到任何问题，请查看 故障排除指南，在 GitHub 上提出问题或在 Google 群组 上开始主题。

¥Welcome to the Hexo documentation. If you encounter any problems when using Hexo, have a look at the troubleshooting guide, raise an issue on GitHub or start a topic on the Google Group.

什么是 Hexo？

¥What is Hexo?

Hexo 是一个快速、简单、功能强大的博客框架。你使用 Markdown（或其他标记语言）撰写帖子，Hexo 会在几秒钟内生成具有漂亮主题的静态文件。

¥Hexo is a fast, simple and powerful blog framework. You write posts in Markdown (or other markup languages) and Hexo generates static files with a beautiful theme in seconds.

安装

¥Installation

只需几分钟即可设置 Hexo。如果你遇到问题并且无法在此处找到解决方案，请 提交 GitHub 问题，我们会为你提供帮助。

¥It only takes a few minutes to set up Hexo. If you encounter a problem and can’t find the solution here, please submit a GitHub issue and we’ll help.

要求

¥Requirements

安装 Hexo 非常简单，只需事先完成以下操作：

¥Installing Hexo is quite easy and only requires the following beforehand:

  • Node.js（至少应为 Node.js 10.13，建议使用 12.0 或更高版本）

    ¥Node.js (Should be at least Node.js 10.13, recommends 12.0 or higher)

  • Git

如果你的计算机已经有这些，恭喜你！你可以跳到 Hexo 安装 步骤。

¥If your computer already has these, congratulations! You can skip to the Hexo installation step.

如果没有，请按照以下说明安装所有必需项。

¥If not, please follow the following instructions to install all the requirements.

安装 Git

¥Install Git

  • Windows：下载并安装 git。

    ¥Windows: Download & install git.

  • Mac：使用 Homebrew、MacPorts 或 installer 安装。

    ¥Mac: Install it with Homebrew, MacPorts or installer.

  • Linux（Ubuntu、Debian）：sudo apt-get install git-core

  • Linux（Fedora、Red Hat、CentOS）：sudo yum install git-core

For Mac users

编译时你可能会遇到一些问题。请先从 App Store 安装 Xcode。安装 Xcode 后，打开 Xcode 并转到“首选项”->“下载”->“命令行工具”->“安装”以安装命令行工具。

¥You may encounter some problems when compiling. Please install Xcode from App Store first. After Xcode is installed, open Xcode and go to Preferences -> Download -> Command Line Tools -> Install to install command line tools.

安装 Node.js

¥Install Node.js

Node.js 为大多数平台提供了 官方安装程序。

¥Node.js provides official installer for most platforms.

替代安装方法：

¥Alternative installation methods:

  • Windows：使用 nvs（推荐）或 nvm 安装。

    ¥Windows: Install it with nvs (recommended) or nvm.

  • Mac：使用 Homebrew 或 MacPorts 安装。

    ¥Mac: Install it with Homebrew or MacPorts.

  • Linux（基于 DEB/RPM）：使用 NodeSource 安装。

    ¥Linux (DEB/RPM-based): Install it with NodeSource.

  • 其他：通过相应的包管理器安装。参考 Node.js 提供的 指南。

    ¥Others: Install it through respective package manager. Refer to the guide provided by Node.js.

还建议在 Mac 和 Linux 上使用 nvs 以避免可能的权限问题。

¥nvs is also recommended for Mac and Linux to avoid possible permission issue.

Windows

如果你使用官方安装程序，请确保选中添加到 PATH（默认情况下选中）。

¥If you use the official installer, make sure Add to PATH is checked (it’s checked by default).

Mac / Linux

如果你在尝试安装 Hexo 时遇到 EACCES 权限错误，请按照 npmjs 提供的 解决方法 进行操作；强烈不建议使用 root/sudo 覆盖。

¥If you encounter EACCES permission error when trying to install Hexo, please follow the workaround provided by npmjs; overriding with root/sudo is highly discouraged.

Linux

如果你使用 Snap 安装了 Node.js，则在 initializing 博客时可能需要在目标文件夹中手动运行 npm install。

¥If you installed Node.js using Snap, you may need to manually run npm install in the target folder when initializing a blog.

安装 Hexo

¥Install Hexo

安装完所有必需项后，你可以使用 npm 安装 Hexo：

¥Once all the requirements are installed, you can install Hexo with npm:

$ npm install -g hexo-cli

高级安装和使用

¥Advanced installation and usage

高级用户可能更喜欢安装和使用 hexo 包。

¥Advanced users may prefer to install and use hexo package instead.

$ npm install hexo

安装后，你可以通过两种方式运行 Hexo：

¥Once installed, you can run Hexo in two ways:

  1. npx hexo <command>

  2. Linux 用户可以设置 node_modules/ 文件夹的相对路径：

    ¥Linux users can set relative path of node_modules/ folder:

echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

然后使用 hexo <command> 运行 Hexo

¥then run Hexo using hexo <command>

所需的 Node.js 版本

¥Required Node.js version

如果你坚持使用较旧的 Node.js，你可以考虑安装过去版本的 Hexo。

¥If you are stuck with older Node.js, you can consider installing a past version of Hexo.

请注意，我们不提供 Hexo 以前版本的错误修复。

¥Please note we do not provide bugfixes to past versions of Hexo.

我们强烈建议尽可能始终安装 Hexo 的 最新版本 和 Node.js 的 推荐版本。

¥We highly recommend to always install the latest version of Hexo and the recommended version of Node.js, whenever possible.

Hexo 版本 最小（Node.js 版本） 小于（Node.js 版本）
7.0+ 14.0.0 latest
6.2+ 12.13.0 latest
6.0+ 12.13.0 18.5.0
5.0+ 10.13.0 12.0.0
4.1 - 4.2 8.10 10.0.0
4.0 8.6 8.10.0
3.3 - 3.9 6.9 8.0.0
3.2 - 3.3 0.12 unknown
3.0 - 3.1 0.10 或 iojs unknown
0.0.1 - 2.8 0.10 unknown