返回

Vue项目极速部署到Github Page,小小白也能轻松搞定!

前端

在 GitHub Pages 上部署你的 Vue 项目:分步指南

什么是 GitHub Pages?

GitHub Pages 是一个由 GitHub 提供的免费静态网站托管平台,非常适合托管你的 Vue 项目。它提供了简单的部署流程、强大的版本控制功能和免费的自定义域选项。

部署 Vue 项目到 GitHub Pages

部署你的 Vue 项目到 GitHub Pages 涉及以下步骤:

1. 项目初始化

使用 Vue CLI 创建一个新的 Vue 项目或打开一个现有的项目。

2. 准备部署

在你的 package.json 文件中添加以下代码:

{
  "scripts": {
    "deploy": "vue-cli-service build --target gh-pages"
  }
}

这将创建用于部署项目的脚本。

3. 登录 GitHub

创建或登录你的 GitHub 帐户,并创建一个新的存储库,将其命名为与你的项目名称相同。

4. 部署项目

从你的项目目录中,运行以下命令:

npm run deploy

你的项目将构建为静态文件并部署到 GitHub Pages。

5. 访问项目

你的项目 URL 为 https://<你的用户名>.github.io/<你的项目名称>。在浏览器中输入此 URL 以查看已部署的项目。

自动化部署

为了在每次提交代码后自动部署你的项目,可以使用 GitHub Actions。

1. 创建一个 GitHub 工作流

在你的项目中,创建一个 .github/workflows 目录并添加一个名为 main.yml 的文件。

2. 添加工作流配置

将以下配置添加到 main.yml 文件中:

name: Deploy Vue Project

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v2

      - name: Install dependencies
        run: npm install

      - name: Build project
        run: npm run build --target gh-pages

      - name: Deploy to GitHub Pages
        uses: JamesIves/github-pages-deploy-action@4.1.5
        with:
          branch: gh-pages
          folder: dist

3. 保存并提交更改

保存 main.yml 文件并提交你的更改。

4. 触发部署

下次提交代码时,GitHub Actions 将自动触发部署工作流程。

常见问题解答

  • 我的项目无法部署,该怎么办?

检查你的 package.json 文件中的部署脚本是否正确,并确保你在 GitHub 上创建了一个仓库。

  • 我如何更新已部署的项目?

每次提交代码后,部署工作流程将自动更新已部署的项目。

  • 我可以在 GitHub Pages 上使用自定义域吗?

是的,你可以在 GitHub Pages 上使用自定义域。有关说明,请参阅 GitHub 文档。

  • 我可以在 GitHub Pages 上部署动态 Vue 项目吗?

不可以,GitHub Pages 仅支持静态网站。对于动态应用程序,你需要使用其他托管服务。

  • 我如何将我的 GitHub Pages 项目与其他服务集成?

GitHub Pages 提供了与各种服务的集成,例如 Google Analytics、Plausible 和 Cloudflare。