使用hexo搭建博客 - 计算机 - hexo教程 - 博客搭建

一、环境搭建

git下载与安装

下载git ，安装就直接下一步即可，注意环境变量。 验证是否安装正确

git -v

显示版本号就表示成功

node下载与安装

下载node,点get node.js,选择LTS（长期维护的版本）最新版，当前是V22.21.1 验证是否安装正确

node -v

显示版本号就表示成功

安装Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

 npm install -g hexo-cli

验证是否安装正确

hexo -v

显示版本号就表示成功

二、使用hexo创建项目

hexo官方文档doc

1.初始化(创建)项目有以下两个方式，推荐第二种

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

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

1.2（推荐）在资源管理器中创建一个文件夹，文件夹名就是项目名，注意此文件夹必须为空，运行如下命令

hexo init .

注意，结尾必须有一个” . “,英文的点,表示在当前目录下创建项目。 初始化后，将克隆github的hexo项目文件到你的目录下，大约需要几秒到几十秒，注意网络环境确保能够访问github。

2.安装依赖，就是项目根目录下的package.json里的dependencies里的内容

npm install

3.写文章（博客），可以在source/_posts目录下手动创建”.md”的文件（推荐），也可以通过命令创建

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

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

hexo new index

这个命令会在source/_posts目录下创建一个index.md的文件。

4. 安装主题(以 butterfly 为例)

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

如果https的方式不行，就试试ssh的方式

git clone -b master git@github.com:jerryc127/hexo-theme-butterfly.git themes/butterfly

必须立刻解除绑定，否则会与工作流产生冲突，执行如下命令(已废除)如果未删除.git和.github文件夹就运行了，那就不许删除缓存了

~~ git rm -r --cached themes/butterfly~~

改为如下代码，作用是删除butterfly目录下的.git文件夹（注意这个是隐藏的）和.github文件夹，也可以不用代码，手动在资源管理器中删除。这样可以避免后续的workflows工作流自动部署的冲突。

rm -rf themes/butterfly/.git themes/butterfly/.github

5.以上命令会把仓库butterfly克隆到thems目录下的butterfly子目录中 并删除主题里的.git与.github文件夹。

5.1修改 Hexo 根目錄下的 _config.yml，把主題改為 butterfly

theme: butterfly

5.2安装这个主题所需要的依赖

npm install hexo-renderer-pug hexo-renderer-stylus

5.3修改项目的而不是主题的根目录下_config.yml文件

1,cloudflare可以正常显示页面，github page不能正常显示的配置如下 url: https://gitychzh.github.io/hskt6 root: / 2，github pages可以正常展示页面，cloudflare不能正常展示如下 url: https://gitychzh.github.io root: /hskt6 / 3，hskt6换成你自己的项目名，暂时没有更好的办法解决这个问题，可以考虑建两个仓库，分别部署。

升级建议

在 hexo 的根目錄創建一個文件 _config.butterfly.yml，並把主題目錄的 _config.yml 內容複製到 _config.butterfly.yml 去。注意，这个_config.butterfly.yml优先级比根目录下的_config.yml高，所以不用担心冲突。

6.项目本地编译与预览

hexo clean && hexo g && hexo s

以上命令，会清除缓存，并编译静态资源到public文件夹下，并生成一个http://localhost:4000的网页供本地预览

创建远程仓库并push上传到远端仓库

github 注册 登录 ，创建仓库，点New repository ,输入仓库名，其他留空，以为hskt为例

然后在本地执行如下命令(项目里执行)

git init
git add .
git commit -m "first commit"
git branch -M master
git remote add origin git@github.com:gitychzh/hskt.git
git push -u origin master

也可以强制推送 git push -u origin master —force 第一次，以后就只需要git push即可 或者后面加—force

git 克隆仓库的时候，记得在末尾 加 点 . 表示在当前目录下下载资源。