我的 VuePress 博客部署之路_vuepress 部署-CSDN博客

本文详细记录了作者使用VuePress部署博客到GitHub Pages的过程，包括创建GitHub Actions工作流、设置部署分支等步骤，并探讨了部署至Gitee Pages的方案。此外，文章还提到了国内静态网页托管服务，如腾讯云Webify和阿里云Codeup，以及自定义域名的备案要求。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

概述

在尝试使用 Hexo、VuePress 构建博客后，我最终选定了更为熟悉的 VuePress （Vue 语法）构建我的第一个博客
在使用 VuePress Theme Hope 主题完成自定义的博客开发后，我迫不及待地开始部署博客，秉着提高访问速度的原则，我开始寻找部署到除 GitHub Pages 外的方法，可这一路似乎没有我想象中那么顺利

部署至 GitHub Pages

基本步骤

如果你是通过 vuepress-theme-hope 主题创建的 VuePress 项目，那么部署博客至 GitHub Pages 将会非常容易：

1. 确保在创建项目时勾选了创建自动部署文档的 GitHub 工作流

没勾选也没关系，该步骤只是在项目根目录下创建一个用于 GitHub Actions 的工作流 .yml 文件： .github/workflow/deploy-docs.yml ，你完全可以手动创建这个目录，只要确保是在项目根目录下开始创建即可

以下是项目默认的 deploy-docs.yml 文件内容：

name: 部署文档

on:
  push:
    branches:
      # 确保这是你正在使用的分支名称
      - main

jobs:
  deploy-gh-pages:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          fetch-depth: 0
          # 如果你文档需要 Git 子模块，取消注释下一行
          # submodules: true

      - name: 设置 Node.js
        uses: actions/setup-node@v3
        with:
          node-version: 18
          cache: npm

      - name: 安装依赖
        run: npm ci

      - name: 构建文档
        env