☰
GitHub Pages:3 步搭好你的第一个静态站点
2026/10/20 1:13:19 网站建设 项目流程

GitHub Pages:3 步搭好你的第一个静态站点

【免费下载链接】github-pagesCreate a site or blog from your GitHub repositories with GitHub Pages.项目地址: https://gitcode.com/GitHub_Trending/gi/github-pages

直面建站卡点

想让博客有个在线地址,又怕买服务器贵、部署流程烦——GitHub Pages 是 GitHub 的静态网站托管服务,把文件推进仓库就能部署出免费站点。

看看它能做什么

GitHub Pages 把仓库里的静态文件直接发布成网站,不需要你自备服务器。它主要帮你解决三件事:

  • 免费托管:无需额外付费,把文件推送到仓库后,站点会自动部署并上线。
  • 自带 HTTPS 域名:每个站点默认获得 username.github.io 地址,全程加密访问,不用自己申请证书或购买域名。
  • Jekyll 原生集成:Markdown 文件会被编译成静态页面,写博客只需提交 .md 文件。

接下来按这个顺序走:先跑通最小路径把站点上线,再按需绑定自有域名、配置自动化部署。

跑通最小路径

下面四步跑通从仓库到在线站点的完整链路。

创建仓库并命名

这一步的目的:用仓库名直接决定站点地址。登录 GitHub,新建一个公开仓库,命名为username.github.io(username 换成你的 GitHub 用户名),描述可留空。仓库名必须与用户名完全一致,站点地址才会指向你的账号。

推送首个静态页面

在本地目录写一个最小的 index.html,再推送到仓库:

<!DOCTYPE html> <html> <head> <title>我的 GitHub Pages 站点</title> </head> <body> <h1>欢迎访问</h1> </body> </html>
git init git add index.html git commit -m "first commit" git remote add origin <你的仓库地址> git push -u origin main

推送完成后,刷新仓库的 Files 页能看到 index.html,本地内容已与远程一致。

开启 Pages 部署

这一步告诉 GitHub 从哪个分支发布站点。进入仓库 Settings,打开 Pages 面板,在 Build and deployment 区域选择 main 分支和根目录,保存。几分钟后访问 https://username.github.io,浏览器出现“欢迎访问”标题,说明静态网站托管已跑通。

用 Jekyll 发布第一篇博客

Jekyll 是 GitHub Pages 内置的静态网站生成器,站点标题和描述写在_config.yml:

title: 我的技术博客 description: 分享编程经验

再在_posts/目录新建hello.md写正文,同样用 git push 提交。刷新站点首页,博客列表里出现文章标题即成功。

解锁两个深度玩法

站点跑通后,下面两个方向最能提升体验。

需要绑定自有域名时

如果你不想用默认地址,这就是 GitHub Pages 自定义域名配置的标准做法:在 Settings → Pages 填入域名,再到域名服务商添加 CNAME 记录指向你的站点。仓库根目录放一个 CNAME 文件,内容一行即可:blog.example.com。解析生效后,域名自动启用 HTTPS。

需要自动构建与发布时

如果你的站点有构建步骤(比如用 Node 工具生成页面),可以用 GitHub Actions 实现 GitHub Pages 自动化部署:在.github/workflows/目录放一个 workflow 文件,每次 push 自动构建并发布产物。关键一行配置:permissions: pages: write。

回答高频疑问

Q:只能做静态页面吗?A:站点本身只包含 HTML、CSS 和 JavaScript。需要动态功能时,可以调用第三方 API。

Q:内容写错了怎么回滚?A:全部内容都在 Git 仓库中,用 git 命令可以回退到任意历史版本。

Q:有流量限制吗?A:个人项目和小型商业场景足够用。高流量站点建议改用专业托管。

现在去建一个名为 username.github.io 的仓库,10 分钟后你会有一条可访问的链接。

【免费下载链接】github-pagesCreate a site or blog from your GitHub repositories with GitHub Pages.项目地址: https://gitcode.com/GitHub_Trending/gi/github-pages

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询