前言
如果你是一个前端开发者，相信你一定不陌生于 GitHub Pages。GitHub Pages 是 GitHub 提供的一项服务，可以将用户的静态网页部署到 GitHub 的服务器上，并为其提供一个访问域名。
@mattdesl/ghpages 是一个 Node.js 的 npm 包，它使得我们可以非常方便地将网站部署到 GitHub Pages 上。这个包的作者是 Matt DesLauriers，他在 GitHub 上分享了这个包的源码，供我们自由使用。
本篇文章将详细介绍如何使用 @mattdesl/ghpages，希望能给你带来帮助。
安装
使用 npm 安装 @mattdesl/ghpages：
npm install -g @mattdesl/ghpages
使用
部署本地文件夹到 GitHub Pages
假设我们有一个静态网站，它的源码存放在本地的 dist 文件夹中，我们想将它部署到 GitHub Pages 上。使用 @mattdesl/ghpages 可以实现这个目的。
在终端中，进入 dist 文件夹：
cd dist
然后执行以下命令：
gh-pages -d .
这个命令会将当前文件夹下的所有文件都推送到 GitHub Pages 上，并将其访问链接显示在终端中。打开链接，可以看到我们的网站已经成功部署到了 GitHub Pages 上。
部署 Git 仓库中的文件夹到 GitHub Pages
有时候，我们的代码并不是存储在本地的文件夹中，而是存储在 GitHub 的一个 Git 仓库中。不用担心，@mattdesl/ghpages 也能够支持这种情况。
首先，我们需要从 GitHub 上克隆下这个 Git 仓库：
git clone https://github.com/user_name/repo_name.git
然后，在终端中进入该目录：
cd repo_name
使用以下命令就可以将 Git 仓库中的某个文件夹（假设为 src 文件夹）推送到 GitHub Pages 上：
gh-pages -d src
@mattdesl/ghpages 会自动为我们创建一个 gh-pages 分支，并将网站的静态文件都推送到该分支上。
自定义部署的目标分支
为了防止误操作，@mattdesl/ghpages 的默认行为是将静态文件推送到一个名为 gh-pages 的新分支上。但是，在实际使用中，我们可能需要将这些静态文件推送到自己指定的某个分支上。@mattdesl/ghpages 自然也支持这种操作。
使用以下命令可以将静态文件部署到指定的分支上（假设为 master）：
gh-pages -d . -b master
这个命令使用了 -b 参数来指定推送到的目标分支。这样，我们就可以将网站的静态文件推送到自己指定的分支上了。
注意事项
- 在推送到 GitHub Pages 之前，请确保你已经在 GitHub 上创建了仓库，并且该仓库是公开的。
- 在推送之前，请确保你已经登录了 GitHub，否则会抛出
login required错误。 - @mattdesl/ghpages 默认会将 gh-pages 分支作为推送的目标分支，所以请不要在该分支上放置其他文件。如果出现冲突，@mattdesl/ghpages 会抛出相应的错误信息。
总结
@mattdesl/ghpages 是一个非常方便的 npm 包，可以帮助我们轻松地将网站部署到 GitHub Pages 上。阅读本篇文章，相信你已经掌握了如何正确地安装和使用这个包。如果你对此有任何疑问或建议，欢迎在评论区留言。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066bcb967216659e2446fe