欢迎使用 Hexo，Hexo 是一个快速、简洁且高效的博客框架。本文档将帮助您快速上手。
欢迎使用 Hexo，本文档将帮助您快速上手。 如果您在使用过程中遇到问题，请查看 问题解答 中的解答，或者在 GitHub、Google Group 上提问。
什么是 Hexo？
Hexo 是一个快速、简洁且高效的博客框架。 Hexo 使用 Markdown（或其他标记语言）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。
安装
设置 Hexo 只需几分钟。 如果您遇到问题，并且在这里找不到解决方案，请提交 GitHub 问题，我们将提供帮助。
要求
安装 Hexo 相当简单，只需要先安装下列应用程序即可：
如果您的电脑中已经安装上述必备程序，那么恭喜您！ 你可以直接前往 安装 Hexo 步骤。
如果您的电脑中尚未安装所需要的程序，请根据以下安装指示完成安装。
安装 Git
- Windows：下载并安装 git。
- Mac：使用 Homebrew, MacPorts 或者下载 安装程序。
- Linux (Ubuntu, Debian)：
sudo apt-get install git-core - Linux (Fedora, Red Hat, CentOS)：
sudo yum install git-core
注意： Mac 用户在编译时可能会遇到问题。 请先到 App Store 安装 Xcode。 Xcode 完成后，启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。
安装 Node.js
Node.js 为大多数平台提供了官方的 安装程序。
其它的安装方法：
- Windows：通过 nvs（推荐）或者 nvm 安装。
- Mac：使用 Homebrew 或 MacPorts 安装。
- Linux（DEB/RPM-based）：从 NodeSource 安装。
- 其它：使用相应的软件包管理器进行安装。 可以参考由 Node.js 提供的 指导。
对于 Mac 和 Linux 同样建议使用 nvs 或者 nvm，以避免可能会出现的权限问题。
注意： 使用 Node.js 官方安装程序时，请确保勾选 Add to PATH 选项（默认已勾选）
注意： 如果在尝试安装 Hexo 的过程中出现 EACCES 权限错误，请遵循 由 npmjs 发布的指导 修复该问题。
注意： 如果您使用 Snap 来安装 Node.js，在 初始化 博客时您可能需要手动在目标文件夹中执行 npm install。
安装 Hexo
所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。
1 | $ npm install -g hexo-cli |
进阶安装和使用
对于熟悉 npm 的进阶用户，可以仅局部安装 hexo 包。
1 | $ npm install hexo |
安装以后，可以使用以下两种方式执行 Hexo：
npx hexo <command>- Linux 用户可以将 Hexo 所在的目录下的
node_modules添加到环境变量之中即可直接使用hexo <command>：
1 | echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile |
安装 Hexo 只需几分钟时间，若您在安装过程中遇到问题或无法找到解决方式，请 提交问题，我们会尽力解决您的问题。
Node.js 版本限制
如果你坚持使用旧的 Node.js，你可以考虑安装 Hexo 的过去版本。
请注意，我们不提供对过去版本 Hexo 的错误修复。
我们强烈建议永远安装 最新版本 的 Hexo，以及 推荐的 Node.js 版本。
| Hexo 版本 | 最低版本 (Node.js 版本) | 最高版本 (Node.js 版本) |
|---|---|---|
| 8.0+ | 20.19.0 | latest |
| 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 | 未知 |
| 3.0 - 3.1 | 0.10 或 iojs | 未知 |
| 0.0.1 - 2.8 | 0.10 | 未知 |