npm 包 hexo-basedir-deployer-git 使用教程

如果你正在使用 Hexo 搭建自己的博客，并希望将博客部署到 GitHub Pages 上，那么 hexo-basedir-deployer-git 可能是一个不错的选择。本文将介绍如何使用这个 npm 包来部署博客，并注意一些可能出现的问题。

安装 hexo-basedir-deployer-git

使用 npm 安装 hexo-basedir-deployer-git 是非常简单的。在你的博客目录下，运行以下命令即可：

npm install hexo-basedir-deployer-git --save

由于 Hexo 的 deployer 是通过执行 hexo deploy 命令来触发的，因此需要在 Hexo 配置文件中启用 deployer。找到博客目录下的 _config.yml 文件，并添加以下配置：

deploy:
  type: basedir-git
  repo: <repository_url>
  branch: <branch>
  basedir: <basedir>

其中：

• type 指定部署类型为 basedir-git。
• repo 指定 GitHub 仓库的 URL，如 git@github.com:yourname/yourname.github.io.git。
• branch 指定要部署到的分支，通常是 master。
• basedir 是可选的，表示要部署到这个目录下。如果不设置，则部署到根目录下。

使用 hexo-basedir-deployer-git

完成上述配置后，即可使用 hexo deploy 进行博客部署。在命令行中运行以下命令即可：

hexo deploy

这会将博客按照 _config.yml 中的设置，部署到相应的 GitHub Pages 仓库中。

请注意，在执行 hexo deploy 命令之前，确保你已经将需要部署的文件全部提交到了 Git 仓库中。如果还有未提交的 Git 变更，执行 hexo deploy 可能会失败。

遇到的问题

在使用 hexo-basedir-deployer-git 进行博客部署过程中，可能会遇到一些问题。下面列举了几个可能的问题以及解决办法：

SSH agent 没有添加 GitHub 私钥

如果你使用的是 SSH 协议访问 GitHub 仓库，在执行 hexo deploy 命令时，可能会遇到类似下面的错误信息：

bash: Permission denied (publickey).
fatal: Could not read from remote repository.

这表示 SSH agent 没有添加 GitHub 私钥，因此无法访问你的 GitHub 仓库。

解决办法是在命令行中手动添加 GitHub 私钥：

eval "$(ssh-agent -s)"
ssh-add <path_to_your_private_key>

请将 <path_to_your_private_key> 替换为你的私钥文件路径。

无法提交到 GitHub 仓库

在执行 hexo deploy 命令时，可能会遇到提交失败的问题。这可能是由于你没有权限访问 GitHub 仓库所致。

可以尝试使用 HTTPS 协议来访问 GitHub 仓库，这会要求你输入 GitHub 的用户名和密码。在 _config.yml 中，将 repo 配置改为 GitHub 仓库的 HTTPS URL 即可：

deploy:
  type: basedir-git
  repo: https://github.com/yourname/yourname.github.io.git
  branch: master

总结

使用 hexo-basedir-deployer-git 部署博客是一件非常方便的事情。只需要使用 npm 安装该包，然后在 Hexo 配置文件中添加相应的设置即可。在使用过程中，注意 SSH agent 中是否添加了 GitHub 私钥，以及是否可以正常访问 GitHub 仓库。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600552cb81e8991b448d0320