GitHub Pages 部署指南

交互式演示根目录与/docs文件夹的区别

选择您的部署方式

点击下面的选项查看不同部署方式的效果和文件结构

文件结构预览

GitHub Pages 设置

网站访问地址

https://yourusername.github.io/ repository-name

使用场景建议

使用根目录的情况

  • 纯静态网站项目
  • 用户/组织站点 (username.github.io)
  • 简单项目演示
  • Jekyll博客

使用/docs文件夹的情况

  • 代码库的文档网站
  • 静态站点生成器输出
  • 项目演示与代码分离
  • 大型项目

部署步骤

1

创建GitHub仓库

登录GitHub,创建新的仓库

2

上传网站文件

将网站文件上传到仓库根目录

3

启用GitHub Pages

在仓库设置中选择部署来源

4

访问网站

等待部署完成,访问您的网站