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),仅供参考