如何开启 GitHub Pages,在线预览你的项目
什么是 GitHub Pages
GitHub Pages 是 GitHub 提供的一项免费静态网站托管服务。你可以将项目中的 HTML、CSS、JavaScript 文件直接托管在 GitHub 上,生成一个可访问的网站。每个 GitHub 账号可以创建一个用户站点,每个项目也可以创建项目站点。
部署要求
部署 GitHub Pages 非常简单,只需要确保你的仓库中有以下文件:
index.html:网站的主入口文件,访问时会自动加载此文件(也可以使用index.md直接用 Markdown 编写)- 其他资源文件如 CSS、JS、图片等可放在同级目录或子文件夹中
GitHub 会自动处理网站的构建和发布,你只需推送代码,无需额外配置服务器。
开始部署
演示用仓库结构如下:
项目根目录/
├── static/
├── LICENSE
├── README.md
└── index.html
进入你的 GitHub 仓库,按照以下步骤开启 GitHub Pages:
- 点击仓库顶部的 Settings(设置)选项卡
- 滚动到 Pages 页面配置区域
- 在 Branch 下,选择你要部署的分支(通常选择
main或者master分支) - 点击 Save 保存设置
等待片刻后,你的网站就会上线。
访问你的网站
部署成功后,你可以通过以下网址访问你的 GitHub Pages 网站:
网站地址格式为:
- 用户站点:
https://用户名.github.io - 项目站点:
https://用户名.github.io/仓库名
现在你可以将项目文件推送到 GitHub,访问你的静态网站了!
效果如下:


