GitHub Pages 入门指南(面向初学者)| 教程

GitHub for Beginners · 系列第 5 期

GitHub Pages 入门指南

免费托管你的静态网站,三步上线,无需服务器

作者:Kedasha Kerr  ·  2026-04-13  ·  阅读约 5 分钟

欢迎回到 GitHub for Beginners 系列!本期我们聚焦 GitHub Pages——GitHub 官方提供的免费静态网站托管服务。只需要一个 GitHub 仓库,就能让你的项目、作品集或博客秒变可公开访问的网站。

开始之前,你只需要:

  • 一个 GitHub 账户
  • 一个已有代码的 GitHub 仓库
  • 大约 5 分钟的操作时间

视频教程

跟着视频一步步操作,5 分钟搞定 GitHub Pages 部署

两种部署方式

GitHub Pages 提供两种部署路径,根据你的项目类型选择最合适的方式:

🌿

从分支部署

适合纯 HTML/CSS/JS 的静态项目,直接推送代码即自动更新

⚙️

GitHub Actions 部署

适合 Next.js、React、Vue 等需要构建步骤的现代框架项目

方法一:从分支部署

适合纯静态项目(HTML + CSS + JS),操作最简单,推荐新手优先尝试。

1

进入仓库设置

打开你的 GitHub 仓库,点击顶部导航栏中的 Settings 选项卡

2

找到 Pages 设置

在左侧菜单找到并点击 Pages(位于 "Code and automation" 部分)

3

选择部署来源

在 "Build and deployment" 区域,下拉框选择 Deploy from a branch

4

选择分支

在 "Branch" 下拉框选择 main 分支

5

保存

点击 Save 按钮,GitHub 会自动发布你的网站!

✅ 完成! 网站将从 main 分支发布并对全网公开可访问。

方法二:使用 GitHub Actions 部署

适合 Next.js、React、Vue 等需要构建步骤的框架,通过自动化工作流完成构建 + 部署。

1

切换部署来源

在 Settings → Pages 页面,"Source" 下拉框选择 GitHub Actions

2

浏览工作流模板

GitHub 会推荐常用工作流,点击 browse all workflows 查看全部,搜索框输入你的框架名(如 next.js

3

配置工作流

点击目标工作流卡片中的 Configure,查看自动生成的 YAML 配置文件(含权限和构建命令)

4

提交配置

确认配置无误后,点击右上角绿色 Commit changes,填写提交信息,选择 main 分支,再次点击 Commit changes

5

查看部署状态

点击仓库顶部 Actions 选项卡,找到名为 "Add GitHub Actions workflow for Next.js deployment" 的操作,等待完成

6

访问你的网站

在 deploy 阶段点击生成的链接,即可看到线上网站 🎉

⚠️ 注意:即使你的仓库设为 私有(Private),通过 GitHub Pages 发布的网站依然是公开的,任何人都可以访问。请勿将敏感信息放入发布目录。

添加自定义域名(免费!)

默认情况下,你的网站 URL 格式为:

https://YOUR-USERNAME.github.io/REPOSITORY-NAME

如果你有自己的域名,可以将其绑定到 GitHub Pages,步骤如下:

1

在你的域名注册商处配置 DNS 记录(A 记录或 CNAME)

2

进入 Settings → Pages,在 "Custom domain" 输入框中填入你的域名,点击 Save

3

等待 GitHub 自动检查 DNS 配置,配置正确后会出现绿色对勾

4

勾选 Enforce HTTPS,GitHub 会自动颁发免费 SSL 证书,浏览器显示安全锁

学完你就掌握了

从分支一键发布静态网站
GitHub Actions 自动化部署框架项目
绑定自定义域名(免费 SSL)
将私有仓库公开展示为作品集
Kedasha Kerr

Kedasha Kerr

GitHub 开发者布道师,热衷分享软件开发经验,帮助开发者了解技术社区。

GitHub @ladykerrX @itsthatladydev

原文来源:GitHub Blog · 中文整理编译

评论

此博客中的热门博文

最新版本BPB部署基础教程|百分百成功|利用 Cloudflare & BPB Panel |告别1101报错、节点泄露!

免费白嫖 1 年的 Gemini Advanced 高级套餐!+ 免费获取美国Edu教育邮箱

Cloudflare的WARP+ 再次复活,MAQSUE新协议无限流量,防失联必备!