Hello World

2025年03月01日 1.4k 字大概 6 分钟

欢迎来到 Hexo! 这是你的第一篇帖子。更多信息请查看文档。如果你在使用 Hexo 时遇到任何问题，可以在故障排除中找到答案，或者在 GitHub上问我。

快速开始

创建新帖子

1	`$ hexo new "My New Post"`

More info: Writing

运行服务

1	`$ hexo server`

More info: Server

生成静态文件

1	`$ hexo generate`

More info: Generating

部署到远程站点

1	`$ hexo deploy`

More info: Deployment

什么是 Hexo？

Hexo 是一个快速、简洁且高效的博客框架。 Hexo 使用 Markdown（或其他标记语言）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

安装

要求

Node.js (v10.13 及以上版本)
Git

安装 Git

略

安装 Node.js

略

NPM换源

1	`npm set registry https://registry.npm.taobao.org/`

安装 Hexo

1	`$ npm install -g hexo-cli`

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3

$ hexo init <folder>
cd <folder>
$ npm install

在<folder>目录下将会产生如下文件

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

_config.yml 是一个配置文件，用来设置 Hexo 的基本参数。

package.json 是一个 Node.js 项目配置文件，用来管理 Hexo 及其插件的依赖。

scaffolds 目录存放着新建文章的模板文件。

source 目录存放着文章的 Markdown 文件。是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。 Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes 目录存放着主题文件。

配置

您可以在 _config.yml文件中修改大部分的配置。
参考配置文档。

指令

init

1	`$ hexo init [folder]`

新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。
先）。 npm 默认随 Node.js 安装。

new

1	`$ hexo new [layout] <title>`

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

选项	描述
-p, –path	文章的路径。自定义文章的路径。
-r, –replace	如果存在的话，替换当前的文章。
-s, –slug	文章别名。自定义文章的 URL。

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

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

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

注意！ 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	`$ hexo generate`

生成静态文件。

选项	描述
-d, –deploy	在生成完成后部署。
-w, –watch	监视文件变动
-b, –bail	生成过程中如果发生任何未处理的异常则抛出异常
-f, –force	强制重新生成
-c, –concurrency	要同时生成的文件的最大数量。默认无限制

publish

1	`$ hexo publish [layout] <filename>`

发表草稿。

server

1	`$ hexo server`

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

选项	描述
-p, –port	重设端口
-s, –static	只使用静态文件
-l, –log	启用日志。 Override logger format.

deploy

1	`$ hexo deploy`

部署你的网站。

选项	描述
-g, –generate	在部署前生成

render

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

渲染文件。

选项	描述
-o, –output	输出目标地址

migrate

1	`$ hexo migrate <type>`

从其他博客系统迁移内容。

clean

1	`$ hexo clean`

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

list

1	`$ hexo list <type>`

列出所有路由。

version

1	`$ hexo version`

显示版本信息。

config

1	`$ hexo config [key] [value]`

列出网站的配置（_config.yml）。如果指定了 key，则只展示配置中对应 key 的值；如果同时指定了 key 和 value，则将配置中对应的 key 的值修改为 value。

选项

安全模式

1	`$ hexo --safe`

在安全模式下，不会加载插件和脚本。当您在安装新插件遭遇问题时，可以尝试以安全模式重新执行。

调试模式

1	`$ hexo --debug`

在终端中显示调试信息并记录到 debug.log。当您使用 Hexo 时遇到问题，可以尝试用调试模式重新执行一次。如果您发现错误，请在 GitHub 上提出 issue。

简洁模式

1	`$ hexo --silent`

静默输出到终端.

自定义配置文件的路径

1	`$ hexo --config custom.yml`

自定义配置文件的路径，指定这个参数后将不再使用默认的 _config.yml。还接受一个以逗号分隔的 JSON 或 YAML 配置文件列表（无空格），该列表将把这些文件合并为一个 _multiconfig.yml 文件。

1	`$ hexo --config custom.yml,custom2.json`

显示草稿

1	`$ hexo --draft`

显示 source/_drafts 文件夹中的草稿文章。

自定义 CWD

1	`$ hexo --cwd /path/to/cwd`

自定义当前工作目录（Current working directory）的路径。